涂图

  • 首页
  • 解决方案
    • 拍照和图片编辑
    • 视频录制和后期编辑
    • 模板视频
    • 人像美颜
    • 人脸特效
    • 滤镜特效
    • 贴纸特效
  • API服务
    • 人像服务
    • 视频融合
    • 人脸云
    • 在线滤镜
  • 客户案例
  • 下载
  • 文档
  • 关于我们
  • 控制台
  • 一、新手上路
  • 控制台操作说明
    • 控制台使用说明
    • 自定义资源上传说明
  • 二、SDK 文档
  • 图像 SDK
    • 产品说明
      • 产品指南
      • 性能测试报告
    • iOS 文档
      • 快速开始
      • 安装与更新
      • 集成向导
      • 相机组件的使用
      • 相册组件的使用
      • 照片美化组件的使用
      • 主题包基础使用
      • 自定义滤镜
      • 自定义贴纸
      • 自定义界面
      • 自定义 ProgressHUD 提示框(2.0.0~3.2.7)
      • 自定义 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文档
      • TuSDK Video Editor iOS 接入文档
    • Android文档
      • TuSDK Video Editor Android 接入文档
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
  • 流处理(特效相机) SDK
    • 产品说明
      • 产品指南
    • iOS 文档
      • TuSDK特效相机接入文档-iOS
      • TuSDK直播特效接入说明-iOS
    • Android 文档
      • TuSDK特效相机接入文档-Android
      • TuSDK直播特效接入说明-Android
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
  • 视频融合 SDK
    • 产品说明
      • 产品指南
      • 模板管理
    • iOS 文档
      • 快速开始
      • 安装与更新
      • TuSDK EVA 接入说明 2.0
      • API文档
    • Android 文档
      • 快速开始
      • 安装与更新
      • TuSDK EVA 接入说明 (2.0.0+)
      • API 文档
    • 模板设计
      • (新)标准模板设计规范
      • (旧)标准模板设计规范
      • 支持的 AE 功能和属性
      • 动态模板设计规范
    • 模板导出
      • (新)模板导出插件安装
      • (新)模板导出插件使用
      • (旧)模板导出插件安装
      • (旧)模板导出插件使用
      • (旧)模板效果查看器
      • (旧)模板打包规范
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
      • 导出插件版本更新日志
      • 效果查看器更新日志
  • 短视频 SDK
    • 产品说明
      • 产品指南
      • 性能测试报告
    • iOS 文档
      • 快速开始
      • 集成向导
      • 录制相机的使用
      • 视频编辑器的使用
      • 功能 API 的使用
      • API 文档
    • Android 文档
      • 快速开始
      • 集成向导
      • 录制相机的使用
      • 视频编辑器的使用
      • 功能 API 的使用
      • API 文档
    • iOS 技术问题
      • 常见问题
    • Android 技术问题
      • 常见问题
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
  • 三、云服务文档
  • 人像服务
    • 使用文档
      • 快速入门
      • 核心功能
    • API概述
      • API 概述
      • API 文档
    • 常见问题
      • 常见问题
  • 视频融合(云渲染)
    • 使用文档
      • 快速入门
      • 模板管理
    • API概述
      • API概述
      • API 文档
    • 模板设计
      • (新)标准模板设计规范
      • (旧)标准模板设计规范
      • 支持的 AE 功能和属性
      • 动态模板设计规范
    • 模板导出
      • (新)模板导出插件安装
      • (新)模板导出插件使用
      • (旧)模板导出插件安装
      • (旧)模板导出插件使用
      • (旧)模板效果查看器
      • (旧)模板打包规范
    • 常见问题
    • 版本更新日志
      • 导出插件版本更新日志
      • 效果查看器更新日志
  • 人脸云
    • 使用文档
      • 快速入门
      • 核心功能
    • API 概述
      • API 概述
    • 常见问题
      • 常见问题
  • 在线滤镜
    • 使用文档
      • 快速入门
      • 核心功能
      • FILTER API
      • API 错误码表
    • API概述
      • API 概述
    • 常见问题
      • 常见问题
  • 四、综合
  • 涂图隐私协议
  • 用户退出机制
  • 动态贴纸设计规范
  • 美妆贴纸设计规范
  • 云服务账单说明
  • 应用包名与密钥
  • 基础服务开发者升级流程
  • 五、常见问题
  • 常见问题
  • 遇到问题,怎么办?
  • 如何使用贴纸管理、滤镜管理?

