云手机Web SDK
Web Sdk说明
本Web Sdk主要是用于网页接入云手机。
接入步骤
- 通过云手机API获取云手机远程操控地址接口获取云手机控制地址
- 客户Web页面引入JsSDK，引入js文件： https://console.chinac.com/front/JsSdk/JsSdk-1.0.js
- 调用XingJieSdk.init()初始化
- 页面调用示例参见：https://console.chinac.com/front/JsSdk/index.html
接口说明
初始化
init(config)
| 参数名 | 类型 | 说明 |
|---|---|---|
| playDivId | string | 放置控制界面的div ID |
| url | string | 云手机远程操控地址 |
| autoconnect | boolean | true 调用init完自动连接云手机，false 不自动连接云手机，会显示一个连接按钮。由于浏览器限制，无法打开页面时自动播放，必须有用户的点击事件调init才可以。如果想页面打开时自动播放，mute设置成true，即设置成静音。 |
| mute | boolean | 是否静音 |
| cameraMic | boolean | 是否启用摄像筒话筒 |
| showBottomBar | boolean | 是否显示底部菜单 |
| autoRotate | boolean | 是否自动旋转，手机浏览器该属性不生效，不自动旋转 |
| resolution | string | 初始分辨率 720P、480P、360P、240P |
| displayWidth | number | 显示的宽度，为竖屏时的宽度，高度会根据比例自动算出, 会影响 playDivId的尺寸，0 自适应playDiv大小 |
| showScreenShotBtn | boolean | 显示截屏按钮 |
| showCameraBtn | boolean | 显示相机按钮 |
| showCleanAppBtn | boolean | 显示清除后台按钮 |
| showShakeBtn | boolean | 显示摇一摇按钮 |
| showClipboardBtn | boolean | 显示剪切板按钮 |
断开连接
disconnect()
切换画质
changeResolution(resolution)
| 参数名 | 类型 | 说明 |
|---|---|---|
| resolution | string | 分辨率 720P、480P、360P、240P |
点击按键
sendKeyClick(keyCode)
| 参数名 | 类型 | 说明 |
|---|---|---|
| keyCode | number | 187 任务、3 桌面、4 后退、24 音量+、35 音量-，其他KeyCode参见 https://developer.android.google.cn/reference/android/view/KeyEvent |
按键事件
sendKeyEvent({action: string, keyCode: number})
| 参数名 | 类型 | 说明 |
|---|---|---|
| action | string | DOWN: 按下，UP：抬起 |
| keyCode | number | 187 任务、3 桌面、4 后退、24 音量+、35 音量-，其他KeyCode参见 https://developer.android.google.cn/reference/android/view/KeyEvent |
点击坐标
sendFingerClick(x, y)
| 参数名 | 类型 | 说明 |
|---|---|---|
| x | number | x 坐标, 像素 |
| y | number | y 坐标, 像素 |
手指事件
sendFingerEvent({action: string, x: number, y: number})
| 参数名 | 类型 | 说明 |
|---|---|---|
| action | string | DOWN: 按下， MOVE: 移动， UP：抬起 |
| x | number | x 坐标, 像素 |
| y | number | y 坐标, 像素 |
发送剪切板
sendPaste(text)
| 参数名 | 类型 | 说明 |
|---|---|---|
| text | string | 将字符发送到手机剪切板 |
启动APP
startApp(packageName)
| 参数名 | 类型 | 说明 |
|---|---|---|
| packageName | string | 包名 |
停止APP
stopApp(packageName)
| 参数名 | 类型 | 说明 |
|---|---|---|
| packageName | string | 包名 |
静音
mute(mute)
| 参数名 | 类型 | 说明 |
|---|---|---|
| mute | boolean | true: 静音， false: 不静音 |
相机话筒模拟
enableCameraMic(enable)
| 参数名 | 类型 | 说明 |
|---|---|---|
| enable | boolean | true: 启用模拟， false: 关闭模拟 |
显示底部菜单栏
showBottomBar(show)
| 参数名 | 类型 | 说明 |
|---|---|---|
| show | boolean | true: 显示， false: 隐藏 |
剪切板回调
onCopy(text)
| 参数名 | 类型 | 说明 |
|---|---|---|
| text | string | 云手机内有复制内容时回调 |
连接状态变化回调
onVideoConnChange(status, code)
| 参数名 | 类型 | 说明 |
|---|---|---|
| status | number | 1： 连接中 2： 连接成功 3：断开连接 |
| code | string | 断开连接错误码 |
连接断开错误码
| 参数名 | 说明 |
|---|---|
| 0000 | 连接成功 |
| 1111 | 其他异常 |
| 1001 | 连接会话过期 |
| 1002 | 连接数超出配额 |
| 1306 | 连接太频繁， 有限制5秒内只能发起一次连接 |
| 10001 | 视频流断开 |
| 10002 | 浏览器不支持 |
| 10003 | 连接超时 |
| 10004 | websocket连接断开 |
方向旋转回调
onOrientationChange(orientation, w, h)
| 参数名 | 类型 | 说明 |
|---|---|---|
| orientation | number | 1 竖直 2 水平 |
| w | number | 手机宽 |
| h | number | 手机高 |
摄像头模拟启用回调
onCameraMicEnableChange(enable)
| 参数名 | 类型 | 说明 |
|---|---|---|
| enable | boolean | true:启用 false:禁用 |
分辨率变化回调
onResolutionChange(resolution)
| 参数名 | 类型 | 说明 |
|---|---|---|
| resolution | string | 分辨率 720P、480P、360P、240P |