录制相机的使用

头文件	功能说明
TuSDKRecordVideoCamera.h	相机拍照录制类，支持参数设置，包含添加滤镜，贴纸，录制变声功能

1.启动相机

1.1 创建相机对象

录制相机对象

遵守代理 TuSDKRecordVideoCameraDelegate

@property (nonatomic, strong) TuSDKRecordVideoCamera *camera;

1.2 请求权限

相机权限

// 开启访问相机权限
[TuSDKTSDeviceSettings checkAllowWithController:self
                                           type:lsqDeviceSettingsCamera
                                      completed:^(lsqDeviceSettingsType type, BOOL openSetting)
 {
     if (openSetting) {
         lsqLError(@"Can not open camera");
         return;
     }
     // 启动相机的方法
     // ...
 }];

相册权限

// 测试相册访问权限
[TuSDKTSAssetsManager testLibraryAuthor:^(NSError *error)
{
    if (error) {
        [TuSDKTSAssetsManager showAlertWithController:self loadFailure:error];
    }else{
        NSLog(@"已经获得了相册的权限");
    }
}];

1.3 配置滤镜列表

    // 滤镜列表，获取滤镜前往 TuSDK.bundle/others/lsq_tusdk_configs.json  
    // TuSDK 滤镜信息介绍 @see-https://tusdk.com/docs/ios/self-customize-filter
    // 需要先配置好 _filterCodes 中的 filterCode ，在初始化滤镜栏 
    _filterCodes = @[@"Normal", kCameraFilterCodes];

1.4 启动相机

创建相机预览画面的视图

if (!_cameraView) {
    _cameraView = [[UIView alloc]initWithFrame:CGRectMake(0, 0, self.view.lsqGetSizeWidth, self.view.lsqGetSizeHeight)];
    [self.view addSubview:_cameraView];
    [self.view insertSubview:_cameraView atIndex:0];
}

启动相机对象

// SessionPreset :采集画面的清晰度，建议 AVCaptureSessionPresetHigh 
// 设置参考：AVFoundation/AVCaptureSession.h
// cameraPosition：默认前置摄像头，[AVCaptureDevice lsqFirstFrontCameraPosition]
_camera = [TuSDKRecordVideoCamera initWithSessionPreset:AVCaptureSessionPresetHigh
   cameraPosition:[AVCaptureDevice lsqFirstFrontCameraPosition]
       cameraView:_cameraView];
// 在这里进行相关参数的配置
// ........

// 启动相机
[_camera tryStartCameraCapture];

初始化相机时，以下几点需要注意
_camera.outputSize 和 _camera.videoQuality，影响保存视频的文件大小。
设置 outputSize 尺寸时，需要设置为 16 的倍数。

1.5 相机参数配置

相机初始化之后可根据实际使用需求进行相关参数配置
设置录制文件格式(默认：lsqFileTypeQuickTimeMovie)，可输出 MP4
```
_camera.fileType = lsqFileTypeMPEG4;
```

输出视频的画质，影响保存视频文件的体积

_camera.videoQuality = [TuSDKVideoQuality makeQualityWith:TuSDKRecordVideoQuality_Medium2];

设置委托
```
_camera.videoDelegate = self;
```
预览画面画幅设置，_cameraView 设置为全屏尺寸后，调节比例可以输出 1:1 画幅视频
```
_camera.cameraViewRatio = 1.0;
```
指定比例后，建议输出画面尺寸比例和设定的 cameraViewRatio 保持一致，SDK 会根据设备情况自动输出最合适的尺寸
```
_camera.outputSize = CGSizeMake(640, 640);
```
禁止触摸聚焦功能 (默认: NO)
```
 _camera.disableTapFocus = NO;
```
禁用持续自动对焦
```
_camera.disableContinueFoucs = NO;
```
视频覆盖区域颜色 (默认：[UIColor blackColor])
```
_camera.regionViewColor = [UIColor blackColor];
```
禁用前置摄像头自动水平镜像 (默认: NO，前置摄像头拍摄结果自动进行水平镜像)
```
_camera.disableMirrorFrontFacing = NO;
```
闪光灯模式（默认是关闭:AVCaptureFlashModeOff）
```
[_camera flashWithMode:AVCaptureFlashModeOff];
```
相机采集帧率，默认30帧; 开启智能贴纸时，帧率建议：25 ~ 30; 关闭智能贴纸时，帧率建议：30。（视机器性能决定）
```
_camera.frameRate = 30;
```
不保存到相册，可在代理方法中获取 result.videoPath（默认：YES，录制完成自动保存到相册）
```
_camera.saveToAlbum = NO;
```
保存到指定相册（需要将 saveToAlbum 置为 YES 后生效）
```
_camera.saveToAlbumName = @"TuSDK";
```
启用智能贴纸（开启后，可使用动态贴纸）
```
_camera.enableLiveSticker = YES;
```
设置是否启用人脸检测。如果使用人脸贴纸及微整形功能，该项需置为 YES。（注：须在相机启动之前调用）
```
_camera.enableFaceDetection = YES;
```

