先決條件
在您的 Mac 上
- 已安裝 Android SDK (透過 Android Studio 或獨立安裝)
- 可存取 ADB (Android Debug Bridge)
- 用於裝置連接的 USB 線
在您的 Android 裝置上
- Android 7.0 (API 24) 或更高版本
- 已啟用 USB 偵錯
- USB 連接處於「檔案傳輸」模式
啟用 USB 偵錯
步驟 1: 啟用開發者選項
- 在您的 Android 裝置上開啟 設定
- 前往 關於手機 (或關於平板電腦)
- 找到 版本號碼
- 連續點擊 版本號碼 7 次
- 您會看到訊息: 「您現在是開發者!」
步驟 2: 啟用 USB 偵錯
- 返回 設定
- 找到 開發者選項 (通常在系統下)
- 啟用 USB 偵錯
- 確認提示
步驟 3: 連接到電腦
- 透過 USB 線連接裝置
- 在裝置上,您會看到提示:
- 勾選「一律允許來自此電腦」
- 點擊 允許
驗證連接
在 Qaptly 中
- 開啟 Pilot 控制台
- 檢查 Android 裝置區段
- 您的裝置應出現在清單中
透過終端機 (可選)
安裝 Qaptly Auto Service
Qaptly Auto Service APK 可在 Android 裝置上啟用自動化。步驟 1: 安裝 APK
- 在 Pilot 控制台中,選擇您的 Android 裝置
- 點擊 安裝服務
- 等待安裝完成
步驟 2: 授予權限
輔助使用服務
- 在裝置上,前往 設定 > 輔助使用
- 找到 Qaptly Auto Service
- 啟用該服務
- 確認任何提示
顯示在其他應用程式上層
- 前往 設定 > 應用程式 > Qaptly Auto
- 點擊 顯示在最上層 或 顯示在其他應用程式上層
- 啟用權限
儲存權限
- 前往 設定 > 應用程式 > Qaptly Auto
- 點擊 權限
- 啟用 儲存空間 或 檔案和媒體
步驟 3: 驗證安裝
- 在 Pilot 控制台中,重新整理裝置清單
- 裝置應顯示「服務已安裝」
開始螢幕串流
開始串流
- 在 Pilot 控制台中,找到您的 Android 裝置
- 點擊 開始串流
- 裝置螢幕將出現在串流面板中
停止串流
- 在裝置上點擊 停止串流
- 或關閉串流面板
裝置特定設定
螢幕解析度
Qaptly 顯示裝置的原生解析度。解析度顯示在裝置名稱旁邊。USB 模式
確保您的裝置處於以下 USB 模式之一:- 檔案傳輸 (MTP): 建議
- PTP: 也可以使用
- 僅充電模式
- MIDI 模式
多裝置
連接多個裝置
您可以同時連接多個 Android 裝置:- 透過 USB 連接每個裝置
- 在每個裝置上啟用 USB 偵錯
- 所有裝置出現在 Pilot 控制台中
選擇裝置
連接多個裝置時:- 從清單中選擇目標裝置
- 選定的裝置會被突顯顯示
- 操作應用於選定的裝置
疑難排解
裝置未檢測到
- 檢查 USB 線: 嘗試不同的線
- 檢查 USB 埠: 嘗試不同的埠
- 重新啟動 ADB: 執行
adb kill-server然後adb start-server - 撤銷授權: 在裝置上,前往開發者選項 > 撤銷 USB 偵錯授權,然後重新連接
「未授權」狀態
- 檢查裝置上的提示
- 接受 USB 偵錯授權
- 如果沒有提示,撤銷授權並重新連接
服務安裝失敗
- 在裝置上啟用「允許來自未知來源的安裝」
- 檢查可用的儲存空間
- 嘗試透過
adb install手動安裝 APK
串流問題
- 確保 Qaptly Auto Service 正在執行
- 檢查輔助使用服務已啟用
- 驗證顯示在其他應用程式上層權限
- 重新啟動串流
效能問題
- 關閉裝置上不必要的應用程式
- 降低螢幕亮度
- 檢查 USB 連接 (建議使用 USB 3.0)
- 如果可用,降低串流解析度
最佳實踐
- 使用優質線材: 劣質線材會導致連接問題
- 保持裝置充電: 低電量會影響串流
- 定期更新: 保持 Qaptly Auto Service 更新
- 清理: 不測試時斷開裝置連接