涂图

  • 首页
  • 解决方案
    • 拍照和图片编辑
    • 视频录制和后期编辑
    • 模板视频
    • 人像美颜
    • 人脸特效
    • 滤镜特效
    • 贴纸特效
  • API服务
    • 人像服务
    • 视频融合
    • 人脸云
    • 在线滤镜
  • 客户案例
  • 下载
  • 文档
  • 关于我们
  • 控制台
  • 一、新手上路
  • 控制台入门
    • 控制台使用说明
  • 二、SDK 文档
  • 图像 SDK
    • 产品说明
      • 使用指南
      • 性能测试报告
    • iOS 文档
      • 快速开始
      • 安装与更新
      • 集成向导
      • 相机组件的使用
      • 相册组件的使用
      • 照片美化组件的使用
      • 主题包基础使用
      • 自定义滤镜
      • 自定义贴纸
      • 自定义界面
      • 自定义 ProgressHUD 提示框
      • API 文档
      • 致谢
    • Android 文档
      • 快速开始
      • 安装与更新
      • 集成向导
      • 相机组件的使用
      • 照片美化组件的使用
      • 头像设置组件的使用
      • 多选相册组件的使用
      • 主题包基础使用
      • 自定义贴纸
      • 自定义滤镜
      • 自定义界面
      • 自定义进度信息提示框
      • 自定义 Activity 打开相机
      • API 文档
      • 致谢
    • iOS 技术问题
      • 「Incorrenct app key」
      • 更换滤镜效果图
      • 导航栏与状态栏
      • 组件中使用部分滤镜
      • Cocoapods 相关问题
      • 图片尺寸变化
      • Photos.framework 相关错误
      • 多包名发布
      • GPUImage 的相关错误
      • TuSDKTSALAsset 转换系统对象
      • 滤镜无法显示名称
      • 获取相机的点击事件
    • Android 技术问题
      • Incorrenct app key
      • 重复引用包
      • Recyclerview 库缺失
      • 方法数超出 65536 限制
      • 传入图片路径
      • 指定裁剪比例
      • 指定相册每行列数
      • 禁用相册自动跳转
      • 如何使用部分滤镜?
      • 代码混淆
      • TuSDK 使用的依赖库
      • 多渠道打包
      • 设置相机输出尺寸
      • 相机横屏设置
      • 自定义照片美化组件各功能模块效果默认参数值
    • 版本更新日志
      • iOS 版本更新日志
      • Android 更新日志
  • 短视频 SDK
    • 产品说明
      • 使用指南
      • 性能测试报告
    • iOS 文档
      • 快速开始
      • 集成向导
      • 录制相机的使用
      • 视频编辑器的使用
      • 功能 API 的使用
      • API 文档
    • Android 文档
      • 快速开始
      • 集成向导
      • 录制相机的使用
      • 视频编辑器的使用
      • 功能 API 的使用
      • API 文档
    • iOS 技术问题
      • 常见问题
    • Android 技术问题
      • 常见问题
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
  • 视频融合 SDK
    • 产品说明
      • 使用指南
      • 模板设计规范
      • 支持的 AE 功能
      • 模板管理
    • iOS 文档
      • 快速开始
      • 安装与更新
      • 集成向导
      • 模版加载器的使用
      • 模板播放器的使用
      • 模板导出器的使用
      • API文档
    • Android 文档
      • 快速开始
      • 安装与更新
      • EVA播放器的使用
      • 模板资源管理器的使用
      • 模板保存器的使用
      • API 文档
    • 模板导出
      • 模板导出插件安装
      • 导出插件使用
      • 模板打包规范
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
      • 导出插件版本更新日志
  • 直播特效 SDK
    • 产品说明
      • 产品介绍
    • iOS 文档
      • TuSDK直播特效接入说明-iOS
    • Android 文档
      • TuSDK直播特效接入说明-Android
  • 三、云服务文档
  • 人像服务
    • 使用文档
      • 快速入门
      • 核心功能
    • API概述
      • API 概述
      • API 文档
    • 常见问题
      • 常见问题
  • 视频融合(云渲染)
    • 使用文档
      • 快速入门
      • 模板设计规范
      • 支持的 AE 功能
      • 模板管理
    • API概述
      • API概述
      • API 文档
    • 模板导出
      • 模板导出插件安装
      • 导出插件使用
      • 模板打包规范
    • 常见问题
    • 版本更新日志
      • 导出插件版本更新日志
  • 人脸云
    • 使用文档
      • 快速入门
      • 核心功能
    • API 概述
      • API 概述
    • 常见问题
      • 常见问题
  • 在线滤镜
    • 使用文档
      • 快速入门
      • 核心功能
      • FILTER API
      • API 错误码表
    • API概述
      • API 概述
    • 常见问题
      • 常见问题
  • 人脸核查服务
    • 使用说明
      • 产品介绍
      • 服务开通
      • 用户数据管理
    • 费用说明
      • 费用说明
    • 客户端说明
      • 操作须知
      • 客户端配置
      • 基本功能操作
      • 统计数据操作
    • 常见问题
      • 常见问题
  • 四、综合
  • 云服务账单说明
  • 应用包名与密钥
  • 遇到问题,怎么办?
  • 如何使用贴纸管理、滤镜管理?
  • 基础服务开发者升级流程
  • 五、常见问题
  • 常见问题

