开始录制视频

业务场景

抖音渠道强制要求接入录屏功能。

调用该接口,游戏内开始录制视频。

注意事项

该功能只能录制到小游戏全局唯一的上屏 canvas 上的内容,即开发者逻辑所绘制的内容。其他的包括客服按钮,任何类型的广告,以及 showToast 等 API 展示的 native 内容,都无法被录制到。

流程图

接口介绍

SDKManager.recorderStart(Object params)

调用示例

var params = {
  duration: 15,
  onRecorderStartSuccess: () => {
    // 录制开始成功
  },
  onRecorderStartFailed: (errorInfo) => {
    // 录制开始失败
  },
  onRecorderStopSuccess: (recordInfo) => {
    // 录制停止,录制结果返回
  },
  onRecorderStopFailed: (errorInfo) => {
    // 录制停止失败
  },
};
// 开始录屏
SDKManager.recorderStart(params);
// 停止录屏
SDKManager.recorderStop();

参数说明

入参 params

参数名称类型说明备注
durationint录屏的时长,单位秒,必须大于 3s,最大值 300s ,默认 15s可选

出参 recordInfo

参数名称类型说明
videoPathstring录制视频的临时地址
timeint录制时间,单位:秒

错误码

FAQ

Q:录屏时长限制为 3s 到 300s 吗?

A:是的,限制在 3s 到 300s 之间。

Q:录屏时长的单位是秒吗?

A:是的,单位是秒。

Q:录制视频的临时地址是什么?

A:录制视频的临时地址需要保存起来, 下次调用分享视频需要带上这个地址。