相册组件的使用

  • TuSDK 的相册组件包含相册组件和多选相册组件。文档多选相册为例,展示组件的使用方法和自定义组件界面。
  • 如果用户使用 TUTUCLOUD 官方 Demo 登陆画面中的照片美化组件的启动方式调用,需要用户参考 Demo 中的 SampleBase 文件对自己的项目进行相关环境配置,详见 TuSDK-for-iOS-demo 。
  • 请用户直接使用 AlbumMultipleComponentSample 或者 AlbumComponentSample 中的代码进行照片美化组件的调用。
  • 请按照官方 Demo 中给出的方法进行使用,不要更改组件的代码顺序。

启动多选相册

  • 在需要使用组件的地方导入头文件 #import <TuSDKGeeV1/TuSDKGeeV1.h>。
  • 创建组件对象,需要将组件声明成全局变量。
/**
 *  多选相册组件
 */
@interface AlbumMultipleComponentSample ()
{
    // 多选相册组件
    TuSDKCPAlbumMultipleComponent *_albumComponent;
}
@end
  • 在需要使用组件的地方调用组件的启动方法
  • 如果是直接在点击事件中启动组件,组件启动方法中传入的控制器的参数要写 self 。
  • 多选相册组件是将相机和相册的功能整合在一起,相机的 option 功能参数设置可以参考文档相机组件的使用。
  • 单独启动组件,请事先确定默认主题包的 style,如不使用 GeeV2 主题包的相关功能,可不进行 style 的设置
    // 使用默认主题包的组件需要在组件启动前提前选择主题包的`style`,避免默认主题包组件 UI 显示异常。
    // [TuSDK shared].style = lsqSdkUIDefault;
    _albumComponent =
    [TuSDKGeeV1 albumMultipleCommponentWithController:controller
                           callbackBlock:^(TuSDKResult *result, NSError *error, UIViewController *controller)
     {

    // 相册选择获取到的是照片的对象,选择单张照片获取的是 result.imageAsset ,是 id<TuSDKTSAssetInterface> imageAsset 类型
    // 选择多张照片获取的是 result.imageAssets ,是 NSArray<TuSDKTSAssetInterface> *imageAssets 类型
    // result.imageAssets 这个数组内存放的是 id<TuSDKTSAssetInterface> imageAsset 类型的对象

    // 用户可以将多选相册连接图片编辑器使用
    // 开启裁切+滤镜组件,需要遵守 TuSDKPFEditTurnAndCutDelegate
    // [self openEditAndCutWithController:controller result:result];

    // 开启裁切+滤镜+贴纸编辑组件,需要将组件声明成全局变量
    // [self openEditAdvancedWithController:controller result:result];

    // 开启照片美化组件,需要将组件声明成全局变量
    // [self openEditMultipleWithController:controller result:result];

    // 详细开启编辑组件的方法请参考 demo 中各组件开启方法内的详细代码

    // 用户只是单独的使用多选相册并对选择的图片对象进行处理
    // 用户可以通过数组下标的方式获取到对应的照片对象
    // 将 result.imageAsset 对象转换为图片的操作需要消耗一部分性能
    // id<TuSDKTSAssetInterface> storeimageAsset = [result.imageAssets objectAtIndex:0];
    // UIImage *storeImage = [storeimageAsset fullResolutionImage];

    // 用户使用多选相册的相机进行拍照获取 result.image 需要对 option 对应的功能参数进行设置

     }
     maxSelectionNumber:9];

    // @see-http://tusdk.com/docs/ios/image/api-geev1/Classes/TuSDKPFAlbumMultipleOptions.html
    // _albumComponent.options.albumOptions
    // _albumComponent.options.albumOptions.viewClazz = [TuSDKPFAlbumView class];

    // @see-http://tusdk.com/docs/ios/image/api-geev1/Classes/TuSDKPFCameraOptions.html
    // _albumComponent.options.cameraOptions
    // _albumComponent.options.cameraOptions.viewClazz = [TuSDKPFCameraView class];

    // 需要进行对 option 进行设置,相机拍照后可以获取到 result.image
    // _albumComponent.options.cameraOptions.saveToAlbum = NO;
    // _albumComponent.options.cameraOptions.saveToTemp = NO;
    // 相册组件中每行的相片数目,默认是 0 ,系统会自动适配,也可以自己进行设置
    // _albumComponent.options.albumOptions.photoColumnNumber = 5;

    // 设置照片排序方式(多选相册特有,支持 iOS 8 及以上)
    // _albumComponent.options.albumOptions.photosSortKeyType = lsqAssetSortKeyCreateDate;
    // 设置选择照片的最大尺寸 默认:8000*8000
    // _albumComponent.options.albumOptions.maxSelectionImageSize  = CGSizeMake(8000, 8000);    

    // 是否在组件执行完成后自动关闭组件 (默认:NO)
    _albumComponent.autoDismissWhenCompelted = YES;
    [_albumComponent showComponent];

