Intent API 总览与密钥启用
什么是 OwnDroid API
OwnDroid 提供一套基于 Android Intent 广播的 API——外部应用、ADB shell 脚本、Tasker/Automate 等自动化工具都可以通过发送 Intent 广播来触发 OwnDroid 的各种管控操作，不需要打开 OwnDroid 界面。
这让 OwnDroid 能被集成到更大的自动化体系里——比如 Tasker 每天晚上自动挂起游戏 App、Automate 在特定地点自动禁用摄像头、ADB 脚本批量隐藏预装 App。
启用步骤
- 打开 OwnDroid → 设置
- 找到「API」区域
- 生成或输入一个 API Key（推荐用随机生成的长字符串）
- 打开 API 开关
密钥就是安全边界——拥有密钥的一方可以远程触发 OwnDroid 的所有 API 操作，包括清除应用数据、静默安装 APK、禁用摄像头……等于拿到了设备控制权。密钥保管要点：
- 不要写入公开的配置文件或代码仓库
- 不要通过非加密的传输方式分享
- 定期轮换
- 如果怀疑泄漏立即在 OwnDroid 里修改密钥
API 操作列表
括号里的数字是最低 Android 版本要求（没有表示所有版本）：
| API | 功能 | 参数 |
|---|---|---|
| HIDE | 隐藏应用 | package |
| UNHIDE | 恢复应用隐藏 | package |
| SUSPEND (7) | 挂起应用 | package |
| UNSUSPEND (7) | 恢复挂起 | package |
| DISABLE_METERED_DATA (9) | 禁用计量数据 | package |
| ENABLE_METERED_DATA (9) | 恢复计量数据 | package |
| DISABLE_USER_CONTROL (11) | 禁用用户控制 | package |
| ENABLE_USER_CONTROL (11) | 恢复用户控制 | package |
| BLOCK_UNINSTALL | 阻止卸载 | package |
| UNBLOCK_UNINSTALL | 恢复卸载 | package |
| CLEAR_APP_STORAGE (9) | 清除应用存储 | package |
| ADD_USER_RESTRICTION | 开启用户限制 | restriction 键名 |
| CLEAR_USER_RESTRICTION | 清除用户限制 | restriction 键名 |
| SET_PERMISSION_DEFAULT (6) | 设置权限默认值 | package, permission |
| SET_PERMISSION_GRANTED (6) | 授予权限 | package, permission |
| SET_PERMISSION_DENIED (6) | 拒绝权限 | package, permission |
| SET_SCREEN_CAPTURE_DISABLED | 禁止截屏录屏 | 无 |
| SET_SCREEN_CAPTURE_ENABLED | 允许截屏录屏 | 无 |
| SET_CAMERA_DISABLED | 禁用摄像头 | 无 |
| SET_CAMERA_ENABLED | 允许摄像头 | 无 |
| SET_USB_DISABLED (12) | 禁用 USB 信号 | 无 |
| SET_USB_ENABLED (12) | 允许 USB 信号 | 无 |
| LOCK | 设备锁屏 | 无 |
| REBOOT (7) | 设备重启 | 无 |
Intent 常量
所有 API 的 Action 前缀为 com.bintianqi.owndroid.action.，Receiver 为 com.bintianqi.owndroid/.ApiReceiver。
请求必须包含一个 key extra（API Key），以及对应操作的参数 extras（如 package、permission、restriction）。