抖音开放平台Logo
控制台

tt.onUserScreenRecord
收藏
我的收藏

基础库 2.7.0 开始支持本方法，低版本需做兼容处理，这是一个同步方法。

监听用户主动录屏事件，用户使用系统录屏按键录屏时触发此事件，该 API 仅支持在 iOS 上调用。

前提条件无
业务背景无
使用限制
注意事项无
支持沙盒
否
相关教程无

语法

tt.onUserScreenRecord(callback)

参数说明

callback

类型默认值必填说明最低支持版本
function是
获取到录屏事件的回调函数
2.7.0

callback 是一个回调函数，接收类型参数如下：

属性名类型说明最低支持版本
state string

state 为 start，表示开始录屏。state 为 end，表示停止录屏

2.7.0

返回值

无

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

const callback = (res) => {
  if (res.state === "start") {
    // 开始录屏
  } else if (res.state === "stop") {
    // 取消录屏
  }
};
tt.onUserScreenRecord(callback);