设置多选相册的默认参数

  • 多选相册的 option 设置分为相机和相册两个部分。
  • 相册的相关参数设置可以通过 _albumComponent.options.albumOptions 进行设置,全部参数请阅读多选相册的选项配置。
  • 相机的相关参数设置可以通过 _albumComponent.options.cameraOptions 进行设置,全部参数请阅读相机组件选项配置。

相册指定界面视图类型

  • 默认多选相册视图类,需要继承 TuSDKPFAlbumMultipleView ,修改并覆盖原有方法,指定新的视图。
    _albumComponent.options.albumOptions.viewClazz = [TuSDKPFAlbumMultipleView class];
  • 默认多选相册控制器类,需要继承 TuSDKPFAlbumMultipleViewController
    _albumComponent.options.albumOptions.componentClazz = [TuSDKPFAlbumMultipleViewController class];
  • 默认多选相册照片列表视图类,需要继承 TuSDKPFPhotosGridView
    _albumComponent.options.albumOptions.photosViewClazz = [TuSDKPFPhotosGridView class];
  • 默认多选相册照片列表单元格视图类,需要继承 TuSDKPFPhotosGridCell
    _albumComponent.options.albumOptions.gridCellViewClazz = [TuSDKPFPhotosGridCell class];
  • 默认多选相册相册列表视图类,需要继承 TuSDKPFAlbumPopList
    _albumComponent.options.albumOptions.albumPopListClazz = [TuSDKPFAlbumPopList class];
  • 默认多选相册相册列表行视图类,需要继承 TuSDKPFAlbumPopListCell
    _albumComponent.options.albumOptions.albumPopListCellClazz = [TuSDKPFAlbumPopListCell class];

