锁机客户端 — 原子能力
装在客户分期手机上的客户端模块，暴露标准化的原子 API，不包含任何策略逻辑。
能力分类
水印控制
| API | 说明 | 参数 |
|---|---|---|
showWatermark(text, color, position) | 显示屏幕水印 | text: 文案; color: 颜色; position: 位置 |
hideWatermark() | 隐藏水印 | — |
锁屏控制
| API | 说明 | 参数 |
|---|---|---|
showLockScreen(repaymentUrl) | 全屏锁定，仅显示还款页面 | repaymentUrl: 还款页地址 |
hideLockScreen() | 解除全屏锁定 | — |
电话管控
| API | 说明 | 参数 |
|---|---|---|
blockOutgoingCalls() | 限制电话呼出 | — |
blockIncomingCalls() | 限制电话呼入 | — |
allowOutgoingCalls() | 恢复电话呼出 | — |
allowIncomingCalls() | 恢复电话呼入 | — |
setPhoneWhitelist(numbers[]) | 设置电话白名单，白名单号码不受限制 | numbers: 号码数组 |
短信管控
| API | 说明 | 参数 |
|---|---|---|
blockSms() | 限制短信发送 | — |
allowSms() | 恢复短信发送 | — |
App 管控
| API | 说明 | 参数 |
|---|---|---|
setAppWhitelist(packageNames[]) | 设置 App 白名单 | packageNames: 包名数组 |
blockNonWhitelistApps() | 限制非白名单 App 启动 | — |
unblockApps() | 解除 App 限制 | — |
防卸载
| API | 说明 | 参数 |
|---|---|---|
preventUninstall(packageName) | 拦截指定 App 被卸载 | packageName: 包名 |
allowUninstall(packageName) | 允许卸载 | — |
安全防护
| API | 说明 | 参数 |
|---|---|---|
preventFactoryReset() | 拦截恢复出厂设置 | — |
allowFactoryReset() | 允许恢复出厂设置 | — |
监测上报
| API | 说明 | 上报时机 |
|---|---|---|
reportSimStatus(simState) | 上报 SIM 卡状态 | 无卡 / 插拔时立即上报 |
reportNetworkStatus(connected, offlineDuration) | 上报联网状态 | 断连 / 恢复时立即上报 |
reportLocation(lat, lng) | 上报 GPS 位置 | 定期 + 异常时上报 |
reportRootStatus(isRooted) | 上报 ROOT/越狱状态 | 检测到变化时上报 |
reportHeartbeat(deviceId) | 心跳保活 | 定期上报（可配置间隔） |
API 设计原则
- 每个原子 API 正交 — 调
blockOutgoingCalls()不影响水印，不隐含其他行为 - 无策略逻辑 — 客户端 不判断”逾期几天”，只执行指令
- 幂等 — 重复调用同一状态不报错
- 状态可查 — 客户端 支持查询当前所有限制状态