设置图片水印，默认为空

_camera.waterMarkImage = [UIImage imageNamed:@"sample.png"];

设置水印图片的位置

_camera.waterMarkPosition = lsqWaterMarkBottomRight;

最大录制时长 15s
```
_camera.maxRecordingTime = 15;
```
最小录制时长 3s
```
_camera.minRecordingTime = 3;
```

录制模式：续拍模式

_camera.recordMode = lsqRecordModeKeep;

设置默认滤镜

[_camera switchFilterWithCode:_filterCodes[1]];

设置使用录制相机最小空间限制，开发者可根据需要自行设置（单位：字节默认：50M）
```
_camera.minAvailableSpaceBytes = 1024.f*1024.f*50.f;  
```

设置预览画面距离顶端距离，SDK 会自动调整预览画面位置

CGFloat offset = 64/self.view.lsqGetSizeHeight;
_camera.regionHandler.offsetPercentTop = offset;

1.6 开始录制&暂停录制&结束录制

开始录制接口：
```
[_camera startRecording];
```
暂停录制接口：
```
 [_camera pauseRecording];
```
结束录制接口：
```
[_camera finishRecording];     
```

2.滤镜的使用

TuSDKFilterWrap 特效对象，包含贴纸，滤镜
Demo 提供使用范例，用户可根据接口自定义修改相关使用
视图层级介绍：CameraViewController -> cameraView -> CameraControlMaskView -> CameraFilterPanelView -> CameraFilterListView
CameraControlMaskView 引入头文件 #import "CameraFilterPanelView.h"

需要先配置好 _filterCodes 中的 filterCode ，再初始化滤镜栏

// 滤镜列表，获取滤镜前往 TuSDK.bundle/others/lsq_tusdk_configs.json  
// TuSDK 滤镜信息介绍 @see-https://tusdk.com/docs/ios/self-customize-filter
_filterCodes = @[kCameraFilterCodes];

滤镜栏 CameraFilterListView 内部根据配置好的 _filterCodes 自行创建 UI，继承自HorizontalListView
```
 _filterListView = [[CameraFilterListView alloc] initWithFrame:CGRectZero];
```

CameraViewController 实现CameraFilterPanelDelegate代理方法，切换滤镜

// 滤镜选中回调
- (void)filterPanel:(id<CameraFilterPanelProtocol>)filterPanel didSelectedFilterCode:(NSString *)code {
    // 通过滤镜码切换滤镜
    [_camera switchFilterWithCode:code];
}  

// 相机调用 switchFilterWithCode 之后的回调方法
/**
 *  相机滤镜改变 (如需操作UI线程， 请检查当前线程是否为主线程)
 *
 *  @param camera    相机对象
 *  @param newFilter 新的滤镜对象
 */
- (void)onVideoCamera:(id<TuSDKVideoCameraInterface>)camera filterChanged:(TuSDKFilterWrap *)newFilter;
{
    // 赋值新滤镜 同时刷新新滤镜的参数配置；
    self.currentFilter = newFilter;
}

3.美颜，微整形的使用

TuSDKFilterArg 滤镜参数调节，包含参数名，参数值等
Demo 提供使用范例，用户可根据接口自定义修改相关使用
视图层级介绍：CameraViewController -> cameraView -> CameraControlMaskView -> CameraBeautyPanelView -> CameraBeautySkinListView ，CameraBeautyFaceListView
CameraControlMaskView 引入头文件 #import "CameraBeautySkinListView.h"，#import "CameraBeautyFaceListView.h"

美颜，微整形界面初始化配置，均继承自HorizontalListView

