屏幕自动化操作声明协议应用开发接入文档

// 判断 SAEP 协议功能当前是否生效（通过 Context 版本）
// 返回 true 表示生效，false 表示已被云端关闭或不可用
public static boolean isRobotsEnabled(Context context)

try {
    Class<?> clazz =
        Class.forName("android.security.obric.robots.RobotsHelperStub");
    Method getInstance = clazz.getDeclaredMethod("getInstance");
    getInstance.setAccessible(true);
    Object instance = getInstance.invoke(null);

    // 方式一：带 Context 参数版本
    Method methodWithCtx = clazz.getDeclaredMethod("isRobotsEnabled",
        Context.class);
    methodWithCtx.setAccessible(true);
    boolean enabled = (Boolean) methodWithCtx.invoke(instance, context);
    Log.d(TAG, "SAEP protocol enabled: " + enabled);
} catch (Exception e) {
    Log.e(TAG, "isRobotsEnabled failed: " + e.getMessage());
}

{
  "schema": "AGRP-Policy/1.0",
  "policy_version": 1,
  "package": "com.example.bank",
  "updated_at": "1772191606000",
  "default_policy": {
    "app": {
      "global_disable": true,
      "screenshot_disable": false,
      "input_disable": true
    }
  },
  "scope": {
    "app": {
      "global_disable": false
    },
    "activities": {
      "com.example.bank.LoginActivity": {
        "name": "登录界面",
        "page_scope": {
          "global_disable": true,
          "screenshot_disable": true,
          "input_disable": true
        }
      },
      "com.example.bank.PayConfirmActivity": {
        "name": "支付确认界面",
        "page_scope": {
          "screenshot_disable": true
        }
      }
    },
    "agent_intents": {
      "modify_content": false,
      "delete_content": false,
      "account_incentive": true,
      "post_content": false
    }
  }
}

<application
    ... >

    <meta-data
        android:name="com.obric.agentrobots.POLICY_JSON"
        android:resource="@raw/agent_saep_policy" />

    ...
</application>

content://com.obric.agentrobots.provider/policy

private static final Uri POLICY_UPDATE_URI =
    Uri.parse("content://com.obric.agentrobots.provider/policy");

/**
 * 通过 ContentProvider 更新策略
 *
 * @param context 上下文
 * @param policy 策略 JSON 字符串
 * @param version 版本号
 * @return 更新影响的行数，负数表示失败
 */
public static int updatePolicy(Context context, String policy, int version) {
    ContentValues values = new ContentValues();
    values.put("policy", policy);
    values.put("version", version);
    return context.getContentResolver().update(
        POLICY_UPDATE_URI, values, null, null);
}

package android.security.obric.agentmanager;

public class RobotsHelperStub {
    /**
     * 获取指定Agent的信息
     *
     * @param agentUuid Agent的 UUID
     * @return Agent信息的 JSON 字符串
     */
    public String getAgentInfo(String agentUuid) {
    }

    /**
     * 获取已注册的Agent列表
     *
     * @return 已注册Agent的 UUID 列表
     */
    public List<String> listRegisteredAgents() {
    }
}

try {
    Class<?> stubClazz =
        Class.forName("android.security.obric.agentmanager.AgentManagerStub");
    Method getInstanceMethod = stubClazz.getDeclaredMethod("getInstance");
    getInstanceMethod.setAccessible(true);
    Object stub = getInstanceMethod.invoke(null);

    Method listMethod = stubClazz.getDeclaredMethod("listRegisteredAgents");
    listMethod.setAccessible(true);

    List<String> uuids = (List<String>) listMethod.invoke(stub);
    // uuids 即已注册的AgentUUID 列表
} catch (Exception e) {
    e.printStackTrace();
}

try {
    Class<?> stubClazz =
        Class.forName("android.security.obric.agentmanager.AgentManagerStub");
    Method getInstanceMethod = stubClazz.getDeclaredMethod("getInstance");
    getInstanceMethod.setAccessible(true);
    Object stub = getInstanceMethod.invoke(null);

    Method getInfoMethod = stubClazz.getDeclaredMethod("getAgentInfo",
        String.class);
    getInfoMethod.setAccessible(true);

    String uuid = "<YOUR_AGENT_UUID>";
    String info = (String) getInfoMethod.invoke(stub, uuid);
    // info 即该Agent的详情信息（JSON 字符串）
} catch (Exception e) {
    e.printStackTrace();
}

package android.security.obric.audit;

public class SecurityAuditManagerStub {
    /**
     * 查询调用方自己的审计日志。
     *
     * @param startTimeMs 日志开始时间戳（毫秒）；0 表示不限制
     * @param endTimeMs 日志结束时间戳（毫秒）；0 表示不限制
     * @param targetIntent 查询意图；为空则不按意图过滤
     * @param targetActivity 查询目标 Activity；为空则不按 Activity 过滤
     * @return 原始 JSON 日志字符串列表；失败返回空列表
     */
    public List<String> queryLogs(long startTimeMs, long endTimeMs,
        String targetIntent, String targetActivity) {
    }
}

List<String> logs = new ArrayList<>();
try {
    Class<?> clazz =
        Class.forName("android.security.obric.audit.SecurityAuditManagerStub");
    Method method = clazz.getDeclaredMethod("queryLogs",
        long.class, long.class, String.class, String.class);
    method.setAccessible(true);
    Object ret = method.invoke(null, startMs, endMs, intentParam,
        activityParam);
    if (ret instanceof List) {
        logs.addAll((List<String>) ret);
        //TO DO: 实现业务逻辑
    }
} catch (Exception e) {
    Log.e(TAG, "queryLogs error: " + e.getMessage());
}