相机指定界面视图类

  • 默认相机视图类,需要继承 TuSDKPFCameraView ,修改并覆盖原有方法,指定新的视图。
   _albumComponent.options.cameraOptions.viewClazz = [TuSDKPFCameraView class];
  • 默认相机控制栏视图类,需要继承 TuSDKPFCameraConfigView
   _albumComponent.options.cameraOptions.configBarViewClazz = [TuSDKPFCameraConfigView class];
  • 默认相机底部栏视图类, 需要继承 TuSDKPFCameraBottomView
   _albumComponent.options.cameraOptions.bottomBarViewClazz = [TuSDKPFCameraBottomView class];
  • 闪光灯视图类, 需要继承 TuSDKPFCameraFlashView
   _albumComponent.options.cameraOptions.flashViewClazz = [TuSDKPFCameraFlashView class];
  • 滤镜视图类 (默认:TuSDKPFCameraFilterGroupView, 需要继承 TuSDKPFCameraFilterGroupView
   _albumComponent.options.cameraOptions.filterViewClazz = [TuSDKPFCameraFilterGroupView class];
  • 聚焦触摸视图类, 需要继承 TuSDKCPFocusTouchView
   _albumComponent.options.cameraOptions.focusTouchViewClazz = [TuSDKCPFocusTouchView class];
  • 滤镜分组列表行视图类, 需要继承 TuSDKCPGroupFilterGroupCell
   _albumComponent.options.cameraOptions.filterBarGroupCellClazz = [TuSDKCPGroupFilterGroupCell class];
  • 滤镜列表行视图类, 需要继承 TuSDKCPGroupFilterItemCell
   _albumComponent.options.cameraOptions.filterBarTableCellClazz = [TuSDKCPGroupFilterItemCell class];
  • 滤镜列表行视图宽度
   _albumComponent.options.cameraOptions.filterBarCellWidth = 60;
  • 滤镜列表选择栏高度
   _albumComponent.options.cameraOptions.filterBarHeight = 80;

相机功能选项设置

  • 设置后置摄像头优先启动,默认是后置摄像头启动
    _albumComponent.options.cameraOptions.cameraPostion = [AVCaptureDevice firstBackCameraPosition];
  • 设置前置摄像头优先启动
    _albumComponent.options.cameraOptions.cameraPostion = [AVCaptureDevice firstFrontCameraPosition];
  • 设置前置摄像头拍照水平镜像,设置为 NO ,拍摄的照片会出现左右镜像变化
    _albumComponent.options.cameraOptions.disableMirrorFrontFacing = YES;
  • 拍照分辨率,默认设置最高,修改设置可查阅AVCaptureSession文档选择合适的模式
    _albumComponent.options.cameraOptions.sessionPreset = AVCaptureSessionPresetHigh;
  • 照片输出压缩率,设置范围压缩率 0-1 如果设置为0 将保存为PNG格式,默认设置是 0.95。
    _albumComponent.options.cameraOptions.outputCompress = 0.95f;
  • 视频覆盖区域颜色,默认设置是 [UIColor clearColor] ,更改设置需要将颜色的代码部分转化为十六进制转的颜色对象,十六进制字符串,例如 @"#FF5534"
    _albumComponent.options.cameraOptions.regionViewColor = [UIColor lsqClorWithHex:@"#403e43"];
  • 照片的输出图片大小,可以控制输出照片的尺寸,设置 ratioType 功能配置项将会失效。
    _albumComponent.options.cameraOptions.outputSize = CGSizeMake(1440, 1920);
  • 闪光灯关闭模式,默认是设置关闭
   _albumComponent.options.cameraOptions.cameraDefaultFlashMode = AVCaptureFlashModeOff;
  • 闪光灯开启模式,设置为开启模式,启动相机摄像头,闪光灯开启
   _albumComponent.options.cameraOptions.cameraDefaultFlashMode = AVCaptureFlashModeOn;
  • 闪光灯自动模式,闪光灯会根据光线强度,自动开启或关闭
   _albumComponent.options.cameraOptions.cameraDefaultFlashMode = AVCaptureFlashModeAuto;
  • 相机视图显示比例设置,可以直接设置比例,默认是 0 显示全屏,设置范围 0-1 , 0 <= mRegionRatio
    _albumComponent.options.cameraOptions.cameraViewRatio = 0.75f
  • 相机视图显示比例类型设置,默认设置是 lsqRatioAll, 如果设置cameraViewRatio > 0, 将忽略ratioType
    _albumComponent.options.cameraOptions.ratioType = lsqRatioAll;
    lsqRatioAll = lsqRatioOrgin | lsqRatio_1_1 | lsqRatio_2_3 | lsqRatio_3_4 | lsqRatio_9_16 ; 
  • 相机网格辅助线,默认设置是 false 表示关闭辅助线,可设置启动相机时开启辅助线
    _albumComponent.options.cameraOptions.displayGuideLine = false;
  • 长按设置,默认是 NO 表示关闭,设置开启后长按可以拍摄
    _albumComponent.options.cameraOptions.enableLongTouchCapture = YES;
  • 长按延时设置,默认设置为 1.2秒,可以手动更改
    _albumComponent.options.cameraOptions.longTouchDelay = 1.2;
  • 持续自动对焦,默认设置是 NO 表示关闭,开启后每间隔固定时间会自动进行对焦
    _albumComponent.options.cameraOptions.disableContinueFoucs = YES;
  • 自动聚焦延时,默认设置 5秒,可以更改时间,每间隔 5 秒进行相机进行对焦
    _albumComponent.options.cameraOptions.autoFoucsDelay = 5;

相机组件滤镜模块的设置

  • 开启滤镜支持,默认是 NO 表示关闭状态, 要手动设置开启,相机组件才会显示滤镜模块
   _albumComponent.options.cameraOptions.enableFilters = YES;
  • 显示滤镜视图,如果 enableFilters = NO, showFilterDefault 将失效,使用滤镜是需要将 enableFilters 和 showFilterDefault 都设置成 YES
   _albumComponent.options.cameraOptions.showFilterDefault = YES;
  • 开启滤镜历史记录
   _albumComponent.options.cameraOptions.enableFilterHistory = YES;
  • 开启在线滤镜
   _albumComponent.options.cameraOptions.enableOnlineFilter = YES;
  • 显示滤镜标题视图
   _albumComponent.options.cameraOptions.displayFilterSubtitles = YES;
  • 滤镜去除分组显示,自定义显示需求滤镜。
  • 注意 : 使用在线滤镜下载到本地的滤镜是分组显示的滤镜,如果设置了 filterGroup ,那么在线滤镜下载的滤镜将会无法显示。
  • 滤镜名称列表,滤镜名称参考 TuSDK.bundle/others/lsq_tusdk_configs.json,滤镜分组 filterGroups[]->filters[]->name lsqfilter%{Brilliant}
    _albumComponent.options.cameraOptions.filterGroup = @[@"SkinNature", @"SkinPink", @"SkinNoir", @"SkinRuddy", @"SkinSugar"];

  • 启动多选相册
  • 设置多选相册的默认参数
  • 在线技术支持
  • 专业售前售后团队
  • 版本定期更新
  • 全方位解决方案

商务合作

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

关注我们

qrcode

©2019-2025 TUTUCLOUD. All Rights Reserved. 杭州元凡视觉智能科技有限公司 | 浙ICP备14040447号-1 | 浙公网安备33010602001649号

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