Cloud Phone：無影雲手機快速整合最佳實務

業務模型

無影雲手機支援雲手機執行個體組，一個執行個體組下可以建立多個雲手機。一般情況下，執行個體組和執行個體的推薦比例關係是1:1，即1個執行個體組只建立1個雲手機，以便進行後續的變更鏡像等操作。

無影雲手機也支援雲手機矩陣，矩陣產品目前處於邀測階段，如需下單購買請聯絡售前諮詢。

執行個體調度

您需要做好阿里雲帳號下的雲手機執行個體調度工作，包括但不限於：

• 雲手機建立：在適當的時候建立雲手機。可以在控制台手動建立，也可以在代碼中動態調用CreateAndroidInstanceGroup - 建立執行個體組介面來建立。

• 雲手機銷毀：在適當的時候銷毀雲手機。可以在控制台手動建立，也可以在代碼中動態調用DeleteAndroidInstanceGroup - 刪除執行個體組介面來釋放。

• 雲手機池維護：

  • 用戶端發起串連時，從當前雲手機池中取出閒置雲手機用於串連，並將狀態設定為已使用。

  • 用戶端斷連時，將當前雲手機從已使用狀態修改為空白閑狀態；必要時，可以通過RunCommand介面刪除相關檔案，避免上一位使用者留下使用痕迹。

• 雲手機池狀態監控：當雲手機池達到一定的閾值（比如80%）時，需要警示並動態擴容或手動擴容。

• 雲手機調度提速：為了確保快速串連，您應當考慮業務的峰值並發問題，確保每次調度都有可用的雲手機。

帳號體系對接&登入串連

無影雲手機支援多種登入方式：

• 免授權登入（擷取Ticket模式）：免授權登入模式，是一種無需授權登入即可分配臨時使用者串連雲手機的方式。只有開通免授權後建立的雲手機，才可以通過免授權登入。接入方服務端調用BatchGetAcpConnectionTicket介面（請參考BatchGetAcpConnectionTicket - 批量擷取執行個體串連憑證），根據唯一的使用者ID和雲手機執行個體ID擷取到Ticket，將Ticket傳入用戶端SDK即可串連當前雲手機執行個體。

• 免授權登入（擷取AuthCode模式）：開通免授權登入後，任何代表使用者的唯一字串均可擷取AuthCode授權碼（請參考GetAuthCode - 擷取授權碼），將AuthCode傳入用戶端SDK即可串連當前阿里雲帳號下的任意一台雲手機。AuthCode登入一次會失效，重複登入需要重複擷取AuthCode。

由於免授權方式更靈活，不需要維護業務帳號和無影便捷帳號的映射關係，我們推薦您在整合無影雲手機時採用免授權登入的方案。

• 便捷帳號登入：便捷帳號登入模式，通過無影使用者系統和雲手機訪問授權保障了雲手機登入的使用者可信。您需要先在無影使用者系統建立便捷帳號（請參考CreateUsers - 建立便捷帳號），再為雲手機分配授權便捷帳號（請參考AuthorizeAndroidInstance - 執行個體分配使用者&取消分配）。分配授權後，即可登入無影雲手機用戶端（下載地址：無影用戶端下載頁）並串連雲手機。如果想通過便捷帳號在用戶端SDK登入並串連雲手機，根據便捷帳號的使用者名稱密碼和雲手機所綁定的網路ID擷取LoginToken和SessionId（請參考GetLoginToken - 擷取登入憑證），並將LoginToken和SessionId傳入用戶端SDK即可串連當前已授權的雲手機。

使用者鑒權與串連雲手機（免授權通過Ticket登入）

使用者鑒權是服務端整合環節，您的服務端需要完成以下開發工作，擷取使用者串連雲手機的Ticket。

串連雲手機是用戶端整合環節，您將Ticket傳入用戶端即可串連雲手機。

• 查詢雲手機：服務端調用DescribeAndroidInstances - 查詢執行個體詳細資料介面，擷取到您要串連的雲手機的AndroidInstanceId。

• 擷取Ticket：服務端需要提前準備好EndUserId，EndUserId可以是任意的唯一字串。服務端根據AndroidInstanceId和EndUserId調用BatchGetAcpConnectionTicket - 批量擷取執行個體串連憑證介面，擷取到Ticket。

• 初始化Session：以Web端樣本，用戶端通過調用wuyingSdk.createSession()，初始化會話。

• 建立串連：以Web端樣本，用戶端調用session.start()，與會話建立串連。

• 中斷連線：以Web端樣本，用戶端調用session.stop()，與會話中斷連線。