tencent cloud

iOS
Download PDF
Last updated: 2025-09-29 16:43:09
iOS
Last updated: 2025-09-29 16:43:09
Download PDF

SDK Integration

1. This documentation explains integrating and using the TEBeautyKit library in the Mobile Live Video BroadcastingStreaming (MLVB) SDK project.
2. Refer to demo.

Utilization of SDK

Step 1: Integrate TEBeautyKit

1. Download and extract TEBeautyKit.
2. Download and extract TELiveAdapter.
3. Copy the TEBeautyKit folder into your project and make it the same level as the podfile directory.
4. Edit the podfile and add the following code:
  pod 'TEBeautyKit',:path => 'TEBeautyKit/TEBeautyKit.podspec'
5.Incorporate the `TELiveAdapter.framework` into your project.

6.Execute the command `pod install`.

Step 2: Authenticate

[TEBeautyKit setTELicense:@"your license" key:@"your key" completion:^(NSInteger authresult, NSString * _Nullable errorMsg) {
  NSLog(@"----------result: %zd  %@",authresult,errorMsg);
}];

Step 3: Configure the beauty material path

If the materials in the JSON file are local, you need to add the beauty materials to the project.
- (void)initBeautyJson{
    [[TEUIConfig shareInstance] setPanelLevel:S1_07];
}

Step 4: Initialize and add TEPanelView

-(TEPanelView *)tePanelView{
    if (!_tePanelView) {
        _tePanelView = [[TEPanelView alloc] init:nil comboType:nil];
        _tePanelView.delegate = self;
    }
    return _tePanelView;
}
[self.view addSubview:self.tePanelView];
[self.tePanelView mas_makeConstraints:^(MASConstraintMaker *make) {
    make.width.mas_equalTo(self.view);
    make.centerX.mas_equalTo(self.view);        
    make.height.mas_equalTo(250);
    make.bottom.mas_equalTo(self.view.mas_bottom);
}];

Step 5:Adapter Binding for Beautification

-(TEBeautyLiveAdapter *)liveAdapter{
    if (!_liveAdapter) {
        _liveAdapter = [[TEBeautyLiveAdapter alloc] init];
    }
    return _liveAdapter;
}
__weak __typeof(self)weakSelf = self;
[self.liveAdapter bind:self.livePusher onCreatedXmagicApi:^(XMagic * _Nullable xmagicApi) {
    __strong typeof(self) strongSelf = weakSelf;
    strongSelf.teBeautyKit.xmagicApi = xmagicApi;
    [strongSelf.teBeautyKit setLogLevel:YT_SDK_ERROR_LEVEL];
    strongSelf.tePanelView.teBeautyKit = strongSelf.teBeautyKit;
    [strongSelf.tePanelView setDefaultBeauty];
  } onDestroyXmagicApi:^{
     __strong typeof(self) strongSelf = weakSelf;
     [strongSelf.teBeautyKit onDestroy];
     strongSelf.teBeautyKit = nil;
}];


Step 6: Parameter Change Notification Adapter

//Notify the Adapter of the Front and Rear Cameras: Whether to Encode a Mirror Image
[self.liveAdapter notifyCameraChanged:self.isFrontCamera isEncoderMirror:self.isEncoderMirror];
//Notify the Adapter of Screen Orientation Changes
[self.liveAdapter setDeviceOrientation:orientation];

Step 7: Unbinding the Adapter

 [self.liveAdapter unbind];
 self.liveAdapter=nil;
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback