Web Analytics
跳到主要内容

快速开始

一个用于防止应用被截屏和录屏的 React Native 库，具有强大的事件检测能力。

✨ 核心特性​

🛡️ 截屏与录屏防护​

防止应用内的敏感内容被截取或录影，支持 3 种不同的遮罩类型：

  • 纯色遮罩 — 显示纯色（如黑色、白色或自定义十六进制颜色）。
  • 模糊效果 — 应用模糊遮罩以遮盖内容。
  • 自定义图片 — 在截屏时显示您自己的图片、徽标或水印。

📸 截屏检测​

提供实时事件检测，在截获屏幕快照时立即触发：

  • 即时响应 — 在截屏时执行自定义逻辑。
  • 访问截屏元数据 — 获取设备上截获的屏幕快照文件路径，用于您自己的用途。
  • 控制截屏事件 — 限制截屏事件的数量。
  • 追踪状态 — 检查截屏事件发生时 ScreenGuard 是否处于激活状态。

🎥 录屏检测​

实时监控录屏活动。

  • 检测录屏状态 — 了解设备何时开始和结束录屏。
  • 响应录屏尝试 — 在检测到录屏时执行自定义操作。
  • 跨平台支持 — 适用于 iOS 13+ 和 Android 15+ (API 35+)。

📝 活动日志​

为编辑或调试提供全面的日志记录。

工作原理​

React Native ScreenGuard 桥接了原生代码（iOS Objective-C, Android Java）和 JavaScript，在 Android 上使用 FLAG_SECURE，在 iOS 上使用可自定义的 UITextField。

快速入门
  1. 安装库
  2. 使用 initSettings() 初始化设置
  3. 使用 register()、registerWithBlurView() 或 registerWithImage() 激活 ScreenGuard
  4. （可选）使用 useSGScreenShot 或 useSGScreenRecord Hook 监听事件

前置要求​

如果您已经熟悉 JavaScript、React 和 React Native，那么您可以很快上手 React Native Screenguard！如果没有，我们强烈建议您先掌握一些基础知识，然后再回来。

这里有一些资源可以帮助您：

  1. React Native Express (第 1 到 4 部分)
  2. React 核心概念
  3. React Hooks
  4. 原生模块介绍

最低要求​

  • Node.js 版本 15.0 或更高：
    • 安装 Node.js 时，建议勾选所有与依赖项相关的复选框。
  • react-native >= 0.68
  • Android SDK >= 29
  • Cocoapods >= 1.1.4
  • iOS 最低部署目标 >= 13
  • typescript >= 4.0.0