音声操作でdosyaの音声を再生する

Siriのメディアインテントのコードは、DOSYA_CARPLAY=1を使って作成したdosyaのiOSビルドにのみ含まれます。Appleの制限付きCarPlay Audio権限が利用できない間、通常の本番ビルドには含まれません。権限付きビルドでは、連携機能が発話されたメディア、アーティスト、アルバムのテキストをアクティブなワークスペースの検索に渡します。

始める前に

• インストール済みのdosyaビルドでSiriメディア連携が使えることを確認し、車両に接続する前にiPhoneでサインインして正しいワークスペースを選んでください。
• 一意に検索できる音声ファイル名やパスの一部を選んでください。検索はdosyaの結果に基づき、ブラウザが解析したアーティストやアルバムのタグの意味とは照合しません。
• 停車中に練習してください。この連携のJavaScriptハンドラーには、曖昧な結果を画面で選ぶ機能や音声による復旧案内は実装されていません。

手順

1. iPhoneのファイルで目的の音声ファイルを確認し、保存名の特徴的な部分を控えてください。
2. 権限付きビルドで、その一意の言葉を使ってdosyaのSiriメディア再生を呼び出してください。実際の言い方は端末のSiriの言語やアプリで使える語彙によって異なります。
3. dosyaはモバイルのセッションを復元し、最後にアクティブだったワークスペースを読み取ります。起動していない状態からのリクエストはJavaScriptハンドラーの準備ができるまで保持され、実行中のリクエストはイベントとして届きます。
4. 検索ではファイル結果を音声の種類で絞りますが、ロックされた結果は除外しません。音声ファイルがちょうど1件でフォルダーが0件の場合、dosyaはプレーヤーに1曲の検索結果再生キューを要求します。再生可能でロックされていないファイルは再生されます。ロック中など対象外の結果はキューの作成時に除外され、再生されず、**このファイルは再生できません。**と表示されることがあります。
5. 標準のNow Playingで目的のタイトルを確認してください。何も始まらない場合は、まずiPhoneでファイルのロックや再生拒否を確認してください。次にアクティブなワークスペースを確認し、結果が曖昧だった場合は検索語をより特徴的にしてください。

一致なし、曖昧な結果、エラー

一致するファイルとフォルダーが0件の場合、再生は始まらず、画面上の説明もありません。一意に一致した音声がロック中などの理由で再生できない場合、**このファイルは再生できません。**と表示されることがあります。ただし音声処理はプレーヤーに再生を要求した後、内部的にはplayedを返します。検索エラーはアプリのログにのみ記録されます。複数のファイル、またはファイル1件とフォルダー1件でも曖昧な結果と扱われ、再生されません。検索語が空、アクティブなワークスペースがない、またはサインアウト中の場合も何も実行されずに終了します。

音声操作によって音声ファイルの名前変更、移動、削除、編集が行われることはありません。一意に検索しやすくするためにクラウドファイルの名前を変更することは別の永続的な操作であり、リンクや共同作業者に影響することがあります。本番の名前を変更する前に、特徴的なテスト項目を使ってください。

結果

権限付きビルドでは、一意に一致した再生可能でロックされていない音声が1件の再生キューで再生されます。曖昧な結果、一致なし、サインアウト、失敗、ロック中など再生できない結果はiPhoneで確認する必要があります。

関連ガイド

• CarPlayの音声ライブラリを閲覧する
• モバイルでバックアップしたファイルを閲覧する