📸 雨晴截屏

简体中文 | English

"悄然记录，尽收眼底 — Silent Capture, Full Control"

基于特权 shell（Shizuku / Porter 双后端）的 Android 截屏/录屏 APP —— 不经 MediaProjection、无系统弹窗、无状态栏摄像头指示，前台 App 完全无感知被截屏/录屏。支持快捷触发与完全自定义的截屏/录屏参数。

screencap/screenrecord (shell uid 2000, u:r:shell:s0)
        │  不触发 MediaProjection 授权弹窗
        │  不触发「禁止截屏」类提示（FLAG_SECURE 内容仍为黑块）
        │  不触发「屏幕共享中」指示器
        ▼
   RainyScreenShot 独享结果

RainyScreenShot（雨晴截屏）— Silent Screenshot & Screen Recorder · the Rainy Family tools.

---

✨ 功能特性

特性	说明
🤫 静默截屏	shell uid screencap 直取 framebuffer，前台 App 无任何回调与感知、无「禁止截屏」类提示（实测：录屏期间 dumpsys media_projection 始终为 null）；若窗口设了 FLAG_SECURE，其内容在画面中为黑块——系统级内容保护，任何方案均无法绕过
🎬 静默录屏	shell uid screenrecord（v1.4）系统级编码器；开始/停止仅表现为进程 SIGINT，无投屏会话注册、无通知指示
⚡ 快捷触发	三方式：APP 内按钮 · 悬浮控制球（OverlayManager TYPE_APPLICATION_OVERLAY）· 快捷磁贴（TileService，锁屏可用）。磁贴在主页手动添加（一键静默加入任务栏，无需进编辑模式），点击自动收起面板再截/录，不拍到面板
🛠️ 自定义参数	截屏：PNG/RAW、指定 display-id、多显示器 -a。录屏：分辨率 --size、码率 --bit-rate（默认 8M）、时长 --time-limit（0=不限）、bugreport 时间戳叠加、--display-id
🎯 区域截屏	（阶段二）对截取结果做像素裁剪，无需 root
⏺️ 悬浮控制	录屏时显示半透明小控制球，点击即停；可整体隐藏，仅靠磁贴/APP 停止
🌙 深色模式	全局 Material You 自适应
🔌 双后端支持	shell 通道由 Shizuku 或 Porter（Shizuku 的活跃维护 fork）提供；设置页可切换（自动 / Porter / Shizuku），自动模式优先 Porter，切换后需强制停止并重新打开生效
🔐 纯本地	零联网、零权限上报；MediaStore 私有路径产出

---

🔍 隐身原理（实测于 Android 16 / API 36）

本机（shizuku shell uid 2000，u:r:shell:s0）实测结论：

检测维度	MediaProjection 方案	本项目方案（shell 直调）
系统授权弹窗	每次需确认（Android 14+ 默认不可跳过）	✅ 无弹窗
MediaProjectionManager 会话注册	有，App 可通过 dumpsys media_projection / API 感知	✅ 录屏全程实测为 null
状态栏「录屏/投屏」图标	有（Android 14+ 不可隐藏）	✅ 无任何指示
前台 App 感知回调	无直接 API，但存在间接信号（虚拟 Display 创建、麦克风焦点等）	✅ 无回调路径
FLAG_SECURE 内容	显示为黑块	⚠️ 同为黑块（系统级内容保护，shell 路径同样无法绕过）；差异仅在全程无提示、目标 App 无感知

⚠️ 边界如实说明：本方案绕过的是「常规可感知信号」。它不修改目标 App、不注入任何代码；如目标 App 通过 dumpsys 系统级自检（需 READ_LOGS/adb 权限，普通 App 不具备）或对画面内容做数字水印/模糊检测，任何录屏方案都无法保证不可检测；FLAG_SECURE 窗口内容（银行 App、DRM 视频等）在任何捕获路径下均为黑块，属系统级内容保护，同样无法绕过。方案目标 = 「普通 App 的常规检测手段全部失效」，这在实测中已成立。

---

🏗️ 技术架构

