跳到正文

Web Base 接入 ​

Web Base 提供现成的云手机工作台,包括设备列表、单机与批量操作、应用、文件、备份和任务进度。可以独立使用,也可以接入已有网站。

适合谁 ​

你的需求推荐方式
管理自己的云手机,尽快开始使用打开独立工作台,填写 Core 地址、Key 和 Secret
让客户在现有网站管理云手机保留原有登录,由自己的网站后端连接 Core

接入已有网站时,可以使用完整工作台,也可以只选用单机操作、应用、文件、备份或任务进度界面。页面怎么组合,不改变原有登录和后台权限检查。

需要准备什么 ​

  • 可访问的 Core 地址及管理密钥。
  • 每位客户可以使用的设备、允许执行的操作。
  • 工作台在网站中的位置,以及电脑、手机上的使用需求。

独立管理员在可信工作台填写自己的 Key 和 Secret。接入已有网站时,服务密钥只放在自己的后端,客户继续使用原有账号,无需填写管理密钥。

接入步骤 ​

  1. 确定页面。 选择独立工作台,或在现有网站放入完整工作台、所需操作界面。
  2. 接通设备与权限。 独立使用时验证连接;网站接入时,由自己的后端确认当前客户能查看、操作哪些设备。
  3. 接入投屏。 如需看屏幕、点击或输入,另行接入独立 Player。
  4. 检查实际效果。 验证操作结果、文件传输及手机显示;退出或切换账号后,旧账号的数据和操作不能留给新账号。

隐藏按钮不能代替后台权限检查。任务已提交也不代表设备已执行成功,需要确认最终结果。

接入例子 ​

例 1:独立管理员工作台 ​

现成工作台 → Core → 机房 → 云手机

管理员打开工作台,填写 Core 地址、Key 和 Secret,即可管理获准设备。接通后先验证常用操作。不需要先开发网站或安装 SDK;需要投屏时再接入 Player。

例 2:接入已有 React 网站 ​

自己页面内的 Web Base → 自己的网站后台(同源) → Core → 机房 → 云手机

保留原有品牌、导航和登录,在 React 页面中直接装配 StandardWorkbench。客户登录后,浏览器请求自己网站的后台;后台保管服务密钥,并最终检查当前账号的设备和操作权限。

下面仅示意浏览器如何连接自己的后台,供开发同事参考:

开发示意:把工作台请求接到自己的后台
ts
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 的设备操作、权限检查和任务结果客户的设备与操作范围、页面位置,以及接入验收

已有网站仍需逐项完成对接;独立工作台可用,不代表你的业务系统已经接好。

进一步了解 ​

Core 接入 · 平台架构 · 云手机查询能力 · 投屏接口

下载中文技术参考 · 下载完整文档包

功能范围以当前交付合同与验收结果为准。