screenCapture

isCaptured addCaptureListener removeCaptureListener

概述

苹果录屏

苹果iOS系统自带录屏功能，可在设置->控制中心添加屏幕录制，然后从屏幕底部往上划出的菜单里就能看见开始屏幕录制的按钮。

录屏事件监听

iOS 11 （于2017年9月20日发布正式版）开始支持监听用户屏幕录像的事件。

插件概述

本插件封装了苹果录屏事件相关功能。涉及付费视频课程相关的功能时，可以用本插件监听相关事件，从而禁止用户录屏。

录屏分为两种情况：

1、用户先开启录屏，然后打开 App。此时可以用 isCaptured 接口判断当前是否正在录屏。

2、用户先打开 App，然后开始录屏。此时可以用 addCaptureListener 接口监听录屏事件，然后再在事件回调里用 isCaptured 接口判断用户是开启录屏还是关闭录屏。

注意：本功能只支持在 iOS 11.0 及以上版本的设备

插件接口

isCaptured

是否正在录屏

isCaptured(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    captured: true      //布尔型；true||false，是否在录屏
}

示例代码

var screenCapture = api.require('screenCapture');
screenCapture.isCaptured(function(ret) {
      api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS 系统

可提供的 1.0.0 及更高版本

addCaptureListener

监听录屏状态改变事件

addCaptureListener({params},callback(ret))

params

user：

  • 类型：字符串
  • 描述：用户ID

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段： 无，仅返回屏录录象状态改变事件

示例代码

var screenCapture = api.require('screenCapture');
screenCapture.addCaptureListener(function(ret) {
    api.alert({msg:'录屏改变了'});
});

可用性

iOS 系统

可提供的 1.0.0 及更高版本

removeCaptureListener

移除监听

removeCaptureListener()

示例代码

var screenCapture = api.require('screenCapture');
screenCapture.removeCaptureListener();

可用性

iOS 系统

可提供的 1.0.0 及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18