TXUGCRecord
短视频录制基础接口
API | 描述 |
获取录制实例 | |
设置录制回调接口 | |
释放资源 | |
设置自定义图像处理回调( 精简版不支持) |
录制效果设置相关函数
API | 描述 |
设置全局水印( 精简版不支持) | |
获取美颜管理对象 |
摄像头,麦克风相关函数
API | 描述 |
启动摄像头预览,简化参数 | |
启动摄像头预览,自定义参数 | |
设置录制分辨率 | |
设置录制比特率 | |
停止摄像头预览 | |
切换前后摄像头 | |
设置麦克风的音量大小 | |
toggleTorch,打开闪关灯 | |
获取摄像头支持的最大焦距,此方法同时可以检查是否支持变焦 | |
设置焦距 | |
设置手动聚焦 | |
设置视频渲染模式 | |
设置 home 键方向 | |
设置渲染方向 | |
setVideoRenderMirrorType(int mirrorType) | (11.0版本增加),设置渲染镜像类型,mirrorType取值: TXRecordCommon.VIDEO_RENDER_MIRROR_TYPE_AUTO(自动模式)前置摄像头是镜像,后置非镜像 TXRecordCommon.VIDEO_RENDER_MIRROR_TYPE_ENABLE(强制开启镜像)无论当前使用的是前置摄像头还是后置摄像头 TXRecordCommon.VIDEO_RENDER_MIRROR_TYPE_DISABLE(强制关闭镜像)不论当前使用的是前置摄像头还是后置摄像头 |
录制相关函数
API | 描述 |
开始视频录制 | |
开始视频录制 | |
停止视频录制 | |
暂停视频录制 | |
继续视频录制 | |
设置宽高比 | |
录制速度( 精简版不支持) | |
设置静音 | |
设置 home 键方向 | |
设置渲染方向 | |
setVideoEncoderMirror(boolean isMirror) | (11.0版本增加)设置视频编码是否镜像,不调用的话,默认为前置摄像头是镜像,后置非镜像。isMirror = true 为镜像编码,false 为非镜像编码 |
背景音相关函数
API | 描述 |
设置混响( 精简版不支持) | |
设置变声( 精简版不支持) | |
设置背景音乐文件( 精简版不支持) | |
设置背景音乐播放回调接口( 精简版不支持) | |
播放背景音乐( 精简版不支持) | |
停止播放背景音乐( 精简版不支持) | |
暂停播放背景音乐( 精简版不支持) | |
继续播放背景音乐( 精简版不支持) | |
定位 BGM 开始结束时间( 精简版不支持) | |
设置背景音乐的音量大小( 精简版不支持) | |
获取音乐文件时长( 精简版不支持) |
截图相关函数
API | 描述 |
设置短视频预处理回调 |
废弃接口
API | 描述 |
setMotionTmpl 设置动效文件( 仅支持企业版和企业版 Pro) | |
设置动效是否静音( 仅支持企业版和企业版 Pro) | |
设置绿幕文件(仅支持企业版 Pro) | |
设置V脸(仅支持企业版 Pro) | |
设置短脸(仅支持企业版 Pro 和企业版 Pro EX) | |
设置下巴长度(仅支持企业版 Pro 和企业版 Pro EX) | |
设置瘦鼻效果(仅支持企业版 Pro 和企业版 Pro EX) | |
设置大眼效果(仅支持企业版 Pro 和企业版 Pro EX) | |
设置瘦脸效果(仅支持企业版 Pro) | |
设置美颜类型 | |
设置美颜和美白效果级别 | |
设置指定素材滤镜特效 | |
设置组合滤镜特效 | |
设置滤镜效果程度 |
TXUGCPartsManager
多段录制相关函数
API | 描述 |
视频片段管理器 | |
设置视频片段处理回调 | |
删除视频片段处理回调 | |
添加视频片段到队列尾部 | |
插入视频片段 | |
获取所有分段的总时长 | |
获取本次录制所有片段的路径 | |
删除最后一段分段 | |
删除指定分段 | |
删除所有分段 |
VideoCustomProcessListener
视频处理自定义监听接口
API | 描述 |
纹理处理回调接口 | |
五官检测点回调 | |
纹理释放回调接口 |
ITXVideoRecordListener
短视频预览回调接口
API | 描述 |
短视频录制事件通知 | |
短视频录制进度 | |
短视频录制完成 |
ITXSnapshotListener
截图回调接口
API | 描述 |
截图回调通知 |
ITXBGMNotify
背景音事件回调接口
API | 描述 |
音乐播放开始的回调通知 | |
音乐播放进度的回调通知 | |
音乐播放结束的回调通知 |
TXRecordCommon
短视频录制关键类型定义
API | 描述 |
录制结果 | |
固定录制参数 | |
自定义录制参数 |
错误码
录制结果回调错误码
符号 | 值 | 含义 |
RECORD_RESULT_OK | 0 | 回调录制成功或者暂停(停止)接口返回成功 |
RECORD_RESULT_OK_LESS_THAN_MINDURATION | 1 | 回调录制成功,时长小于最小值 |
RECORD_RESULT_OK_REACHED_MAXDURATION | 2 | 回调录制成功,时长达到最大值 |
RECORD_RESULT_FAILED | -1 | 回调录制失败 |
RECORD_RESULT_SUSPEND_FOR_NO_TASK | -2 | 暂停(或停止)中止,没有录制的任务 |
RECORD_RESULT_FILE_ERR | -3 | 录制文件不存在或者长度为0,一般开始和暂停(或停止)之间的间隔时间太短导致,用户可不用关心 |
RECORD_RESULT_COMPOSE_SET_SRC_PATH_ERR | -4 | 回调合成的视频路径有误,通过 mTXUGCPartsManager.getPartsPathList() 查看文件是否为空或长度为0 |
RECORD_RESULT_COMPOSE_SET_DST_PATH_ERR | -5 | 回调合成的视频目标路径有误,检查目标路径是否为空 |
RECORD_RESULT_COMPOSE_START_ERR | -6 | 回调合成启动失败,上一次合成还未结束 |
RECORD_RESULT_COMPOSE_CANCEL | -7 | 回调合成取消 |
RECORD_RESULT_COMPOSE_VERIFY_FAIL | -8 | 回调合成校验失败,文件不存在、文件长度为0 或视频参数与其他视频不一致。 |
RECORD_RESULT_COMPOSE_INTERNAL_ERR | -9 | 回调合成失败,内部错误 |
开始录制的返回错误码
符号 | 值 | 含义 |
START_RECORD_OK | 0 | 开始录制 |
START_RECORD_ERR_IS_IN_RECORDING | -1 | 开始录制时存在未完成的任务,existing uncompleted record task |
START_RECORD_ERR_VIDEO_PATH_IS_EMPTY | -2 | 开始录制时视频文件路径为空 |
START_RECORD_ERR_API_IS_LOWER_THAN_18 | -3 | 版本小于18 |
START_RECORD_ERR_NOT_INIT | -4 | 开始录制时还未初始化结束 |
START_RECORD_ERR_LICENCE_VERIFICATION_FAILED | -5 | License 校验失败 |