抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

GameRecorderManager.start
收藏
我的收藏

基础库 1.4.1 开始支持本方法,这是一个同步方法。

开始录屏。可以通过 onStart 接口监听录屏开始事件。

前提条件
业务背景
使用限制
注意事项
相关教程

语法

GameRecorderManager.start(options)

参数说明

options 类型说明

object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
durationnumber10

录屏的时长,单位 s,必须大于 3s,最大值 300s(5 分钟)。

1.69.0
isMarkOpenbooleantrue

是否添加水印,会在录制出来的视频上添加默认水印,目前不支持自定义水印图案。

1.69.0
locTopnumber0

水印距离屏幕上边界的位置,单位为 dp。

1.69.0
locLeftnumber0

水印距离屏幕左边界的位置,单位为 dp。

1.69.0
frameRatenumber30

设置录屏帧率(仅安卓系统支持),对于性能较差的手机可以调低参数以降低录屏性能消耗。

1.80.0

返回值

错误码

errNoerrMsg说明最低支持版本
20001invalid param
1.4.1
10401activity is null
小游戏框架内部错误,有需要请创建工单咨询
1.4.1
20000param:recordable illegal
1.4.1
21103record is start
1.4.1
21104record not ready
小游戏框架内部错误,有需要请创建工单咨询
1.4.1
10208no permission to record screen
1.4.1
21102video file path illegal
1.4.1
10402App can not call recorder
小游戏框架内部错误,有需要请创建工单咨询
1.4.1
20000param:recordable is false
1.4.1
21000failed to start recorder
小游戏框架内部错误,有需要请创建工单咨询
1.4.1

代码示例

tt.getSystemInfo({ success(res) { const screenWidth = res.screenWidth; const screenHeight = res.screenHeight; const recorder = tt.getGameRecorderManager(); var maskInfo = recorder.getMark(); var x = (screenWidth - maskInfo.markWidth) / 2; var y = (screenHeight - maskInfo.markHeight) / 2; recorder.onStart((res) => { console.log("录屏开始"); // do something; }); //添加水印并且居中处理 recorder.start({ duration: 30, isMarkOpen: true, locLeft: x, locTop: y, }); }, });