有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

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
描述
开始视频录制,SDK 内部会自动生成视频路径和视频封面,在 ITXVideoRecordListener 里面返回
开始视频录制
开始视频录制
停止视频录制
暂停视频录制
继续视频录制
设置宽高比
录制速度( 精简版不支持)
设置静音
设置 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 校验失败