Web Base 接入
Web Base 提供现成的云手机工作台,包括设备列表、单机与批量操作、应用、文件、备份和任务进度。可以独立使用,也可以接入已有网站。
适合谁
| 你的需求 | 推荐方式 |
|---|---|
| 管理自己的云手机,尽快开始使用 | 打开独立工作台,填写 Core 地址、Key 和 Secret |
| 让客户在现有网站管理云手机 | 保留原有登录,由自己的网站后端连接 Core |
接入已有网站时,可以使用完整工作台,也可以只选用单机操作、应用、文件、备份或任务进度界面。页面怎么组合,不改变原有登录和后台权限检查。
需要准备什么
- 可访问的 Core 地址及管理密钥。
- 每位客户可以使用的设备、允许执行的操作。
- 工作台在网站中的位置,以及电脑、手机上的使用需求。
独立管理员在可信工作台填写自己的 Key 和 Secret。接入已有网站时,服务密钥只放在自己的后端,客户继续使用原有账号,无需填写管理密钥。
接入步骤
- 确定页面。 选择独立工作台,或在现有网站放入完整工作台、所需操作界面。
- 接通设备与权限。 独立使用时验证连接;网站接入时,由自己的后端确认当前客户能查看、操作哪些设备。
- 接入投屏。 如需看屏幕、点击或输入,另行接入独立 Player。
- 检查实际效果。 验证操作结果、文件传输及手机显示;退出或切换账号后,旧账号的数据和操作不能留给新账号。
隐藏按钮不能代替后台权限检查。任务已提交也不代表设备已执行成功,需要确认最终结果。
接入例子
例 1:独立管理员工作台
现成工作台 → Core → 机房 → 云手机
管理员打开工作台,填写 Core 地址、Key 和 Secret,即可管理获准设备。接通后先验证常用操作。不需要先开发网站或安装 SDK;需要投屏时再接入 Player。
例 2:接入已有 React 网站
自己页面内的 Web Base → 自己的网站后台(同源) → Core → 机房 → 云手机
保留原有品牌、导航和登录,在 React 页面中直接装配 StandardWorkbench。客户登录后,浏览器请求自己网站的后台;后台保管服务密钥,并最终检查当前账号的设备和操作权限。
下面仅示意浏览器如何连接自己的后台,供开发同事参考:
开发示意:把工作台请求接到自己的后台
import {
createSessionClient,
createWorkspaceApi,
createDataProvider,
} from '@cloud-mobile-web-base/session-client'
const client = createSessionClient({
host: {
url: window.location.origin,
apiPrefix: '/core-workbench',
identity: bootstrap.identity,
csrfToken: bootstrap.csrfToken,
},
onUnauthorized: () => disconnectHostWorkspace(),
})
const api = createWorkspaceApi(client)
const dataProvider = createDataProvider(client)这不是完整工程:仍需提供后台路由、账号及权限校验,并装配 React、React Admin 的共享上下文和工作台。bootstrap 由自己的后台提供。退出或换账号时,先调用 client.clear(),再清理旧数据缓存并重新装配工作台。
例 3:设备详情只加入应用管理
自己的设备详情页 → 应用或文件界面 → 自己后台 → Core
沿用网站现有登录和页面容器,在同一套已接好的工作台上下文中复用 ApplicationsContent,只显示选定设备的应用;文件、备份和任务进度也可按需加入,无需重做整个工作台。弹窗或侧栏由自己的页面安排。
双方负责什么
| 平台提供 | 你需要负责 |
|---|---|
| 通用工作台、可复用的操作界面和独立 Player | 自己的品牌、导航、账号、订单和计费 |
| Core 的设备操作、权限检查和任务结果 | 客户的设备与操作范围、页面位置,以及接入验收 |
已有网站仍需逐项完成对接;独立工作台可用,不代表你的业务系统已经接好。