TuSDK 使用指南

TuSDK（涂图）是移动端图像处理的一站式解决方案，它全面覆盖相机拍照、图片编辑、人像美化、贴纸装饰、实时滤镜等需求。

TuSDK 支持 iOS 和 Android 两大平台，适配众多主流机型。开发者无需关心底层技术及具体实现，直接调用相应模块即可实现专业的图像处理功能，从而有效降低产品开发的技术门槛和时间成本。

功能说明

TuSDK 目前为用户提供的功能如下：

功能点	功能介绍	版本
UI界面	可支持 UI 层级代码改动	2.0.0(+)

相机拍摄

功能点	功能介绍	版本
闪光灯	可控制闪光灯使用状态	2.0.0(+)
自定义分辨率及质量	允许用户根据场景自定义分辨率和质量	2.0.0(+)
滤镜	改变图片色值，以美化图片	2.0.0(+)
摄像头切换	录制时，可切换前后摄像头	2.0.0(+)
焦距调节	双指缩放调节焦距	2.0.0(+)
网格线	支持拍照时，网格线的开启和关闭，便于使用者构图	2.0.0(+)
拍摄比例切换	支持1:1、2:3、3:4、全屏等拍摄比例的实时切换	2.0.0(+)
人像美颜	支持人脸进行磨皮美化处理	2.0.0(+)
漫画滤镜	提供多套类似iPhone中动漫滤镜效果	3.0.2(+)

图片编辑

功能点	功能介绍	版本
图片裁剪、旋转	可将图片裁剪成 1:1、4:3 等比例并支持旋转图片	2.0.0(+)
色值调整	调整图片的亮度、对比度、饱和度等参数	2.0.0(+)
暗角	由图片的角落至中心出现黑色半透明遮罩	2.0.0(+)
贴纸	为图片添加各式各样的贴纸，并支持旋转、缩放、位移	2.0.0(+)
简单文字	在图片上编辑文字，并支持旋转、缩放、位移	2.0.0(+)
气泡文字	基于气泡底图，添加文字。呈现气泡文字效果。	4.0.0(+)
涂抹（马赛克）	通过手指触摸图片，在触摸轨迹上为图片叠加彩铅样式、树叶样式、马赛克样式等效果	2.0.0(+)
HDR	利用每个曝光时间相对应最佳细节的 LDR 图像来合成最终 HDR 图像，能够更好地反映出真实环境中的视觉效果	2.0.0(+)
模糊	通过手指触摸图片，在触摸轨迹上为图片叠加模糊效果	2.0.0(+)
光圈	可选择线性或径向为局部图片添加模糊效果	2.0.0(+)
锐化	增大色彩艳丽度，使图片整体感觉变得清晰明丽	2.0.0(+)
圣光	为图片较亮部分及其边缘叠加一层带有朦胧效果的亮光	2.0.0(+)
图片高清输出	支持原图输出	2.0.0(+)
人像美颜	支持人脸进行磨皮、美白、大眼、瘦脸美化处理，支持一键美颜	2.0.0(+)
漫画滤镜	提供多套类似iPhone中动漫滤镜效果	3.0.2(+)
自动校色	支持对图片的自动校色，支持一键校色	2.0.0(+)
涂鸦	支持对图片的涂鸦效果添加，笔画的粗细、颜色均可调节	3.1.0(+)
拼图	支持不同模板的图片拼图功能，例如海报、长图、多格等形式	4.1.0(+)

其他支持

功能点	功能介绍	版本
赠送贴纸	购买 SDK 后，可从涂图官方控制台获取所赠贴纸	2.0.0(+)
赠送滤镜	购买 SDK 后，可从涂图官方控制台获取所赠滤镜	2.0.0(+)
可创建包数量	不同套餐将提供不同包数量，详情请联系商务	2.0.0(+)
去除 TuSDK 品牌	在图片输出时，完全去除带有 TuSDK 的品牌信息	2.0.0(+)

组件介绍

TuSDK 将有关图像处理的常见场景封装为了组件，开发者可根据需要直接调用或进行扩展。

组件列表

功能套件

相机组件
照片美化
裁切 + 滤镜组件
头像设置组件
裁切 + 滤镜 + 贴纸组件

常用组件

相册组件
多选相册组件
GIF 组件

组件用法示例

拍照 + 编辑示例
美颜相机
滤镜组件示例
贴纸组件示例
模糊组件示例

自定义界面示例

由「功能套件」扩展而来，根据相关组件的接口修改了界面，需要自定义界面请着重看这一组例子。

裁切组件自定义界面
相机组件自定义界面

API 使用示例

展示底层 API 调用，仅供学习参考，产品环境请勿使用。

个性化相机示例

使用步骤

注册开发者账户

在 TUTUCLOUD 的官方网站，点击右上角的「控制台」链接，进入登录界面。
如果已经是 TUTUCLOUD 的用户，可以直接进行登录操作，如果您不是我们的用户，请进行账号的注册。
在注册界面填写邮箱、用户名、手机号等信息，然后点击注册。
注册成功后，邮箱会收到一封验证邮件。请按照邮件说明进行验证，完成邮箱绑定操作。成功验证后，账户即可登录使用。

为了便于我们在紧急时刻联系到您，请务必填写真实的手机号。如果用户提供的资料不实，TUTUCLOUD 保留取消您的资格并随时结束为您提供服务的权利。当然，TUTUCLOUD 将对用户的资料、数据采取对外保密措施，相关细节在服务协议中有详细说明。

刚注册的开发者账户属于初级用户，根据开发需求，您还可以进行个人认证或企业认证，点击这里了解更多。

设备及系统要求

设备要求：搭载 Android 和 iOS 系统的手机设备

系统要求：Android 5.0 和 iOS 9.0 及其以上

下载 TuSDK

进入官网下载页面,可以进行SDK源码、示例代码、DEMO下载，其中DEMO可以扫描下方二维码直接下载：

Alt text

创建应用，获取 appkey，导出资源包

进入「控制台」，点击进入应用管理中我的应用选项。
创建应用，按要求填写相关信息，选择平台 iOS 或者 Android，根据用户情况选择个人开发 或 企业开发，填写完毕后进行提交。
系统会自动为每个应用生成一个唯一的密钥，即SDK初始化时要填写的appkey。密钥与应用是一一对应的，更换应用包名时，系统也会自动生成新的密钥。一个账户可以创建若干应用。
在我的应用下，点击资源打包，选择好应用后，点击下载按钮，保存文件，以便稍后集成时使用。默认情况下，资源包中包含了所有免费的滤镜、贴纸等资源。当然，用户也可以根据情况进行自定义。
每一个应用所使用的资源文件都是一一对应的，所以如果有多个应用需要分别对其进行资源文件的打包下载。

在集成 TuSDK 时，如果密钥、应用和资源包不匹配，会导致 SDK 无法正常运行。

安装与集成

用户可以根据下面的文档完成安装与集成：

涂图