__weak typeof(self) weakSelf = self;
// 美颜栏
_beautySkinListView = [[CameraBeautySkinListView alloc] initWithFrame:CGRectZero];
_beautySkinListView.itemViewTapActionHandler = ^(CameraBeautySkinListView *listView, HorizontalListItemView *selectedItemView, int level) {
    weakSelf.paramtersView.hidden = selectedItemView.tapCount < selectedItemView.maxTapCount;
    [weakSelf reloadFilterParamters];
};
_beautySkinListView.level = 1;

// 微整形栏    
_beautyFaceListView = [[CameraBeautyFaceListView alloc] initWithFrame:CGRectZero];
_beautyFaceListView.itemViewTapActionHandler = ^(CameraBeautyFaceListView *listView, HorizontalListItemView *selectedItemView, NSString *faceFeature) {
    weakSelf.paramtersView.hidden = faceFeature == nil;
    if (faceFeature) {
        // 重载参数列表，会触发数据源代理方法，提交滤镜参数
        [weakSelf reloadFilterParamters];
    } else {
        // 重载参数列表，会触发数据源代理方法，提交微整形参数
        [weakSelf resetBeautyFaceFilterParamters];
    }
};

CameraViewController 实现 CameraFilterPanelDelegate 代理方法，完成设置

//  滤镜面板参数变更回调
- (void)filterPanel:(id<CameraFilterPanelProtocol>)filterPanel didChangeValue:(double)percentValue paramterIndex:(NSUInteger)index {
    // 设置当前滤镜的参数，并 `-submitParameter` 提交参数让其生效
    TuSDKFilterArg *arg = _currentFilter.filterParameter.args[index];
    arg.precent = percentValue;
    [_currentFilter submitParameter];

}

4.1动态贴纸的使用

TuSDKPFStickerGroup 贴纸对象,包含贴纸id，缩略图地址等
Demo 提供使用范例，用户可根据接口自定义修改相关使用
视图层级介绍：CameraViewController -> cameraView -> CameraControlMaskView -> StickerPanelView -> StickerCategoryPageView
CameraControlMaskView 引入头文件 #import "StickerPanelView.h"

初始化贴纸栏

_stickerPanelView = [[StickerPanelView alloc] initWithFrame:CGRectZero];
_stickerPanelView.alpha = 0;
_stickerPanelView.sender = _stickerButton;
_stickerPanelView.delegate = _stickerPaneldelegate;

CameraViewController 实现 StickerPanelViewDelegate 代理方法，添加贴纸

- (void)stickerPanel:(StickerPanelView *)stickerPanel didSelectSticker:(TuSDKPFStickerGroup *)sticker {
    if (!sticker) {
    // 为nil时 移除已有贴纸组
        [_camera removeAllLiveSticker];
        return;
    }
    // 是否正在使用
    if (![_camera isGroupStickerUsed:sticker]) {
    // 展示对应贴纸组
    [_camera showGroupSticker:sticker];
    }
}

4.2动态贴纸在线下载

创建属性

@property (nonatomic, strong) TuSDKOnlineStickerDownloader *_stickerDownloader;

初始化贴纸在线下载工具

- (TuSDKOnlineStickerDownloader *)stickerDownloader 
{
    if (!_stickerDownloader) {
        _stickerDownloader = [[TuSDKOnlineStickerDownloader alloc] init];
        _stickerDownloader.delegate = self;
    }
    return _stickerDownloader;
}

StickerPanelView 遵守 TuSDKOnlineStickerDownloaderDelegate 代理，实现下载管理

#pragma mark - TuSDKOnlineStickerDownloaderDelegate

- (void)onDownloadProgressChanged:(uint64_t)stickerGroupId progress:(CGFloat)progress changedStatus:(lsqDownloadTaskStatus)status;
{
    if (status == lsqDownloadTaskStatusDowned || status == lsqDownloadTaskStatusDownFailed) 
    {
        BOOL success = status == lsqDownloadTaskStatusDowned;
        void (^downloaderCompletion)(BOOL success) = _downloadCallbackDic[@(stickerGroupId)];
        if (downloaderCompletion) {
            downloaderCompletion(success);
        }
    }
}

Demo/Resources/Assets 提供了customStickerCategories.json 文件，用户可根据需要自行添加删除贴纸。

