集成向导

基本介绍

• TuSDK 运行 demo 时，请使用 *包名 的调试证书。在项目中请使用控制台创建的自己的，包名（BundleID），秘钥（Appkey）和资源文件。

安装与更新

1、将示例工程源码中 Frameworks/TuSDK 和 Resources 文件夹内的文件拖入到 Xcode 项目中中。TuSDK 包含项目运行所需要的 framework 文件。 Resources 包含项目运行所需要的资源文件。

• TuSDK 文件夹：
• GPUImage.framework
• libyuv.framework
• TuSDK.framework
• TuSDKVideo.framework
• TuSDKFace.framework
• Resources 文件夹：
• TuSDK.strings 为项目语言文件。
• TuSDK.bundle 为项目资源文件，包含滤镜，动态贴纸等文件。

2、勾选 Copy items if needed，点击 Finish。

3、打开 app target，查看 Build Settings 中的 Linking - Other Linker Flags 选项，确保含有 -ObjC 一值，若没有则添加。用户使用 Cocoapods 进行了第三方依赖库管理，需要在 -ObjC 前添加 $(inherited)。目前直播 SDK 暂不支持 Cocoapods。

4、在项目的 app target 中，查看 Build Phases 中的 Linking - Link Binary With Libraries 选项中，手动添加 Photos.framework，并将 Photos.framework 的 Status 设置成 Optional。

5、在项目的 app target 中，查看 Build Phases 中的 Linking - Link Binary With Libraries 选项中，手动添加 Accelerate.framework。

6、在项目的 app target 中，查看 Build Phases 中的 Linking - Link Binary With Libraries 选项中，手动添加 libz.tbd和libbz2.tbd。

7、在项目的 app target 中，查看 Build Phases 中的 Linking - Link Binary With Libraries 选项中，手动添加 libz.1.2.5.tbd，libstdc++.tbd，libstdc++.6.tbd和libstdc++.6.0.9.tbd。

8、用户在 TuSDK 网站控制台内查看项目需要的滤镜，并将资源文件进行「打包」操作，然后在「资源打包」处下载。下载的资源文件中包含 others 和 textures，需要将这两个文件夹替换到 TuSDK.bundle 中对应位置。

9、用户可以在 TuSDKVideoDemo/Resources 文件中找到 TuSDK.bundle 文件。文件中包含 others ，textures 和ui_default 三个文件夹。用户需要替换 others/lsq_tusdk_configs.json 文件和 textures 整个文件夹。

10、SDK 暂时不支持 Cocoapods，进行更新操作，请重复步骤1和步骤7。

TuSDK 的初始化

1、在需要使用 TuSDK 的类的文件中引入头文件 #import "TuSDKFramework.h"。

2、在 AppDelegate.m 的 didFinishLaunchingWithOptions 方法中添加初始化代码，用户如果需求同一应用不同版本发布，可以参考文档如何使用多个masterkey

3、为便于开发，可打开 TuSDK 的调试日志，在初始化方法的同一位置添加以下代码：[TuSDK setLogLevel:lsqLogLevelDEBUG];发布应用时请关闭日志。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 初始化SDK (请前往 http://tusdk.com 获取您的 APP 开发密钥)
    [TuSDK initSdkWithAppKey:@"828d700d182dd469-04-ewdjn1"];
    // 多 masterkey 方式启动方法
    // @see-https://tusdk.com/docs/ios-faq/masterkey
    if ([[[NSBundle mainBundle] bundleIdentifier] isEqualToString:@"com.XXXXXXXX.XXXX"]) {
        [TuSDK initSdkWithAppKey:@"714f0a1265b39708-02-xie0p1" devType:@"release"];
    }
    // 开发时请打开调试日志输出
    [TuSDK setLogLevel:lsqLogLevelDEBUG];
}

4、添加位置权限，在 viewDidLoad 协议方法中添加以下代码，并在项目的 Info.plist 文件中加入获取位置信息字段。例如：

- (void)viewDidLoad {
    // 启动GPS
    // 不需要定位功能，可注释该代码,即不再申请定位权限
    [[TuSDKTKLocation shared] requireAuthorWithController:self];
}

5、info.plist 文件添加字段

// 定位权限
<key>NSLocationWhenInUseUsageDescription</key>
<string>YES</string>
// 相机权限
<key>NSCameraUsageDescription</key>
<string>YES</string>
// 麦克风权限
<key>NSMicrophoneUsageDescription</key>
<string>YES</string>

6、检查滤镜管理器的初始化，在使用滤镜前的某个界面的 viewDidLoad 协议方法中添加以下代码，即可检查滤镜管理器的初始化是否完成。

- (void)viewDidLoad {
    // 异步方式初始化滤镜管理器 
    // 需要等待滤镜管理器初始化完成，才能使用所有功能
    [TuSDK checkManagerWithDelegate:self];
}

#pragma mark - TuSDKFilterManagerDelegate
/**
 * 滤镜管理器初始化完成（代理方法）
 *
 * @param manager
 * 滤镜管理器
 */
- (void)onTuSDKFilterManagerInited:(TuSDKFilterManager *)manager;
{
    // 需要在接口出遵守代理 TuSDKFilterManagerDelegate
}