集成向导

基本介绍

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
}