更新记录

1.0.4(2022-09-06)

新增示例

1.0.3(2022-09-02)

新增动态开启禁止截屏功能

1.0.2(2022-09-01)

更新返回值

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 11.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 14

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


ScreenshotPlugin

简介

一个简单又实用的截屏监听插件,返回截屏图片路径,还可动态开启禁止屏幕截屏

Tips:如若返回插件内部操作异常,请检查下参数,凡开启监听处销毁时调用下关闭监听方法
若有问题或需求加VX:Chen-Taurus-0510(请备注uniapp)

引用

// 引用插件
const screenshotModule = uni.requireNativePlugin("Chen-Screenshot")

ListenScreenshot(CACLLBACK)

开启监听截屏事件

CACLLBACK参数说明
参数 类型 说明
success Boolean 操作状态
code Int 状态码(200:操作成功,400:用户操作异常,500:插件内部操作异常)
msg String 返回信息
示例
ListenScreenshot() {
  screenshotModule.ListenScreenshot((result) => {
    uni.showToast({
      title: '开启监听截屏事件:' + JSON.stringify(result),
      icon: "none"
    })
  })
},

ListenScreenshot(CACLLBACK)

停止监听截屏事件

CACLLBACK参数说明
参数 类型 说明
success Boolean 操作状态
code Int 状态码(200:操作成功,400:用户操作异常,500:插件内部操作异常)
msg String 返回信息
示例
onStopListenScreenshot() {
  screenshotModule.onStopListenScreenshot((result) => {
    uni.showToast({
      title: '停止监听截屏事件:' + JSON.stringify(result),
      icon: "none"
    })
  })
},

globalEvent(CACLLBACK)

截屏全局事件

CACLLBACK参数说明
参数 类型 说明
success Boolean 操作状态
data String 图片路径
code Int 状态码(200:操作成功,400:用户操作异常,500:插件内部操作异常)
msg String 返回信息
示例
plus.globalEvent.addEventListener('onScreenshot', (result) => {
  if (result.success) {
    this.imgPath = result.data
    this.show = true
  }
  uni.showToast({
    title: "截屏全局事件:" + JSON.stringify(result),
    icon: "none"
  })
})

onDisableScreenshot(CACLLBACK)

禁止截屏事件(仅安卓)

CACLLBACK参数说明
参数 类型 说明
success Boolean 操作状态
code Int 状态码(200:操作成功,400:用户操作异常,500:插件内部操作异常)
msg String 返回信息
示例
onDisableScreenshot() {
  screenshotModule.onDisableScreenshot((result) => {
    uni.showToast({
      title: '禁止屏幕截图事件:' + JSON.stringify(result),
      icon: "none"
    })
  })
},

onEnableScreenshot(CACLLBACK)

允许屏幕截图事件(仅安卓)

CACLLBACK参数说明
参数 类型 说明
success Boolean 操作状态
code Int 状态码(200:操作成功,400:用户操作异常,500:插件内部操作异常)
msg String 返回信息
示例
onEnableScreenshot() {
  screenshotModule.onEnableScreenshot((result) => {
    uni.showToast({
      title: '允许屏幕截图事件:' + JSON.stringify(result),
      icon: "none"
    })
  })
},

隐私、权限声明

1. 本插件需要申请的系统权限列表:

Android: <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.ACCESS_MEDIA_LOCATION"/> iOS:无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问