OSkillProxy — Android 组件调用代理

概述

OSkillProxy 是运行在 Android 设备上的代理服务。它提供本地 HTTP API，允许你以正确的 App 身份调用 Android 四大组件（Activity、Service、BroadcastReceiver、ContentProvider）。

使用前提：

• - OSkillProxy App 已安装并且代理服务已启动
• Token 已配置（在 App 界面上查看）
• 通过 http://127.0.0.1:8726 访问（端口可能已修改，以实际配置为准）

工具列表

start_activity

• - 支持显式 Intent（指定 package + class）和隐式 Intent（指定 action）
• 这是一个 fire-and-forget 操作，不返回 Activity 结果

start_service

• - 支持普通启动和前台服务启动

send_broadcast

• - 支持普通广播和带权限限制的广播

query_provider

insert_provider

update_provider

delete_provider

call_provider

调用方式

所有调用通过 HTTP POST 请求发起，使用 JSON 格式。

通用 HTTP 格式

bash
curl -X POST http://127.0.0.1:8726/api/v1/component/ \
-H Authorization: Bearer \
-H Content-Type: application/json \
-d

认证

Authorization: Bearer <你的token>

通用响应格式

各端点详细说明

POST /component/activity/start

启动一个 Activity。

请求参数:

package+class（显式）或 action（隐式）至少提供一种。

支持的 Flags:

• - FLAGACTIVITYNEWTASK（自动添加）
• FLAGACTIVITYCLEARTOP
• FLAGACTIVITYSINGLETOP
• FLAGACTIVITYCLEARTASK
• FLAGACTIVITYNOHISTORY
• FLAGACTIVITYEXCLUDEFROMRECENTS
• FLAGACTIVITYNEWDOCUMENT
• FLAGACTIVITYMULTIPLETASK
• FLAGINCLUDESTOPPEDPACKAGES

POST /component/service/start

启动一个 Service。

请求参数: 同 Activity，额外字段：

POST /component/broadcast/send

发送一个 Broadcast。

请求参数: 同 Activity，额外字段：

POST /component/provider/query

查询 ContentProvider。

请求参数:

响应 data:
json
{
columns: [_id, title],
rows: [[1, Note 1], [2, Note 2]],
count: 2
}

POST /component/provider/insert

向 ContentProvider 插入数据。

请求参数:

响应 data:
json
{
uri: content://com.example.provider/notes/3
}

POST /component/provider/update

更新 ContentProvider 数据。

请求参数:

响应 data:
json
{
affectedRows: 1
}

POST /component/provider/delete

删除 ContentProvider 数据。

请求参数:

响应 data:
json
{
affectedRows: 1
}

POST /component/provider/call

调用 ContentProvider 的 call() 方法。

请求参数:

响应 data: ContentProvider 返回的 Bundle 内容，序列化为 JSON 对象。

extras 类型说明

extras 字段支持两种格式：

格式 1：显式类型（推荐）
json
{
key: {type: string, value: hello},
count: {type: int, value: 42},
flag: {type: boolean, value: true}
}

支持的类型：string, int, long, float, double, boolean, stringarray, intarray, long_array

格式 2：自动推断
json
{
key: hello,
count: 42,
flag: true
}

自动根据 JSON 值类型推断。

使用示例

示例 1：启动一个 Activity（显式 Intent）

场景：启动录音应用的透明 Activity 进行录音控制

bash
curl -X POST http://127.0.0.1:8726/api/v1/component/activity/start \
-H Authorization: Bearer a3f8xxxxxxxxxxc9d2 \
-H Content-Type: application/json \
-d {
package: com.coloros.soundrecorder,
class: oplus.multimedia.soundrecorder.slidebar.TransparentActivity,
action: oplus.intent.action.STARTRECORDFROMCUBEBUTTON,
categories: [android.intent.category.DEFAULT]
}

示例 2：启动一个 Activity（隐式 Intent，带 extras）

bash
curl -X POST http://127.0.0.1:8726/api/v1/component/activity/start \
-H Authorization: Bearer \
-H Content-Type: application/json \
-d {
action: android.intent.action.SEND,
type: text/plain,
extras: {
android.intent.extra.TEXT: {type: string, value: Hello from agent!}
}
}

示例 3：查询 ContentProvider

bash
curl -X POST http://127.