tencent cloud

Preparations

1. Download and decompress the demo package as described in Demos, and copy the xmagickit folder in the demo/XiaoShiPin/ directory in the demo project to the directory of the Podfile of your project.

2. Add the following dependencies to your Podfile and run pod install to import the component.

   pod 'xmagickit', :path => 'xmagickit/xmagickit.podspec'
   

3. Replace the Bundle ID with the one under the obtained trial license.

Developer environment requirements

• Xcode 11 or later: Download on App Store or here.
• Recommended runtime environment:
  • Device requirements: iPhone 5 or later. iPhone 6 and older models support up to 720p for front camera.
  • System requirements: iOS 12.0 or later.

SDK API Integration

Step 1. Initiate authentication

Add the following code to didFinishLaunchingWithOptions of AppDelegate (set LicenseURL and LicenseKey according to the authorization information you get from the Tencent Cloud website):

[TXUGCBase setLicenceURL:LicenseURL key:LicenseKey];
[TELicenseCheck setTELicense:LicenseURLkey:LicenseKey completion:^(NSInteger authresult, NSString * _Nonnull errorMsg) {
             if (authresult == TELicenseCheckOk) {
                  NSLog(@"Authentication successful");
              } else {
                  NSLog(@"Authentication failed");
              }
      }];

Authentication errorCode description:

Step 2. Set the path of SDK materials

CGSize previewSize = [self getPreviewSizeByResolution:self.currentPreviewResolution];
NSString *beautyConfigPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
beautyConfigPath = [beautyConfigPath stringByAppendingPathComponent:@"beauty_config.json"];
NSFileManager *localFileManager=[[NSFileManager alloc] init];
BOOL isDir = YES;
NSDictionary * beautyConfigJson = @{};
if ([localFileManager fileExistsAtPath:beautyConfigPath isDirectory:&isDir] && !isDir) {
NSString *beautyConfigJsonStr = [NSString stringWithContentsOfFile:beautyConfigPath encoding:NSUTF8StringEncoding error:nil];
NSError *jsonError;
NSData *objectData = [beautyConfigJsonStr dataUsingEncoding:NSUTF8StringEncoding];
beautyConfigJson = [NSJSONSerialization JSONObjectWithData:objectData
                                    options:NSJSONReadingMutableContainers
                                    error:&jsonError];
}
NSDictionary *assetsDict = @{@"core_name":@"LightCore.bundle",
                    @"root_path":[[NSBundle mainBundle] bundlePath],
                    @"tnn_"
                    @"beauty_config":beautyConfigJson
};
// Init beauty kit
self.beautyKit = [[XMagic alloc] initWithRenderSize:previewSize assetsDict:assetsDict];

Step 3. Add the log and event listener

// Register log
[self.beautyKit registerSDKEventListener:self];
[self.beautyKit registerLoggerListener:self withDefaultLevel:YT_SDK_ERROR_LEVEL];

Step 4. Configure beauty filter effects

- (int)configPropertyWithType:(NSString *_Nonnull)propertyType withName:(NSString *_Nonnull)propertyName withData:(NSString*_Nonnull)propertyValue withExtraInfo:(id _Nullable)extraInfo;

Step 5. Render videos

In the preprocessing frame callback, construct YTProcessInput and pass textureId to the SDK for rendering.

[self.xMagicKit process:inputCPU withOrigin:YtLightImageOriginTopLeft withOrientation:YtLightCameraRotation0]

Step 6. Pause/Resume the SDK

[self.beautyKit onPause];
[self.beautyKit onResume];

Step 7. Add the SDK beauty filter panel to the layout

UIEdgeInsets gSafeInset;
#if __IPHONE_11_0 && __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_11_0
if(gSafeInset.bottom > 0){
}
if (@available(iOS 11.0, *)) {
gSafeInset = [UIApplication sharedApplication].keyWindow.safeAreaInsets;
} else
#endif
{
    gSafeInset = UIEdgeInsetsZero;
}
dispatch_async(dispatch_get_main_queue(), ^{
// Beauty filter option UI
_vBeauty = [[BeautyView alloc] init];
[self.view addSubview:_vBeauty];
[_vBeauty mas_makeConstraints:^(MASConstraintMaker *make) {
    make.width.mas_equalTo(self.view);
    make.centerX.mas_equalTo(self.view);
    make.height.mas_equalTo(254);
    if(gSafeInset.bottom > 0.0){  // Adapt to full-view screen
        make.bottom.mas_equalTo(self.view.mas_bottom).mas_offset(0);
    } else {
        make.bottom.mas_equalTo(self.view.mas_bottom).mas_offset(-10);
    }
}];
    _vBeauty.hidden = YES;
});