Core 接入
把云手机的查询、开关机、应用和文件等能力接入自己的业务系统。Core 是已部署的 API 服务；SDK 只是帮助程序调用它的工具，安装 SDK 不会启动 Core。
适合谁
需要在自己的网站、管理系统或自动化服务中使用云手机的团队。管理员只想直接操作设备，可使用 Web Base 工作台，无需安装 SDK。
需要准备什么
- 向平台方取得已部署的 Core 地址、管理接入资料和一台测试云手机。
- 确认自己的业务后端能访问 Core，并列出用户可用的设备、操作和期限。
- 选择直接调用 HTTP API，或使用 Node.js SDK。SDK 为可选工具，安装包向交付方获取。
普通用户沿用你的业务登录：浏览器访问自己的业务后端，再由后端调用 Core。管理密钥和 Core 登录凭据由后端保管，不交给普通用户。
接入步骤
- 选定功能。 从能力目录确认业务需要和使用限制。
- 查到测试云手机。 核对设备身份和可用范围，再提交一次开机等操作。
- 跟踪结果。 用返回的任务编号查看进度和结果，并确认设备实际生效。收到任务不代表操作完成；结果不明时先查原任务，避免重复执行。
- 接入业务用户。 后端每次核对用户当前可用的资源、权限和期限；退出或停用账号时，同步撤销 Core 使用授权。
- 验收后开放。 检查无权访问、到期和失败的处理；需要投屏时另行完成 Player 接入与实际设备验收。
接入例子
自己的管理后台或自动化服务
你的管理后台／自动化服务 → HTTP API 或 Node.js SDK → Core
例如，在自己的后台查看云卡清单，或定时查询任务结果。程序在可信服务端调用 Core，可以直接发送 HTTP 请求，也可以使用 SDK。以下只读片段演示查询云卡，不是直接提供给普通用户的接口。
开发示意：用 SDK 查询云卡
ts
import { createServerClient } from '@cloud-mobile-core/http-client/server';
import { coreOrigin, credentials } from './server-config.js';
const core = createServerClient({
baseUrl: coreOrigin,
serviceKey: credentials.key,
serviceSecret: credentials.secret,
});
try {
const page = await core.boxes.list({ page: 1, page_size: 50 });
console.log(page.data);
} finally {
await core.close();
}SDK 需要 Node.js ≥22.14.0，安装包向交付方获取。server-config.js 由业务后端读取安全配置，不放进浏览器代码。这里演示一次性脚本；长期运行的服务可复用客户端，在服务退出时关闭。
已有网站给客户使用
客户浏览器（原有登录） → 你的网站后台（检查使用范围） → Core
例如，客户登录你的网站后，只查看和操作自己获准使用的设备。后台先确认当前用户、设备范围、允许操作和期限，再转发请求；SDK 的会话代理可帮助完成这层调用，业务方仍需提供自己的登录和授权规则。管理密钥和 Core 凭据始终留在后台，退出时同步撤销授权。不要把上面的管理查询直接开放给客户，也不要由浏览器自行声明权限。
两种方式都由 Core 统一提供接口。查询读取已同步的数据；设备操作由 Core 交给已登记机房执行，你的业务系统无需直接连接云手机。
双方负责什么
| 平台方 | 业务方 |
|---|---|
| 提供 Core 地址、接入资料、测试设备和 API 说明 | 管理用户登录与授权，保管密钥，接入业务后端 |
| 维护 Core 与设备执行服务，提供任务结果 | 处理进度和失败，验证业务流程及设备效果 |