json 文件中信息如下

  {
    "categories": [
    {
        // 分类名称
        "categoryName": "搞怪cos",
        "stickers": [
        {  
            // 贴纸名称
            "name": "晕",
            // 贴纸 ID， stickerID
            "id": "1622",
            // 贴纸 preview URL 地址
            "previewImage": "https://img.tusdk.com/api/stickerGroup/img?id=1622"
        },
        {
            "name": "绅士礼服",
            "id": "1566",
            "previewImage": "https://img.tusdk.com/api/stickerGroup/img?id=1566"
        }],
    },
    {
        "categoryName": "场景",
        "stickers": [
        {
            "name": "星球",
            "id": "1578",
            "previewImage": "https://img.tusdk.com/api/stickerGroup/img?id=1578"
        }]
    },
    {
        "categoryName": "萌宠",
        "stickers": [
        {
            "name": "白狐狸",
            "id": "1602",
            "previewImage": "https://img.tusdk.com/api/stickerGroup/img?id=1602"
        }]
    }]
    }

StickerPanelView 中 -(void)loadStickers; 方法中对 json 文件进行了读取使用

// 获取本地所有贴纸，并创建索引字典
NSArray<TuSDKPFStickerGroup *> *allLocalStickers = [[TuSDKPFStickerLocalPackage package] getSmartStickerGroups];
NSMutableDictionary *localStickerDic = [NSMutableDictionary dictionary];
for (TuSDKPFStickerGroup *sticker in allLocalStickers) {
    localStickerDic[@(sticker.idt)] = sticker;
}

// 遍历 categories 字段的数组，其每个元素是字典
NSArray *jsonCategories = jsonDic[kStickerCategoryCategoriesKey];
NSMutableArray *stickerCategories = [NSMutableArray array];
for (NSDictionary *categoryDic in jsonCategories) {
    StickerCategory *stickerCategory = [[StickerCategory alloc] init];
    stickerCategory.name = categoryDic[kStickerCategoryNameKey];

    // 通过 idt 进行筛选，若本地存在该贴纸，则使用本地的贴纸对象；否则为在线贴纸
    NSMutableArray *stickers = [NSMutableArray array];
    for (NSDictionary *stickerDic in categoryDic[kStickerCategoryStickersKey]) {
        NSInteger idt = [stickerDic[kStickerIdKey] integerValue];
        TuSDKPFStickerGroup *sticker = localStickerDic[@(idt)];
        if (sticker) {
            [stickers addObject:sticker];
        } else {
            // 在线贴纸对象创建
            OnlineStickerGroup *onlineSticker = [[OnlineStickerGroup alloc] init];
            sticker = onlineSticker;
            onlineSticker.idt = idt;
            onlineSticker.previewImage = stickerDic[kStickerPreviewImageKey];
            onlineSticker.name = stickerDic[kStickerNameKey];
            [stickers addObject:sticker];
        }
    }
    // 贴纸数组添加各个分类贴纸数组
    stickerCategory.stickers = stickers.copy;
    [stickerCategories addObject:stickerCategory];
}

动态贴纸的在线下载功能实现需要贴纸 ID（stickerID），如 json 文件中配置的贴纸已经打包在本地，那么界面将不会展示该贴纸可以进行在线下载
控制台操作，动态贴纸库，查看详情可看到对应的贴纸 ID 和贴纸名称。
可以动态下发包含贴纸 ID，categoryName 和 previewImage 的 URL 地址的 json 数据，来替换 demo customStickerCategories.json 文件来获取贴纸 ID，这部分为自定义操作。
customStickerCategories.json 不是必需文件，用户可自定义或调整。

4.3动态贴纸的删除

清理或更新本地动态贴纸资源，可通过以下方式进行删除贴纸操作，然后选择重新下载或以后下载

TuSDKPFStickerGroup *sticker = self.stickerCategorys[pageView.pageIndex].stickers[index];
[[TuSDKPFStickerLocalPackage package] removeDownloadWithIdt:sticker.idt];
// 完成删除操作后，记得重载数据刷新界面        
// [self reloadDataWithStickerId:sticker.idt];

5.录制支持音频变调

变调参数设置须在点击录制按钮前调用，支持断点录制下不同声调的变换

支持的声调：正常，怪兽，大叔，女生，萝莉

/**
 * 录制变声类型
 *
 * @since v3.0.1
 */
typedef NS_ENUM(NSUInteger, lsqSoundPitch) {
    // 正常
    lsqSoundPitchNormal,
    // 怪兽
    lsqSoundPitchMonster,
    // 大叔
    lsqSoundPitchUncle,
    // 女生
    lsqSoundPitchGirl,
    // 萝莉
    lsqSoundPitchLolita,
};

不支持自定义的声调调节

