前提条件
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 Control を開く
- Android Devices セクションを確認
- デバイスがリストに表示されます
ターミナル経由(オプション)
Qaptly Auto Service のインストール
Qaptly Auto Service APK は、Android デバイスで自動化を可能にします。ステップ 1: APK のインストール
- Pilot Control で Android デバイスを選択
- Install Service をクリック
- インストールが完了するまで待つ
ステップ 2: 権限の付与
アクセシビリティサービス
- デバイスで、設定 > アクセシビリティに移動
- Qaptly Auto Service を見つける
- サービスを有効にする
- プロンプトを確認
他のアプリの上に重ねて表示
- 設定 > アプリ > Qaptly Auto に移動
- 他のアプリの上に重ねて表示をタップ
- 権限を有効にする
ストレージ権限
- 設定 > アプリ > Qaptly Auto に移動
- 権限をタップ
- ストレージまたはファイルとメディアを有効にする
ステップ 3: インストールの確認
- Pilot Control でデバイスリストを更新
- デバイスに「Service Installed」と表示されます
画面ストリーミングの開始
ストリームの開始
- Pilot Control で Android デバイスを見つける
- Start Stream をクリック
- デバイスの画面がストリーミングパネルに表示されます
ストリームの停止
- デバイスの Stop Stream をクリック
- またはストリーミングパネルを閉じる
デバイス固有の設定
画面解像度
Qaptly はデバイスのネイティブ解像度を表示します。解像度はデバイス名の横に表示されます。USB モード
デバイスが次のいずれかの USB モードであることを確認してください:- ファイル転送(MTP): 推奨
- PTP: これも動作します
- 充電のみモード
- MIDI モード
複数のデバイス
複数のデバイスの接続
複数の Android デバイスを同時に接続できます:- 各デバイスを USB で接続
- 各デバイスで USB デバッグを有効にする
- すべてのデバイスが Pilot Control に表示されます
デバイスの選択
複数のデバイスが接続されている場合:- リストからターゲットデバイスを選択
- 選択されたデバイスがハイライト表示されます
- アクションは選択されたデバイスに適用されます
トラブルシューティング
デバイスが検出されない
- USB ケーブルを確認: 別のケーブルを試す
- USB ポートを確認: 別のポートを試す
- ADB を再起動:
adb kill-serverを実行してからadb start-server - 認証を取り消す: デバイスで、開発者向けオプション > USB デバッグの認証を取り消すに移動し、再接続
「Unauthorized」ステータス
- デバイスにプロンプトがないか確認
- USB デバッグの認証を受け入れる
- プロンプトがない場合は、認証を取り消して再接続
サービスのインストールに失敗
- デバイスで「提供元不明のアプリをインストール」を有効にする
- 利用可能なストレージ容量を確認
adb installで手動 APK インストールを試す
ストリーミングの問題
- Qaptly Auto Service が実行されていることを確認
- アクセシビリティサービスが有効になっているか確認
- 他のアプリの上に重ねて表示の権限を確認
- ストリーミングを再起動
パフォーマンスの問題
- デバイスで不要なアプリを閉じる
- 画面の明るさを下げる
- USB 接続を確認(USB 3.0 推奨)
- 可能であればストリーミング解像度を下げる
ベストプラクティス
- 高品質なケーブルを使用: 粗悪なケーブルは接続問題を引き起こします
- デバイスを充電しておく: バッテリー残量が少ないとストリーミングに影響します
- 定期的に更新: Qaptly Auto Service を最新の状態に保つ
- クリーンアップ: テストしていないときはデバイスを切断