腾讯特效 SDK Mac-SDK 集成指引（无 UI）-文档中心-腾讯云

集成准备
开发者环境要求
开发工具 XCode 11 及以上：App Store 或单击 下载 Demo。
建议运行环境：
设备要求：macOS 系统设备。 
系统要求：macOS 10.15 及以上。
导入SDK
您可以先将 SDK 下载到本地，再将其手动导入到您当前的项目中。
下载SDK并手动导入
1. 下载并解压 SDK 和美颜资源，Libs 文件夹里面是sdk、resources文件夹里面是美颜的 bundle 资源。
2. 打开您的 Xcode 工程项目，把Libs文件夹里面的 Xmagic_Mac.framework、libLightSDKMac、libpag.framework 添加到实际工程中，选择要运行的 target , 选中 General 项，单击 Frameworks,Libraries,and Embedded Content 项展开，将 libLightSDKMac和libpag.framework 的 Embed 改成Embed&Sign。
﻿
﻿
3. 选择对应的 target，选中 Build Settings，找到 Other Linker Flags 添加“-lstdc++”。
4. 在项目里找到xxx(项目名).entitlements文件，增加如下 key-value：
<key>com.apple.security.cs.allow-dyld-environment-variables</key>
 <true/>
5. 把 resources 夹里面的美颜资源添加到实际工程中。
6. 将 Bundle ID 修改成与申请的测试授权一致。
动态下载集成
为了减少包大小，您可以将 SDK 所需的模型资源和动效资源 MotionRes（部分基础版 SDK 无动效资源）改为联网下载。在下载成功后，将上述文件的路径设置给 SDK。
动态下载的详细指引，请参见 SDK 包体瘦身（iOS）。
配置权限
在 Info.plist 文件中添加相应权限的说明，否则程序在 iOS 10 系统上会出现崩溃。请在 Privacy - Camera Usage Description 中开启相机权限，允许 App 使用相机。Privacy - Microphone Usage Description 开启麦克风权限，允许使用麦克风。在 target-->signing & Capabilities--> Hardened Runtime 勾选 Audio Input、Camera。
集成步骤
步骤一：鉴权
1. 申请授权，得到 LicenseURL 和 LicenseKEY，请参见 License 指引。
注意
 正常情况下，只要 App 成功联网一次，就能完成鉴权流程，因此您不需要把 License 文件放到工程的工程目录里。但是如果您的 App 在从未联网的情况下也需要使用 SDK 相关功能，那么您可以把 License 文件下载下来放到工程目录，作为保底方案，此时 License 文件名必须是 v_cube.license。
