跳到主要内容

雲手機Android SDK

本SDK用於Android平臺快速接入星界雲手機,將雲手機的遠端控制模組以原生的方式整合至自有APP上。

SDK下載

星界雲手機Android SDK發行版包含:

  1. AAR檔案:aar目錄下,開發時匯入
  2. javadoc文件:java-doc目錄下
  3. 示例APK:demo目錄下
  4. 示例原始碼:demo目錄下

星界雲手機Android SDK下載:

  1. V1.0(2023-03-01):Android SDK下載
    初始版本

雲手機遠控整合說明

遠控整合賦予APP直接開啟雲手機遠端控制面板的能力,支援對雲手機進行基礎操作,如點選、滑動、按鍵、音量調節、剪下板、清理後臺等操作。

執行環境:Android 6.0( API Level 23)及以上版本

整合步驟:

  1. 服務端需要對接雲手機OpenAPI的獲取雲手機遠端操控地址介面,用於為APP提供指定雲手機的鑑權地址
  2. APP專案引入aar檔案
  3. 建立RemoteSdk並作相關初始化,透過RemoteSdk連線雲手機時,需要將第一步獲取的雲手機鑑權地址傳入,具體見示例原始碼RemoteActivity.java
  4. RemoteSdk支援的雲手機操作詳見javadoc文件裡的類RemoteSdk

雲手機直播/掃碼整合說明

方案一:雲手機直接呼叫當前連線雲手機的真機的攝像頭/話筒進行直播/掃碼,該方案只需要在整合雲手機遠控時,透過remoteSdk.connectCamera方法建立真機攝像頭與雲手機攝像頭的連線,呼叫該方法前需要確保APP已經獲取相機和話筒的許可權。詳見示例原始碼RemoteActivity.java裡的connectCameraAudio方法。

方案二:雲手機呼叫其他真機攝像頭進行直播/掃碼,該方案下真機只用於為雲手機提供畫面和聲音,無法看到雲手機桌面及操作雲手機。

方案二整合步驟:

  1. 服務端需要對接雲手機OpenAPI的獲取攝像頭地址介面,用於為APP提供指定雲手機攝像頭的連線地址
  2. APP專案引入aar檔案
  3. 建立RemoteSdk並作相關初始化,和遠控不同的是需要設定相機顯示View(setCameraView),用於顯示真機拍攝的畫面。
  4. 透過RemoteSdk連線雲手機時,需要將第一步獲取的雲手機攝像頭連線地址傳入,完成連線後,透過remoteSdk.connectCamera方法建立真機攝像頭與雲手機攝像頭的連線,呼叫該方法前需要確保APP已經獲取相機和話筒的許可權。具體見示例原始碼CameraActivity.java