运行 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
。
本地的滤镜和贴纸资源可以让用户在没有网络的时候也能使用相关功能,用户可以选择将哪些资源包含在客户端内进行本地展示。详情请参考 自定义滤镜 和 自定义贴纸。
登录「控制台」,进入「我的应用」中创建应用,在包名处填写需要集成的项目包名,完成后可得到该应用唯一密钥。
若您对包名和密钥有疑问,请参考「应用包名与密钥」。
在 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", @"初始化完成")];
}
©2019-2020 TUTUCLOUD. All Rights Reserved. 杭州微禾迅科技有限公司 | 浙ICP备14040447号-1 | 浙公网安备33010602001649号