帮助中心 > 云手机 > 产品对接 > 云手机Web SDK

云手机Web Sdk说明

本Web Sdk主要是用于网页接入云手机。

接入步骤

1. 通过云手机API获取云手机远程操控地址接口获取云手机控制地址

2. 客户Web页面引入JsSDK，引入js文件： https://console.chinac.com/front/JsSdk/JsSdk-1.0.js

3. 调用XingJieSdk.init()初始化

4. 页面调用示例参见：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

断开连接错误码

方向旋转回调

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