TuSDK for iOS 安装与更新

  • 如果习惯手动管理依赖库,建议选择手动安装。如果用户已经在使用 CocoaPods,可以选择自动安装。
  • 如果用户工程已使用 GPUImage 的部分功能,建议用户使用 Github 提供的 完整版GPUImage 。

文件说明

基础模块

  • TuSDK.framework 是 TuSDK 功能调用的基础功能包。

主题模块

  • TuSDKGeeV1.framework 是默认主题包(GeeV1),包含:「相机组件」,「相册组件」,「多选相册组件」,「头像组件」,「照片美化组件」和「裁切 + 滤镜组件」等功能。
  • TuSDKGeeV2.framework 是 GeeV2 主题包,包含:「相机组件」+「多选相册组件」+「多图片编辑组件」整体调用的功能组件。

资源文件

  • TuSDK.bundle 文件包含:滤镜贴纸等资源文件,用户权限的配置文件和 SDK 使用的 UI 图片文件。
  • TuSDK.strings 是 TuSDK 的语言文件,目前支持「简体中文」,「繁体中文」和「英文」。

手动安装

首次安装

各个主题包相互之间没有依赖关系,可以同时使用,也可以分开使用,接下来以TuSDKGeeV1.framework默认主题包举例,进行 SDK 的手动集成操作

1、下载 GPUImage 和 TuSDK for iOS,解压缩。拖拽 GPUImage.framework 、 TuSDK.framework 和 TuSDKGeeV1.framework 到 Xcode 项目中。最新版本号请查看下载页面。(使用 TuSDK.framework Version 3.0.0 及以上版本不需要进行 GPUImage.framework 的操作)

1

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

2

3、打开项目的 app target,查看 Build Settings 中的 Linking - Other Linker Flags 选项,确保含有 -ObjC 一值,若没有则添加。

3

4、在项目的 app target 中,查看 Build Phases 中的 Linking - Link Binary With Libraries 选项中,手动添加 Photos.framework,并将对应 Status 设置成 Optional;TuSDK.framework Version 3.1.1 及以上版本,手动添加 libresolv.tbd;TuSDK.framework Version 3.2.0及以上版本,手动添加WebKit.framework,并将对应 Status 设置成 Optional。

