screenCapture

概述

苹果录屏

苹果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/05/20