車内でdosyaの音声ライブラリを閲覧する

CarPlayのコードを使用するには、iOS 15.1以降とDOSYA_CARPLAY=1を使って作成したdosyaのiOSビルドが必要です。Appleの制限付きCarPlay Audio権限が利用できない間、通常の本番ビルドには連携が含まれません。そのため、権限付きビルドがなければdosyaは車載ディスプレイに表示されません。

始める前に

• インストール済みのdosyaビルドがCarPlayに表示されることを確認してください。表示される場合は、iPhoneでサインインして目的のワークスペースを選び、停車中に接続してください。
• 車内のライブラリは読み取り専用です。ファイルのアップロード、移動、名前変更、共有、削除はできません。
• lock_modeがnoneに設定された音声ファイルのみが再生可能な行になります。対象の音声が含まれていなくてもフォルダーは表示されます。

手順

1. CarPlayの画面にdosyaが表示されていれば開いてください。サインアウト中はルートにiPhoneで「dosya」を開いてサインインと表示されます。
2. 再生を続けるが表示されたら選択すると、そのワークスペースの現在のファイルを保存位置から再開できます。
3. ルート一覧の上部にある履歴の行を閲覧してください。独立したRecent画面やボタンはありません。端末にはワークスペースをまたいで最大20件の履歴が保存され、アクティブなワークスペースの項目だけが表示されます。履歴の行を選ぶと0:00から再生されます。現在の項目を保存位置から再開するには再生を続けるを使ってください。
4. フォルダーを開くと直下の項目が読み込まれます。リクエストで取得するのは最大100件の1ページです。音声の行を選ぶと、取得した同じ階層の対象音声が再生キューに追加され、選んだ曲が再生されます。
5. 再生には標準の再生中を使ってください。選択した項目の再生中またはバッファリング中にdosyaが開きます。
6. 対応する階層の上限で止めてください。ルートからフォルダーを3階層開いた後、次の画面には**フォルダーの階層が深すぎます。iPhoneで閲覧してください。**と表示されます。

復旧

401応答では**iPhoneで再接続すると閲覧を続けられます。と表示されます。その他の一覧取得エラーではファイルを読み込めませんでした。接続を確認してください。**と表示されます。停車中に再認証するかiPhoneの接続を復旧し、CarPlayの画面を開き直してください。

削除済みまたはアクセスできない履歴項目は、開けないことがあり、その場合は何も表示されず、アプリのログにのみ記録されます。iPhoneのファイルで確認し、別の項目を選んでください。サインアウトすると端末内の履歴は消去されます。

結果

権限付きビルドでは、選択したロックされていない音声ファイルが、読み込まれた同じフォルダー階層の対象音声とともに標準のNow Playingに入ります。閲覧や再生によってクラウドライブラリは変更されません。

関連ガイド

• モバイルでバックアップしたファイルを閲覧する
• メディアファイルをプレビューする