┌──────────────────────────────────────────────────┐
│                 Android App                       │
│                                                   │
│  ┌─────────────────────────────────────────────┐ │
│  │        Compose UI                            │ │
│  │  首页(截屏/录屏状态) · 历史记录 · 设置       │ │
│  └────────────────────┬────────────────────────┘ │
│                       │                           │
│  ┌────────────────────▼─────────────────────────┐ │
│  │        RecordingSessionManager（单例）         │ │
│  │  start/stop · 状态机 · 时长统计 · 输出路径     │ │
│  └────────────────────┬────────────────────────┘ │
│                       │                           │
│  ┌────────────────────▼─────────────────────────┐ │
│  │        ShellCapture（核心）                    │ │
│  │  Shizuku shell 会话 · stdout 管道取帧          │ │
│  │  · SIGINT 停止录制 · 轮询/监听进程退出         │ │
│  └────────────────────┬────────────────────────┘ │
│                       │                           │
│  ┌────────────────────▼─────────────────────────┐ │
│  │   触发层：App UI · OverlayManager 悬浮球       │ │
│  │           · TileService 快捷磁贴             │ │
│  └─────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────┘

关键技术决策：

1. shell 直调而非 Shizuku Binder API：screencap/screenrecord 位于 /system/bin，shell uid 具备执行权（实测通过）。通过 Shizuku.newProcess() 建立持久 shell 会话（SDK 由 Porter 兼容层提供，rikka.shizuku.* API 保持兼容，支持 Shizuku / Porter 双后端），输出经 stdout 管道回传，不落公共目录。
2. 录屏停止机制：screenrecord 无 stop 参数，靠向目标进程发 SIGINT 完成容器 moov box 定稿（实测：进程 SIGINT → mp4 正常关闭、可播放）。通过同会话 shell 持有 pid，kill -INT <pid> 停止。
3. 会话保活：Shizuku shell 进程与 APP 进程独立，录屏期间 APP 被杀不影响录制；停止靠悬浮球/磁贴/超时三重兜底。
4. 无前台服务的静音设计：录屏执行体在 shell uid 中，APP 自身不持前台服务、不显示任何通知（Android 14+ 对 FGS 的强制通知因此不适用）。

---

📁 项目结构

RainyScreenShot/
├── app/src/main/java/com/rainy/screenshot/
│   ├── capture/            # 核心
│   │   ├── ShellExecutor.kt       # 特权 shell（Shizuku/Porter）会话管理（stdout/exitcode/pid）
│   │   ├── ScreenshotEngine.kt    # screencap 封装（PNG/RAW/display-id/-a）
│   │   ├── RecordingEngine.kt     # screenrecord 封装（SIGINT 停止/超时兜底）
│   │   └── CaptureConfig.kt       # 截屏/录屏参数模型
│   ├── session/
│   │   └── RecordingSessionManager.kt  # 录制会话状态机 + 时长统计
│   ├── trigger/
│   │   ├── ScreenshotTileService.kt  # 截屏快捷磁贴（点击收面板再截）
│   │   └── RecordTileService.kt      # 录屏快捷磁贴（启停前收面板）
│   ├── overlay/
│   │   ├── FloatingBallService.kt    # 悬浮控制球（OverlayManager）
│   │   └── FloatingBallController.kt # 悬浮球开关控制（Shizuku 静默授权）
│   ├── ui/
│   │   ├── home/          # 首页：状态卡 + 快捷截屏/录屏 + 磁贴管理
│   │   ├── history/       # 结果浏览（私有 MediaStore/应用目录）
│   │   ├── preview/       # 图片/视频预览（FileProvider 分享）
│   │   ├── settings/      # 参数自定义页
│   │   └── theme/         # 雨晴粉主题
│   └── data/
│       └── local/         # DataStore/SharedPreferences 持久化
├── gradle/libs.versions.toml
└── docs/
    └── TECH_NOTES.md      # 实测记录归档（命令行为、退出码、边界）

---

🌐 多语言

内置三语言：简体中文（默认）、繁體中文、English。跟随系统语言自动切换；Android 13+ 还可在系统设置里按应用单独指定（语言 → 雨晴截屏）。

---

🛠️ 构建

# 与 RainyToken 相同的 ARM64 Proot 兼容配置
./gradlew assembleDebug
# APK 输出：app/build/outputs/apk/debug/app-debug.apk

运行前提：设备已激活 Shizuku 或 Porter（ADB 或 Root 方式），并在对应服务中授权本应用。服务后端可在设置页切换（自动 / Porter / Shizuku，需强制停止并重新打开生效）。

---

🐱 关于

RainyScreenShot（雨晴截屏）是「雨晴系列」工具成员，由 雨晴喵 开发维护：

• RainyLLM — 纯离线 Android 本地 LLM 推理服务器
• RainyScanner — 不拦截不跳转的 Android 扫码工具
• Rainy2FA — 纯本地 · 零联网 · 生物识别保护的 TOTP 验证器
• RainyToken — AI 余额与用量查询 APP
• RainyScreenShot — 静默截屏/录屏工具（本项目）

静悄悄地来，静悄悄地录 📷

---

📄 License

MIT License © 2026 Rainy