// 变声开关回调
- (void)moreMenu:(CameraMoreMenuView *)moreMenu didSwitchPitchType:(lsqSoundPitch)pitchType {
    _camera.soundPitch = pitchType;
}

6.获取录制结果

在 TuSDKVideoCameraDelegate 方法中获取录制结果

录制视频的结果获取

- (void)onVideoCamera:(TuSDKRecordVideoCamera *)camerea result:(TuSDKVideoResult *)result 
{
    // 通过相机初始化设置  _camera.saveToAlbum = NO;  result.videoPath 拿到视频的临时文件路径
    if (result.videoPath) {
        [[TuSDK shared].messageHub showSuccess:@"录制完成"];

        // 进行自定义操作，例如保存到相册
        UISaveVideoAtPathToSavedPhotosAlbum(result.videoPath, nil, nil, nil);
        [[TuSDK shared].messageHub showSuccess:@"保存成功"];
    } else {
        [[TuSDK shared].messageHub showSuccess:@"保存成功"];
    }

    // 保存操作执行后，记得更新界面 UI 的状态
    // [_captureMode reset];
}

saveToAlbum 置为 YES，在录制达到最大时长或中途保存后，会自动保存到相册中。
saveToAlbum 置为 NO，在录制达到最大时长或中途保存后，会通过 result.videoPath 获取到对应视频的临时文件，可进行自定义操作。

拍照结果获取

- (void)onVideoCamera:(id<TuSDKVideoCameraInterface>)camera takedResult:(TuSDKResult *)result error:(NSError *)error {
    if (result.image) {
        NSLog(@"result.image: %@",result.image);
        // 进行自定义操作，例如保存到相册
        // UIImageWriteToSavedPhotosAlbum(result.image, NULL, NULL, NULL);
    }
}

7.错误信息

录制出现错误的各种错误信息及处理

/**
 *  组件错误类型
 */
typedef NS_ENUM(NSInteger, lsqRecordError)
{
    /**
     *  未知
     */
    lsqRecordVideoErrorUnknow,

    /**
     * 存储空间不足
     */
    lsqRecordVideoErrorNotEnoughSpace,

    /**
     *  小于最小录制时长
     */
    lsqRecordVideoErrorLessMinDuration,

    /**
     *  大于最大录制时长
     */
    lsqRecordVideoErrorMoreMaxDuration,

    /**
     * 文件保存失败
     */
    lsqRecordVideoErrorSaveFailed,
};


- (void)onVideoCamera:(TuSDKRecordVideoCamera *)camerea failedWithError:(NSError*)error;
{
   switch (error.code) {
        case lsqRecordVideoErrorUnknow:

            break;
        default:
        break;
     }
  }

8.相机状态

相机录制操作过程中的各种录制状态

/**
 *  录制状态
 */
typedef NS_ENUM(NSInteger,lsqRecordState)
{
    /** 正在录制 */
    lsqRecordStateRecording,

    /** 录制完成 */
    lsqRecordStateRecordingCompleted,

    /** 正在保存 */
    lsqRecordStateSaveing,

    /** 保存完成 */
    lsqRecordStateSaveingCompleted,

    /** 正在合并视频 */
    lsqRecordStateMerging,

    /** 已暂停 */
    lsqRecordStatePaused,

    /** 已取消 */
    lsqRecordStateCanceled,
};


- (void)onVideoCamera:(TuSDKRecordVideoCamera *)camerea recordStateChanged:(lsqRecordState)state;
{
    switch (state) {
        case lsqRecordStatePaused:

            break;
        default:
        break;
     }
}

相机的各种状态

/**
 *  视频相机状态
 */
typedef NS_ENUM(NSInteger, lsqCameraState)
{
    /**
     *  未知
    */
    lsqCameraStateUnknow = 0,
    /**
     *  正在启动
     */
    lsqCameraStateStarting = 1,
    /**
     *  启动完成
     */
    lsqCameraStateStarted = 2,
    /**
     * 正在拍摄
     */
    lsqCameraStateCapturing = 3,

    /**
     * 录制暂停
     */
    lsqCameraStatePaused = 4,

    /**
     * 拍摄完成
     */
    lsqCameraStateCaptured = 5
};

- (void)onVideoCamera:(id<TuSDKVideoCameraInterface>)camera stateChanged:(lsqCameraState)state {
        switch (state) {
            case lsqCameraStateStarting:
                // 相机正在启动
                NSLog(@"TuSDKRecordVideoCamera state: 相机正在启动");
                break;
            default:
                break;
        }
}