TAVRecorder
录制能力入口,通过
TAVMagicFactory.createRecorder() 创建。API | 描述 |
初始化录制器与预览容器。 | |
开始预览。 | |
停止预览。 | |
页面恢复时调用。 | |
页面暂停时调用。 | |
销毁录制器,释放相机与渲染资源。 | |
开始录制,可指定录制速度。 | |
停止录制。 | |
当前是否正在录制。 | |
删除最后一段录制。 | |
清空全部录制片段。 | |
获取已录制的片段列表。 | |
获取当前预览画面快照。 | |
设置录制过程监听。 | |
设置采集/编码分辨率回调。 | |
获取相机管理接口。 | |
获取特效管理接口。 | |
获取背景音乐管理接口。 |
prepare
描述
初始化录制器:创建采集与渲染链路并把预览画面绑定到指定容器。必须在其它录制接口之前调用。
接口
TAVRecorderConstants.TAVPrepareResult prepare(Context context, FrameLayout container, TAVRecorderConfig config)参数
参数名 | 类型 | 说明 |
context | Context | 上下文。 |
container | FrameLayout | 预览容器,SDK 在其中创建渲染视图。 |
config | TAVRecorderConfig |
返回值
说明:
SUCCESS 初始化成功;NO_AUTHORIZED 为 License 鉴权失败(未授权或授权文件无效),与相机、麦克风运行时权限无关。startPreview
描述
开始预览。
prepare 成功后可调用。接口
void startPreview()参数
无。
返回值
类型:
void说明:无返回值。
stopPreview
描述
停止预览。
接口
void stopPreview()参数
无。
返回值
类型:
void说明:无返回值。
onResume
描述
宿主页面
onResume 时调用,用于恢复预览与采集。接口
void onResume()参数
无。
返回值
类型:
void说明:无返回值。
onPause
描述
宿主页面
onPause 时调用,用于暂停采集。接口
void onPause()参数
无。
返回值
类型:
void说明:无返回值。
onDestroy
描述
销毁录制器,释放相机、编码与渲染资源。调用后实例不可再用。
接口
void onDestroy()参数
无。
返回值
类型:
void说明:无返回值。
startRecord
描述
接口
void startRecord(boolean enableMic, float speed)参数
参数名 | 类型 | 说明 |
enableMic | boolean | 是否录入麦克风声音。 |
speed | float | 录制速度倍率, 1.0f 为正常速度。 |
返回值
类型:
void说明:无返回值,过程与结果通过
TAVRecordListener 回调。stopRecord
描述
停止当前录制。
接口
void stopRecord()参数
无。
返回值
类型:
void说明:结果通过
TAVRecordListener.onStopRecord(TAVRecorderResult) 返回。isRecording
描述
判断当前是否正在录制。
接口
boolean isRecording()参数
无。
返回值
类型:
boolean说明:
true 表示录制中。deleteLastSegment
描述
删除最后一段录制,用于“重录上一段”。
接口
void deleteLastSegment()参数
无。
返回值
类型:
void说明:无返回值。
clearAll
描述
清空全部录制片段。
接口
void clearAll()参数
无。
返回值
类型:
void说明:无返回值。
getSegments
描述
获取已录制的片段列表。
接口
List<TAVRecordSegment> getSegments()参数
无。
返回值
说明:按录制顺序排列,字段见
TAVRecordSegment。返回的是 SDK 内部列表引用,请只读使用;片段在 stopRecord() 回调后写入,与是否注册 TAVRecordListener 无关。snapshot
描述
获取当前预览画面的快照。
接口
void snapshot(TAVSnapshotListener listener)参数
参数名 | 类型 | 说明 |
listener | TAVSnapshotListener | 快照结果回调。 |
返回值
类型:
void说明:无返回值。
setRecordListener
描述
设置录制过程监听器。
接口
void setRecordListener(TAVRecordListener listener)参数
参数名 | 类型 | 说明 |
listener | TAVRecordListener |
返回值
类型:
void说明:无返回值。
setResolutionListener
描述
设置分辨率回调:采集侧解析结果与编码侧最终输出尺寸。
接口
void setResolutionListener(TAVRecorderResolutionListener listener)参数
参数名 | 类型 | 说明 |
listener | TAVRecorderResolutionListener | 含 onCaptureResolutionResolved(TAVCaptureResolutionResult) 与 onEncoderResolutionResolved(TAVEncoderResolutionResult)。 |
返回值
类型:
void说明:无返回值。
getCameraManager
描述
获取相机管理接口,用于切换摄像头、变焦、对焦、闪光灯、镜像等。
接口
ITAVCameraManager getCameraManager()参数
无。
返回值
说明:返回对应的 ITAVCameraManager,见本篇相关接口。
getEffectManager
描述
获取特效管理接口,用于美颜/滤镜/特效与合拍素材控制。
接口
ITAVEffectManager getEffectManager()参数
无。
返回值
说明:返回对应的 ITAVEffectManager,见本篇相关接口。
getBGMManager
描述
获取背景音乐管理接口。
接口
ITAVBGMManager getBGMManager()参数
无。
返回值
类型:
ITAVBGMManager说明:返回对应的 ITAVBGMManager,见本篇相关接口。
TAVRecorderConfig
录制配置(
TAVRecorderConfig),使用 Builder 构建。构造
TAVRecorderConfig config = new TAVRecorderConfig.Builder().setResolution(TAVRecorderConstants.TAVResolution.RESOLUTION_720).setAspectRatio(TAVRecorderConstants.TAVAspectRatio.RATIO_16_9).setFps(30).setVideoBitRate(bitRate).setResolutionFallbackStrategy(TAVRecorderConstants.TAVResolutionFallbackStrategy.ALLOW_LOWER_OUTPUT_RESOLUTION).setDefaultCameraId(TAVRecorderConstants.TAVCameraId.BACK).build();
字段
字段 | 类型 | 说明 |
cameraId | 默认摄像头。 | |
resolution | 目标分辨率等级(只读,由 Builder 指定)。 | |
effectiveResolutionShortSide | int | 实际生效的分辨率短边像素。 |
videoBitRate | int | 视频码率(只读)。 |
resolutionFallbackStrategy | 分辨率不可用时的降级策略(只读)。 | |
fps | int | 帧率(只读)。 |
aspectRatio | 预览/录制画幅比例。 |
Builder 方法
API | 描述 |
设置目标分辨率等级。 | |
设置预览及录制帧率。 | |
设置视频码率。 | |
设置编码分辨率不可用时的回退策略,传 null 抛出 IllegalArgumentException。 | |
设置预览及后续录制的画幅比例,录制中调用会被忽略。 | |
设置默认摄像头。 | |
创建录制配置对象。 |
setResolution
描述
设置目标分辨率等级。
接口
public Builder setResolution(TAVRecorderConstants.TAVResolution resolution)参数
参数名 | 类型 | 说明 |
resolution | TAVRecorderConstants.TAVResolution | 目标分辨率等级,默认 RESOLUTION_720。 |
返回值
说明:当前 Builder,可继续链式调用。
setFps
描述
设置预览及录制帧率。
接口
public Builder setFps(int fps)参数
参数名 | 类型 | 说明 |
fps | int | 帧率,单位帧/秒,默认 30。 |
返回值
说明:当前 Builder,可继续链式调用。
setVideoBitRate
描述
设置视频码率。0 为自动配置;负数抛出 IllegalArgumentException,正数不自动钳制。
接口
public Builder setVideoBitRate(int videoBitRate)参数
参数名 | 类型 | 说明 |
videoBitRate | int | 视频码率,单位 bps;0 为自动配置,默认 0。 |
返回值
说明:当前 Builder,可继续链式调用。
setResolutionFallbackStrategy
描述
设置编码分辨率不可用时的回退策略,传 null 抛出 IllegalArgumentException。
接口
public Builder setResolutionFallbackStrategy(TAVRecorderConstants.TAVResolutionFallbackStrategy strategy)参数
参数名 | 类型 | 说明 |
strategy | TAVRecorderConstants.TAVResolutionFallbackStrategy | 分辨率回退策略,默认 ALLOW_LOWER_OUTPUT_RESOLUTION。 |
返回值
说明:当前 Builder,可继续链式调用。
setAspectRatio
描述
设置初始预览和录制的画幅比例。
接口
public Builder setAspectRatio(TAVRecorderConstants.TAVAspectRatio aspectRatio)参数
参数名 | 类型 | 说明 |
aspectRatio | TAVRecorderConstants.TAVAspectRatio | 预览及录制画幅比例,默认 RATIO_16_9。 |
返回值
说明:当前 Builder,可继续链式调用。
setDefaultCameraId
描述
设置默认摄像头。
接口
public Builder setDefaultCameraId(TAVRecorderConstants.TAVCameraId cameraId)参数
参数名 | 类型 | 说明 |
cameraId | TAVRecorderConstants.TAVCameraId | 默认摄像头,默认 FRONT。 |
返回值
说明:当前 Builder,可继续链式调用。
build
描述
创建录制配置对象。
接口
public TAVRecorderConfig build()参数
无。
返回值
说明:新建的 TAVRecorderConfig。
TAVRecorderConstants
录制相关常量与枚举(
TAVRecorderConstants)。TAVCameraId
枚举值 | 值 | 说明 |
FRONT | 0 | 前置摄像头。 |
BACK | 1 | 后置摄像头。 |
TAVAspectRatio
枚举值 | 说明 |
RATIO_16_9 | 16:9。 |
RATIO_4_3 | 4:3。 |
RATIO_1_1 | 1:1。 |
TAVResolution
枚举值 | 短边 | 说明 |
RESOLUTION_480 | 480 | 标清 480p。 |
RESOLUTION_540 | 540 | 540p。 |
RESOLUTION_720 | 720 | 高清 720p。 |
RESOLUTION_1080 | 1080 | 全高清 1080p。 |
TAVResolutionFallbackStrategy
枚举值 | 说明 |
FAIL_IF_UNSUPPORTED | 编码器不支持当前有效输出分辨率时拒绝开始录制。 |
ALLOW_LOWER_OUTPUT_RESOLUTION | 依次尝试更低标准分辨率,并回调最终输出尺寸。 |
TAVPrepareResult
枚举值 | 说明 |
SUCCESS | 初始化成功,可正常录制。 |
NO_AUTHORIZED | License 鉴权失败(未授权或授权无效),与运行时权限无关。 |
TAVDuetMode
合拍模式枚举,配合
ITAVEffectManager.setDuetMode 使用。TAVRecordSegment
录制片段模型(
TAVRecordSegment,实现 Parcelable)。字段 | 类型 | 说明 |
path | String | 片段文件路径。 |
duration | long | 片段时长。 |
speed | float | 录制速度倍率,默认 1f。 |
bgmPath | String | 该片段使用的背景音乐路径。 |
bgmStartPosition | long | 背景音乐起始位置。 |
TAVRecorderResult
录制结束结果(
TAVRecorderResult)。字段 | 类型 | 说明 |
outputPath | String | 输出文件路径。 |
code | 结果码。 | |
message | String | 结果描述。 |
stage | 结果所处阶段,默认 UNKNOWN。 |
TAVRecordResultCode
枚举值 | 说明 |
SUCCESS | 成功。 |
UNKNOWN | 未知错误。 |
VIDEO_PATH_ERROR | 视频文件路径异常。 |
ENCODE_PREPARE_ERROR | 编码器准备失败。 |
ENCODE_FRAME_FAILED | 编码帧失败。 |
说明:
其余错误码与录制/编码链路一一对应,可在
TAVRecordResultCode 中查看完整定义。TAVRecordResultStage
枚举值 | 说明 |
UNKNOWN | 未知阶段,默认值。 |
START_REJECTED | 启动阶段被拒绝(如分辨率不支持)。 |
RECORDING_FAILED | 录制过程中失败。 |
COMPLETED | 正常完成。 |
TAVRecordListener
录制过程监听(
TAVRecordListener)。API | 描述 |
通知一段录制开始。 | |
通知录制进度。 | |
通知本段录制请求结束,需结合结果的 code 和 stage 判断成功、失败或开始前被拒绝。 |
onRecordStart
描述
通知一段录制开始。
接口
void onRecordStart()参数
无。
返回值
类型:
void说明:无返回值。
onRecording
描述
通知录制进度。
接口
void onRecording(long timeStamp)参数
参数名 | 类型 | 说明 |
timeStamp | long | 当前录制进度,单位微秒,不是系统时间。 |
返回值
类型:
void说明:无返回值。
onStopRecord
描述
通知本段录制请求结束,需结合结果的 code 和 stage 判断成功、失败或开始前被拒绝。
接口
void onStopRecord(TAVRecorderResult ret)参数
参数名 | 类型 | 说明 |
ret | TAVRecorderResult | 本段录制结果,含成功、失败或开始前被拒绝的状态。 |
返回值
类型:
void说明:无返回值。
TAVRecorderResolutionListener
分辨率回调(
TAVRecorderResolutionListener)。API | 描述 |
通知采集侧分辨率解析结果。 | |
通知编码侧最终输出分辨率。 |
onCaptureResolutionResolved
描述
通知采集侧分辨率解析结果。
接口
void onCaptureResolutionResolved(TAVCaptureResolutionResult result)参数
参数名 | 类型 | 说明 |
result | TAVCaptureResolutionResult | 回调结果对象,字段见对应模型章节。 |
返回值
类型:
void说明:无返回值。
onEncoderResolutionResolved
描述
通知编码侧最终输出分辨率。
接口
void onEncoderResolutionResolved(TAVEncoderResolutionResult result)参数
参数名 | 类型 | 说明 |
result | TAVEncoderResolutionResult | 编码侧最终输出结果,含请求/实际输出宽高与编码策略;`isSupported()` 为 `false` 表示编码方案被拒绝。 |
返回值
类型:
void说明:无返回值。
TAVCaptureResolutionResult
采集分辨率解析结果(
TAVCaptureResolutionResult,字段全部只读)。字段 | 类型 | 说明 |
cameraId | 摄像头。 | |
requestedOutputWidth / requestedOutputHeight | int | 请求的输出宽高。 |
effectiveCaptureWidth / effectiveCaptureHeight | int | 实际采集宽高。 |
cameraSourceWidth / cameraSourceHeight | int | 相机原始宽高。 |
effectiveCaptureShortSide | int | 实际采集短边。 |
action | TAVRecorderConstants.TAVCaptureResolutionAction | 采集侧采取的动作。 |
TAVCameraStateListener
API | 描述 |
通知相机预览开始。 | |
通知相机预览停止。 | |
通知对焦结果。 | |
通知相机异常。 | |
通知带阶段信息的相机错误。 |
onStartPreview
描述
通知相机预览开始。
接口
void onStartPreview()参数
无。
返回值
类型:
void说明:无返回值。
onStopPreview
描述
通知相机预览停止。
接口
void onStopPreview()参数
无。
返回值
类型:
void说明:无返回值。
onFocused
描述
通知对焦结果。
接口
void onFocused(boolean success)参数
参数名 | 类型 | 说明 |
success | boolean | true 成功,false 失败。 |
返回值
类型:
void说明:无返回值。
onError
描述
通知相机异常。
接口
void onError(int errorCode, String msg)参数
参数名 | 类型 | 说明 |
errorCode | int | 错误码。 |
msg | String | 错误描述。 |
返回值
类型:
void说明:无返回值。
onCameraError
描述
通知带阶段信息的相机错误。默认实现转发到 onError,兼容已有监听器。
接口
default void onCameraError(TAVCameraStartupStage stage, int errorCode, String msg)参数
参数名 | 类型 | 说明 |
stage | TAVCameraStartupStage | 错误发生阶段。 |
errorCode | int | 错误码。 |
msg | String | 错误描述。 |
返回值
类型:
void说明:无返回值。
ITAVCameraManager
相机管理接口(
ITAVCameraManager),由 TAVRecorder.getCameraManager() 获取。API | 描述 |
切换前后摄像头。 | |
获取可用摄像头数量。 | |
设置变焦倍率。 | |
获取最大变焦倍率。 | |
获取当前生效的变焦倍率。 | |
设置触摸对焦位置。 | |
开启或关闭闪光灯。 | |
查询当前摄像头是否支持闪光灯。 | |
设置预览镜像。 | |
设置预览及后续录制的画幅比例,录制中调用会被忽略。 | |
调整预览画面的曝光补偿。 | |
设置相机状态监听器。 |
switchCamera
描述
切换前后摄像头。
接口
void switchCamera()参数
无。
返回值
类型:
void说明:无返回值。
getCameraCount
描述
获取可用摄像头数量。
接口
int getCameraCount()参数
无。
返回值
类型:
int说明:可用摄像头数量。
setZoomRatio
描述
设置变焦倍率。相机未就绪时先缓存,预览开始后生效;倍率限制在 1.0 至最大倍率之间。
接口
void setZoomRatio(float ratio)参数
参数名 | 类型 | 说明 |
ratio | float | 变焦倍率,1.0f 表示不变焦。 |
返回值
类型:
void说明:无返回值。
getMaxZoomRatio
描述
获取最大变焦倍率。相机未就绪时返回 1.0f,建议在预览开始后读取。
接口
float getMaxZoomRatio()参数
无。
返回值
类型:
float说明:最大倍率,相机未就绪时为 1.0f。
getCurrentZoomRatio
描述
获取当前生效的变焦倍率。
接口
float getCurrentZoomRatio()参数
无。
返回值
类型:
float说明:当前倍率,1.0f 表示不变焦。
setFocusPoint
描述
设置触摸对焦位置。
接口
void setFocusPoint(float x, float y)参数
参数名 | 类型 | 说明 |
x | float | 对焦点在屏幕坐标系中的横坐标。 |
y | float | 对焦点在屏幕坐标系中的纵坐标。 |
返回值
类型:
void说明:无返回值。
switchFlash
描述
开启或关闭闪光灯。
接口
void switchFlash(boolean on)参数
参数名 | 类型 | 说明 |
on | boolean | true 开启闪光灯,false 关闭。 |
返回值
类型:
void说明:无返回值。
isSupportFlash
描述
查询当前摄像头是否支持闪光灯。
接口
boolean isSupportFlash()参数
无。
返回值
类型:
boolean说明:true 支持,false 不支持。
setMirror
描述
设置预览镜像。
接口
void setMirror(boolean mirror)参数
参数名 | 类型 | 说明 |
mirror | boolean | 是否镜像。 |
返回值
类型:
void说明:无返回值。
setAspectRatio
描述
设置预览及后续录制的画幅比例,录制中调用会被忽略。
接口
void setAspectRatio(TAVRecorderConstants.TAVAspectRatio ratio)参数
参数名 | 类型 | 说明 |
ratio | TAVRecorderConstants.TAVAspectRatio | 预览及录制的画幅比例。 |
返回值
类型:
void说明:无返回值。
setExposureCompensation
描述
调整预览画面的曝光补偿。
接口
void setExposureCompensation(float value)参数
参数名 | 类型 | 说明 |
value | float | 曝光补偿,范围 -1.0 至 1.0;0 为默认值。 |
返回值
类型:
void说明:无返回值。
setCameraStateListener
描述
设置相机状态监听器。
接口
void setCameraStateListener(TAVCameraStateListener listener)参数
参数名 | 类型 | 说明 |
listener | TAVCameraStateListener | 对应的监听器。 |
返回值
类型:
void说明:无返回值。
ITAVEffectManager
特效管理接口(
ITAVEffectManager),由 TAVRecorder.getEffectManager() 获取。API | 描述 |
设置美颜、滤镜或特效参数。 | |
设置特效提示监听器,传 null 移除监听。 | |
设置合拍素材;路径为空时清除素材,但保留当前合拍模式。 | |
设置合拍素材;路径为空时清除素材,但保留当前合拍模式。 | |
从当前位置继续播放合拍视频,仅控制预览播放状态。 | |
暂停合拍视频并保留当前位置。 | |
切换合拍布局,重置已有自定义变换;NONE 取消合拍。 | |
跳转合拍素材的播放位置,变速时仍传入素材视角的时间。 | |
更新活跃合拍实体的变换:SEGMENT_OVERLAY 对应相机人像,OVERLAY 和 GRID 对应素材。 | |
获取当前活跃合拍实体的变换矩阵。 | |
计算活跃合拍实体在指定 View 中的四个顶点。 | |
获取等比缩放后去除黑边的画布显示区域。 |
setEffect
描述
设置美颜、滤镜或特效参数。
接口
boolean setEffect(String effectName, int effectValue, String resourcePath, Map<String, String> extraInfo)参数
参数名 | 类型 | 说明 |
effectName | String | 特效名称,由素材配置定义。 |
effectValue | int | 特效参数值,范围由具体特效决定。 |
resourcePath | String | 特效资源绝对路径,无需资源时传 null 或空字符串。 |
extraInfo | Map<String, String> | 扩展参数,无需时传 null。 |
返回值
类型:
boolean说明:true 表示请求已受理,渲染线程未就绪时先入队;false 表示引擎不可用或下发失败。
setTipsListener
描述
设置特效提示监听器,传 null 移除监听。
接口
void setTipsListener(TAVEffectTipsListener listener)参数
参数名 | 类型 | 说明 |
listener | TAVEffectTipsListener | 对应的监听器。 |
返回值
类型:
void说明:无返回值。
setDuetMedia
描述
设置合拍素材;路径为空时清除素材,但保留当前合拍模式。
接口
TAVVideoInfo setDuetMedia(String path, TAVMediaType type, boolean isAutoPlay)参数
参数名 | 类型 | 说明 |
path | String | 素材文件的本地路径。 |
type | TAVMediaType | 素材类型,视频或图片。 |
isAutoPlay | boolean | 是否自动播放合拍视频。 |
返回值
类型:
TAVVideoInfo说明:合拍素材的媒体信息。
setDuetMedia(带就绪回调)
描述
设置合拍素材;路径为空时清除素材,但保留当前合拍模式。回调表示素材参数及默认布局已设置,不表示已经上屏;回调在主线程,应及时返回。
接口
TAVVideoInfo setDuetMedia(String path, TAVMediaType type, boolean isAutoPlay, TAVDuetMediaReadyListener listener)参数
参数名 | 类型 | 说明 |
path | String | 素材文件的本地路径。 |
type | TAVMediaType | 素材类型,视频或图片。 |
isAutoPlay | boolean | 是否自动播放合拍视频。 |
listener | TAVDuetMediaReadyListener | 素材及默认布局就绪回调,可为 null。 |
返回值
类型:
TAVVideoInfo说明:合拍素材的媒体信息。
playDuetMedia
描述
从当前位置继续播放合拍视频,仅控制预览播放状态。
接口
void playDuetMedia()参数
无。
返回值
类型:
void说明:无返回值。
pauseDuetMedia
描述
暂停合拍视频并保留当前位置。
接口
void pauseDuetMedia()参数
无。
返回值
类型:
void说明:无返回值。
setDuetMode
描述
切换合拍布局,重置已有自定义变换;NONE 取消合拍。
接口
void setDuetMode(TAVRecorderConstants.TAVDuetMode mode, TAVRecorderConstants.TAVGridQuad gridQuad)参数
参数名 | 类型 | 说明 |
mode | TAVRecorderConstants.TAVDuetMode | 合拍模式:NONE 关闭合拍、恢复普通录制;SEGMENT_OVERLAY 人像分割后叠在素材上方;OVERLAY 素材以画中画叠在人像画面上;GRID 左右或上下分屏。 |
gridQuad | TAVRecorderConstants.TAVGridQuad | GRID 模式下人像画面所在方位:TOP / BOTTOM / LEFT / RIGHT;UNDEFINED 为默认值,其它模式忽略。 |
返回值
类型:
void说明:无返回值。
seekDuetMedia
描述
跳转合拍素材的播放位置,变速时仍传入素材视角的时间。
接口
void seekDuetMedia(long positionUs)参数
参数名 | 类型 | 说明 |
positionUs | long | 目标时间,单位微秒。 |
返回值
类型:
void说明:无返回值。
setActiveDuetTransform
描述
更新活跃合拍实体的变换:SEGMENT_OVERLAY 对应相机人像,OVERLAY 和 GRID 对应素材。
接口
void setActiveDuetTransform(Matrix matrix)参数
参数名 | 类型 | 说明 |
matrix | Matrix | 当前活跃合拍实体的缩放、旋转、平移矩阵。 |
返回值
类型:
void说明:无返回值。
getActiveDuetTransformMatrix
描述
获取当前活跃合拍实体的变换矩阵。
接口
Matrix getActiveDuetTransformMatrix()参数
无。
返回值
类型:
Matrix说明:活跃实体的变换矩阵,未设置时为 null。
computeActiveViewVertices
描述
计算活跃合拍实体在指定 View 中的四个顶点。
接口
PointF[] computeActiveViewVertices(Rect viewRect)参数
参数名 | 类型 | 说明 |
viewRect | Rect | View 相对于相机视图的矩形区域。 |
返回值
类型:
PointF[]说明:顶点顺序为左上、右上、右下、左下;失败返回空数组。
getCanvasRenderRect
描述
获取等比缩放后去除黑边的画布显示区域。
接口
RectF getCanvasRenderRect(int viewWidth, int viewHeight)参数
参数名 | 类型 | 说明 |
viewWidth | int | View 宽度,单位像素。 |
viewHeight | int | View 高度,单位像素。 |
返回值
类型:
RectF说明:View 坐标系中的内容区域,失败返回 null。
ITAVBGMManager
背景音乐管理接口(
ITAVBGMManager),由 TAVRecorder.getBGMManager() 获取。setBGM
描述
设置背景音乐。建议初始速度传 1.0f;开始录制后 SDK 按录制速度设置音乐速度。
接口
void setBGM(String path, float speed)参数
参数名 | 类型 | 说明 |
path | String | 素材文件的本地路径。 |
speed | float | 速度倍率,1.0f 为正常速度。 |
返回值
类型:
void说明:无返回值。
seekTo
描述
跳转背景音乐的播放位置。
接口
void seekTo(long position)参数
参数名 | 类型 | 说明 |
position | long | 目标时间,单位微秒。 |
返回值
类型:
void说明:无返回值。
setLoop
描述
设置背景音乐是否循环播放。
接口
void setLoop(boolean loop)参数
参数名 | 类型 | 说明 |
loop | boolean | 是否循环播放。 |
返回值
类型:
void说明:无返回值。
setVolume
描述
设置背景音乐音量。
接口
void setVolume(float volume)参数
参数名 | 类型 | 说明 |
volume | float | 音量系数。 |
返回值
类型:
void说明:无返回值。
clearBGM
描述
清除背景音乐。
接口
void clearBGM()参数
无。
返回值
类型:
void说明:无返回值。