5、拖拽 Localization/*.lproj/TuSDK.strings到 Xcode 项目中。

4

6、勾选 Copy items if needed ,点击 Finish。

5

7、选中 TuSDK.strings 文件,点击 Xcode 的右边栏中的 Localize...,选择相应语言,点击 Localize。

6

8、点击 Localize,效果图如下。

7

9、下载 TuSDK-for-iOS-demo 在 Demo 中找到 Resources 文件中的 TuSDK.bundle,右键 Show in Finder。

8

10、在 Demo 的 Resources 中找到 TuSDK.bundle 文件,并拖拽到到自己的 Xcode 项目中。

9

11、在 TUTUCLOUD 网站控制台内挑选项目需要的滤镜和贴纸资源,并将客户端需要用到的资源进行「打包」操作,然后在「资源打包」处下载。

10

12、将下载好的文件替换到 TuSDK.bundle 中。首先请将 Demo 中的旧文件删除,包括 others 目录下的 lsq_tusdk_configs.json 文件和 stickers、textures 两个目录。然后再将从控制台下载的资源文件拖入工程中对应的位置。

11

13、所有步骤完成效果图如下

12

  • 完成集成操作后用户也可以随时在控制台内配置在线商店中需要显示的资源。例如:用户可以在控制台官方滤镜可以获取滤镜资源,在我的滤镜库中,可以进行打包或上线的操作,上线操作是可以在在线滤镜显示,打包操作是选择的滤镜资源会出现在资源打包选项里,您可以通过资源打包将这些资源打包到本地显示。其他资源的操作也是如此。

更新

  • 版本升级:删除旧文件,然后重复首次安装的步骤。
  • 权限时间延长:不更换库文件,在控制台确认,包名(BundleID)和秘钥(AppKey)是否和项目中的一致,重新打包资源文件,将资源文件中的 others/lsq_tusdk_configs.json 中的 masterkey 字段替换到项目中 TuSDK.bundle/others/lsq_tusdk_configs.json 对应的位置即可。

自动安装(CocoaPods)

关于 CocoaPods 的安装和使用,以及 gem 更换镜像的方法,请查阅互联网资料。

首次安装

  • Cocoapods 线上的 TuSDK 最新版本号,请查看Cocoapods 官网地址查询。
  • 进行 pod search 操作无法搜索到 TuSDK 的最新版本,请进行 pod repo update操作。

1、 使用您熟悉的文本编辑器(例如 Vim),在项目的根目录中创建 Podfile 文件。最新版本号请查看下载页面。

  • podfile 文件中的 platform 修改为 platform :ios, '6.0'。
  • 向 podfile 文件添加依赖并保存:pod 'TuSDK', '~> 2.6.1'。运行后会安装「基础模块」和所有的「主题模块」。
platform :ios, '6.0'
target "PROJECT_NAME" do
pod 'TuSDK', '~> 2.6.1'
end
  • 向 podfile 文件添加依赖并保存,运行后会安装「基础模块」和指定的「主题模块」。
  • 主题模块功能包可任选其一或全选
platform :ios, '6.0'
pod 'TuSDK/Core', '~> 2.6.1'
pod 'TuSDK/ImageGeeV1', '~> 2.6.1'
pod 'TuSDK/ImageGeeV2', '~> 2.6.1'

2、 然后运行 pod install 即可安装。

3、在项目的 app target 中,查看 Build Phases 中的 Linking - Link Binary With Libraries 选项中,手动添加 Photos.framework,并将对应 Status 设置成 Optional;如果使用 TuSDK.framework Version 3.1.1 及以上版本,手动添加 libresolv.tbd;TuSDK.framework Version 3.2.0及以上版本,手动添加WebKit.framework,并将对应 Status 设置成 Optional。

4、下载 TuSDK-for-iOS-demo 在 Demo 中找到 Resources 文件中的 TuSDK.bundle,右键 Show in Finder。

8

5、下载 TuSDK-for-iOS-demo 在 Demo 中找到 Resources 文件中的 TuSDK.bundle,右键 Show in Finder。

9

6、在 Demo 的 Resources 中找到 TuSDK.bundle 文件,并拖拽到到自己的 Xcode 项目中。

10

7、在 TUTUCLOUD 网站控制台内挑选项目需要的滤镜和贴纸资源,并将客户端需要用到的资源进行「打包」操作,然后在「资源打包」处下载。

11

8、将下载好的文件替换到 TuSDK.bundle 中。首先请将 Demo 中的旧文件删除,包括 others 目录下的 lsq_tusdk_configs.json 文件和 stickers、textures 两个目录。然后再将从控制台下载的资源文件拖入工程中对应的位置。

12

完成操作后,用户可以随时在控制台内配置在线滤镜和在线贴纸中需要显示的资源。

更新

1、如果 Podfile 内指定了版本号,先更改至最新。

2、运行 pod update。

3、如果用户只更新 TuSDK 的库文件,而保证项目内其他第三方依赖库不变,请运行 pod update PODNAME。详细资料请参考CocoapodsGuide.pod install vs. pod update

4、如果无法更新到 TuSDK 的最新版,请进行 pod repo update操作,然后再 pod update。

5、Cocoapods 操作资料请参考Cocoapods-guides。

  • 文件说明
  • 手动安装
  • 自动安装(CocoaPods)
  • 在线技术支持
  • 专业售前售后团队
  • 版本定期更新
  • 全方位解决方案

商务合作

  • 177-6716-7529
  • 2969573855
  • sales@tusdk.com
  • 浙江省 杭州市 西湖区 西斗门9号 福地创业园1号楼3楼301室

关注我们

qrcode

©2019-2020 TUTUCLOUD. All Rights Reserved. 杭州微禾迅科技有限公司 | 浙ICP备14040447号-1 | 浙公网安备33010602001649号

  • 177-6716-7529
  • sales@tusdk.com
  • 2969573855