2. 在相关业务模块的初始化代码中设置 URL 和 KEY，触发 License 下载，避免在使用前才临时去下载。也可以在 AppDelegate 的 didFinishLaunchingWithOptions 方法里触发下载。其中，LicenseURL 和 LicenseKey 是控制台绑定 License 时生成的授权信息。
[TELicenseCheck setTELicense:LicenseURL key:LicenseKey completion:^(NSInteger authresult, NSString * _Nonnull errorMsg) {
 if (authresult == TELicenseCheckOk) {
     NSLog(@"鉴权成功");
 } else {
     NSLog(@"鉴权失败");
 }
}];
鉴权 errorCode 说明：
错误码
说明
0
成功。Success
-1
输入参数无效，例如 URL 或 KEY 为空
-3
下载环节失败，请检查网络设置
-4
从本地读取的 TE 授权信息为空，可能是 IO 失败引起
-5
读取 VCUBE TEMP License 文件内容为空，可能是 IO 失败引起
-6
v_cube.license 文件 JSON 字段不对。请联系腾讯云团队处理
-7
签名校验失败。请联系腾讯云团队处理
-8
解密失败。请联系腾讯云团队处理
-9
TELicense 字段里的 JSON 字段不对。请联系腾讯云团队处理
-10
从网络解析的TE授权信息为空。请联系腾讯云团队处理
-11
把 TE 授权信息写到本地文件时失败，可能是IO失败引起
-12
下载失败，解析本地 asset 也失败
-13
鉴权失败
其他
请联系腾讯云团队处理
步骤二：加载 SDK（XMagic.framework）
使用腾讯特效 SDK 生命周期大致如下：
1. 加载美颜相关资源。
NSDictionary *assetsDict = @{@"core_name":@"LightCore.bundle",
 @"root_path":[[NSBundle mainBundle] bundlePath]
};
2. 初始化腾讯特效 SDK。
initWithRenderSize:assetsDict: (XMagic)
self.beautyKit = [[XMagic alloc] initWithRenderSize:previewSize assetsDict:assetsDict];
3. 腾讯特效 SDK 处理每帧数据并返回相应处理结果。
process: (XMagic)
// demo层
// 在摄像头回调传入帧数据
- (void)captureOutput:(AVCaptureOutput *)captureOutput didOutputSampleBuffer:(CMSampleBufferRef)sampleBuffer fromConnection:(AVCaptureConnection *)connection;
﻿
// 获取原始数据，处理每帧的渲染信息
- (void)mycaptureOutput:(AVCaptureOutput *)captureOutput didOutputSampleBuffer:(CMSampleBufferRef)inputSampleBuffer fromConnection:(AVCaptureConnection *)connection originImageProcess:(BOOL)originImageProcess;
﻿
// 使用CPU处理数据
- (YTProcessOutput*)processDataWithCpuFuc:(CMSampleBufferRef)inputSampleBuffer;
﻿
// 使用GPU处理数据
- (YTProcessOutput*)processDataWithGpuFuc:(CMSampleBufferRef)inputSampleBuffer;
﻿
// sdk接口调用
// 腾讯特效 SDK处理数据接口
/// @param input 输入处理数据信息
/// @return 输出处理后的数据信息
- (YTProcessOutput* _Nonnull)process:(YTProcessInput * _Nonnull)input;
4. 给 SDK 设置特效。
/// 四端统一新接口
/// @brief 配置美颜各种效果（使用方法可参考文档和demo）     Configure various effects of beauty（refer to the documentation and demo for usage instructions.）
/// @param effectName 效果类型 字符串： lut, motion......     property type String:  lut, motion......
/// @param effectValue 效果数值     property value
/// @param resourcePath 素材路径 resource path
/// @param extraInfo 预留扩展, 附加额外配置dict     reserved extension, additional configuration dict
- (void)setEffect:(NSString * _Nullable)effectName
      effectValue:(int)effectValue
     resourcePath:(NSString * _Nullable)resourcePath
        extraInfo:(NSDictionary * _Nullable)extraInfo;
﻿
/// @brief 配置美颜各种效果，旧接口，建议使用上方新接口
/// @param propertyType 效果类型 字符串：beauty, lut, motion
/// @param propertyName 效果名称
/// @param propertyValue 效果数值
/// @param extraInfo 预留扩展, 附加额外配置dict
/// @return 成功返回0，失败返回其他
/// @note 具体说明
/**
| 效果类型 | 效果名称 | 效果值 | 说明  | 备注 |
| :---- | :---- |:---- | :---- | :---- |
|  beauty  | 美颜id名称 | 美颜效果强度数值 |美颜类型配置接口 | 无 |
|  lut  | 滤镜路径+滤镜名称 | 滤镜强度数值 | 滤镜类型配置接口 | 无 |
|  motion  | 动效路径名称 | 动效路径 | 动效类型配置接口| **注意**：如果资源中有zip，请确保传入动效路径为可写路径，否则跟app包走需要手动unzip才可以使用 |
**/
- (int)configPropertyWithType:(NSString *_Nonnull)propertyType withName:(NSString *_Nonnull)propertyName withData:(NSString*_Nonnull)propertyValue withExtraInfo:(id _Nullable)extraInfo;
参数的设置和说明，请参见 参数设置说明。
5. 释放腾讯特效 SDK。
deinit (XMagic)
// 在需要释放SDK资源的地方调用
[self.beautyKit deinit]

错误码	说明
0	成功。Success
-1	输入参数无效，例如 URL 或 KEY 为空
-3	下载环节失败，请检查网络设置
-4	从本地读取的 TE 授权信息为空，可能是 IO 失败引起
-5	读取 VCUBE TEMP License 文件内容为空，可能是 IO 失败引起
-6	v_cube.license 文件 JSON 字段不对。请联系腾讯云团队处理
-7	签名校验失败。请联系腾讯云团队处理
-8	解密失败。请联系腾讯云团队处理
-9	TELicense 字段里的 JSON 字段不对。请联系腾讯云团队处理
-10	从网络解析的TE授权信息为空。请联系腾讯云团队处理
-11	把 TE 授权信息写到本地文件时失败，可能是IO失败引起
-12	下载失败，解析本地 asset 也失败
-13	鉴权失败
其他	请联系腾讯云团队处理

Mac

本页目录：

集成准备

开发者环境要求

导入SDK

下载SDK并手动导入

动态下载集成

配置权限

集成步骤

步骤一：鉴权

步骤二：加载 SDK（XMagic.framework）