帮助中心 > 雲手機 > 產品對接 > 雲手機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