小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
位置
开放接口
设备
剪贴板
网络
电话
内存
扫码
屏幕
setVisualEffectOnCapture
getScreenRecordingState
onUserCaptureScreen
offUserCaptureScreen
XHSML
性能
第三方平台
文件
数据分析
画布

xhs.onUserCaptureScreen

开发
>
JS API
>
设备
>
屏幕
>
onUserCaptureScreen
>
更新时间:2025-04-11 19:06:06

以Promise风格调用: 不支持

监听用户主动截屏事件。用户使用系统截屏按键截屏时触发,只能注册一个监听

参数

function callback
用户主动截屏事件的监听函数

参数

属性
类型
说明
typestring事件类型
statusstring事件状态

实例代码

// 监听用户主动截屏事件
xhs.onUserCaptureScreen((res) => {
  console.log('用户主动截屏事件触发:');
  console.log('事件类型:', res.type);
  console.log('事件状态:', res.status);

  // 在此处可以执行相关逻辑,例如记录日志或保护敏感内容
  handleUserCaptureScreen(res);
});

// 示例:处理截屏事件的逻辑
function handleUserCaptureScreen(event) {
  console.log('处理截屏事件:', event);
  // 添加自定义逻辑,例如弹出提示或隐藏敏感内容
}
该文档是否对您有帮助?