TuSDK for iOS 集成向导

基本介绍

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

运行环境

注意

• TuSDK for iOS 2.6.0 之前版本支持 iOS 5.1.1 以上版本。

• 从 2.6.0 开始，我们将只支持 iOS 6.0 以上版本。

体积

• TuSDK 发布的 SDK 工程文件兼容了多种架构，这并不意味会增加用户的应用很大的体积。实际使用中，开发包编译后的 SDK 体积约占 1.9 MB，滤镜和贴纸的资源文件约占 4.3 MB。

• 本地的滤镜和贴纸资源可以让用户在没有网络的时候也能使用相关功能，用户可以选择将哪些资源包含在客户端内进行本地展示。详情请参考 自定义滤镜 和 自定义贴纸。

模拟器调试和真机调试

• TuSDK 中涉及到相机的操作，需要用户进行真机调试。
• TuSDK 中有大量涉及滤镜及相关功能的调用，例如照片美化组件中的美颜模块，调整模块等都是属于滤镜的操作，请用户尽量使用真机进行调试。
• Xcode 的模拟器由于本身性能问题，如果用户使用模拟器调试 SDK 相关的功能的时候，会比较消耗性能和资源，所以建议用户使用真机进行相关的调试和测试。

集成步骤

初始化应用密钥

• 登录「控制台」，进入「我的应用」中创建应用，在包名处填写需要集成的项目包名，完成后可得到该应用唯一密钥。

• 若您对包名和密钥有疑问，请参考「应用包名与密钥」。

• 在 AppDelegate.m 的 didFinishLaunchingWithOptions 方法中添加初始化代码：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 初始化SDK (请前往 http://tusdk.com 获取您的 APP 开发密钥)
    [TuSDK initSdkWithAppKey:@"828d700d182dd469-04-ewdjn1"];
}

调试日志

为便于开发，可打开 TuSDK 的调试日志，在初始化方法的同一位置添加以下代码：

[TuSDK setLogLevel:lsqLogLevelDEBUG];

发布应用时请关闭日志。

导入

在需要使用 TuSDK 的功能的文件中引入对应主题包的头文件。

• 默认主题包 #import <TuSDKGeeV1/TuSDKGeeV1.h>
• 社交类主题包 #import <TuSDKGeeV2/TuSDKGeeV2.h>

添加权限

在项目的 Info.plist 文件中加入「Privacy」权限的配置信息的字段。

• 添加设备使用「相机」的权限

    <key>NSCameraUsageDescription</key>
    <string>Photo capturing requires to use your camera</string>

• 添加设备使用「相册」的权限

    <key>NSPhotoLibraryUsageDescription</key>
    <string>Photo editing requires to use your Photo Library</string>

• 添加设备使用「定位」的权限

    <key>NSLocationWhenInUseUsageDescription</key>
    <string>Adding infomation to photos requires your location</string>

添加地理信息

在 viewDidLoad 协议方法中添加以下代码。

- (void)viewDidLoad {
    // 启动GPS，图片中会包含对应的地理位置的信息
    [[TuSDKTKLocation shared] requireAuthorWithController:self];
}

检查滤镜管理器的初始化

• 滤镜管理器需要不到一秒钟的时间初始化。在使用滤镜前的某个界面的 viewDidLoad 协议方法中添加以下代码，即可检查滤镜管理器的初始化是否完成。

• 如果需要开启应用马上执行 SDK 组件，需要进行检测，否则可以忽略检测。即如果不是开启应用后立即调用滤镜功能，可以不进行检测环节。

• 初始化相关的文字提示可自行去掉，不继承 showHubWithStatus 所在的 TuSDKICViewController 类，并且不调用此方法。

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

    // 用户可以通过打印字段的方式获取到正在使用的 SDK 的版本号

    NSLog(@"TuSDK.framework 的版本号 : %@",lsqSDKVersion);

    NSLog(@"TuSDKGeeV1.framework 的版本号 : %@",lsqGeeVersion);

    NSLog(@"TuSDKGeeV2.framework 的版本号 : %@",lsqGeeV2Version);

}

- (void)onTuSDKFilterManagerInited:(TuSDKFilterManager *)manager;
{
    // 可以将方法去掉，不进行初始化完成的提示
    [self showHubSuccessWithStatus:LSQString(@"lsq_inited", @"初始化完成")];
}