雲手機Web SDK
Web Sdk說明
本Web Sdk主要是用於網頁接入雲手機。
接入步驟
- 透過雲手機API獲取雲手機遠端操控地址介面獲取雲手機控制地址
- 客戶Web頁面引入JsSDK，引入js檔案： https://console.yunpanel.com/front/JsSdk/JsSdk-1.0.js
- 呼叫XingJieSdk.init()初始化
- 頁面呼叫示例參見：https://console.yunpanel.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 |