腾讯云实时音视频 SDK 集成指引（iOS）_音视频解决方案_同尘科技

集成准备

1. 下载并解压 Demo 包，将 Demo 工程中的 xmagic 模块（bundle，XmagicIconRes，Xmagic 文件夹）导入到实际项目工程中。2. 如果使用的 XMagic SDK 版本在2.5.0之前，导入 SDK 目录中的 libpag.framework、Masonry.framework、XMagic.framework、YTCommonXMagic.framework。如果使用的 XMagic SDK 版本在2.5.1及以后，导入 SDK 目录中的 libpag.framework、 Masonry.framework、XMagic.framework、YTCommonXMagic.framework、Audio2Exp.framework、TEFFmpeg.framework。3. framework 签名 General–> Masonry.framework 和 libpag.framework 选 Embed & Sign。YTCommonXMagic.framework 在版本2.5.1之前选 Do Not Embed，在版本2.5.1及以后选 Embed & Sign。4. 将 Bundle ID 修改成与申请的测试授权一致。

开发者环境要求

开发工具 XCode 11 及以上：App Store 或单击 下载地址。建议运行环境：设备要求：iPhone 5 及以上；iPhone 6 及以下前置摄像头最多支持到 720p，不支持 1080p。系统要求：iOS 10.0 及以上。

C/C++层开发环境

XCode 默认 C++ 环境。

SDK 接口集成

步骤一 和 步骤二 可参考 Demo 工程中，ThirdBeautyViewController 类 viewDidLoad，buildBeautySDK 方法；AppDelegate类的application方法进行了Xmagic鉴权。步骤四 至 步骤七 可参考 Demo 工程的 ThirdBeautyViewController，BeautyView 类相关示例代码。

步骤一：初始化授权

1. 首先在工程 AppDelegate 的 didFinishLaunchingWithOptions 中添加如下鉴权代码，其中 LicenseURL 和 LicenseKey 为腾讯云官网申请到授权信息，请参见 License 指引：

[TXLiveBase setLicenceURL:LicenseURL key:LicenseKey];

2. Xmagic 鉴权：在相关业务模块的初始化代码中设置 URL 和 KEY，触发 License 下载，避免在使用前才临时去下载。也可以在 AppDelegate 的 didFinishLaunchingWithOptions 方法里触发下载。其中，LicenseURL 和 LicenseKey 是控制台绑定 License 时生成的授权信息。SDK版本在2.5.1以前，TELicenseCheck.h在XMagic.framework里面；SDK版本在2.5.1及以后，TELicenseCheck.h在 YTCommonXMagic.framework里面。

[TELicenseCheck setTELicense:LicenseURL key:LicenseKey completion:^(NSInteger authresult, NSString * _Nonnull errorMsg) {    if (authresult == TELicenseCheckOk) {         NSLog(@"鉴权成功");     } else {         NSLog(@"鉴权失败");     } }];

鉴权 errorCode 说明：

步骤二：设置 SDK 素材资源路径

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 kitself.beautyKit = [[XMagic alloc] initWithRenderSize:previewSize assetsDict:assetsDict];

步骤三：添加日志和事件监听

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

步骤四：配置美颜各种效果

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

步骤五：进行渲染处理

在视频帧回调接口，构造 YTProcessInput 传入到 SDK 内做渲染处理，可参考 Demo 中的 ThirdBeautyViewController。

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

步骤六：暂停/恢复 SDK

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

步骤七：布局中添加 SDK 美颜面板

UIEdgeInsets gSafeInset;#if __IPHONE_11_0 && __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_11_0if(gSafeInset.bottom > 0){}if (@available(iOS 11.0, *)) {    gSafeInset = [UIApplication sharedApplication].keyWindow.safeAreaInsets;} else#endif    {        gSafeInset = UIEdgeInsetsZero;    }
dispatch_async(dispatch_get_main_queue(), ^{    //美颜选项界面    _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){  // 适配全面屏            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;});



对音视频的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠

阿里云解决方案也看看？： 点击对比阿里云的解决方案