車載ディスプレイからdosyaの音声を検索する

dosyaには文字入力用の検索コントロールやCarPlayの検索画面はありません。Siriによる車内検索はDOSYA_CARPLAY=1で作成した権限付きiOSビルドにのみ含まれます。Appleの制限付きCarPlay Audio権限が利用できない間、通常のビルドにはSiriとCarPlayの連携が含まれません。有効な場合、Siriのインテントはアクティブなワークスペースを検索し、曖昧さのない1件の音声結果だけを再生します。

検索のルール

標準のSiri連携は、アプリの実行中にも、起動していない状態からの起動時にも検索語を受け取ります。dosyaはアクティブなワークスペースを読み取る前に保存済みセッションを復元します。

ワークスペースの検索にはロールのaccess_files権限が必要です。標準の最初のページにはファイルとフォルダーの検索結果がそれぞれ最大50件返されます。dosyaは一致するフォルダーを残し、ファイルは音声と認識されたものに絞ります。音声ファイルがちょうど1件で、一致するフォルダーがない場合に限り、音声処理は検索結果という1曲の再生キューを作成して再生を試みます。

複数の音声結果、1件の音声とフォルダー、または音声なしのフォルダーは曖昧な結果として扱われます。フォルダーと音声がどちらも0件なら一致なしです。受信側は代替一覧も音声案内も提供しないため、いずれの場合も再生は変わりません。このSiri経路は2ページ目を要求しないため、最初のファイル50件またはフォルダー50件より後の一致は判断に影響しません。

唯一一致した音声もロックされていない必要があります。検索ではファイル自身のlock_modeが設定されたファイルも返され、現在の音声処理はこの場合も内部的にplayedと報告します。その後プレーヤーはロックされた曲を除外し、再生は変わらず、iPhoneに**このファイルは再生できません。**と表示します。

手順

1. iPhoneでサインインし、目的のワークスペースを選んで、access_files権限のあるロールを使ってください。
2. ロックされていない音声ファイルの名前から、フォルダー名と重ならない特徴的な部分を選んでください。
3. 停車中にdosyaのSiri音声インテントを起動し、その言葉を話してください。
4. 一意に一致した音声の再生が始まるのを待ってください。
5. Now Playingに表示された名前が目的のファイル名と一致するか確認してください。
6. 音が出ない場合は運転中に操作せず、後で検索語を調整するかフォルダーを閲覧してください。

結果

ロックされていない音声が1件見つかり、フォルダーと重複しなければ、1件の再生キューとして再生が始まります。検索で項目が変更されることはありません。

サインアウト中の起動、空の検索語、ワークスペースがない場合、APIの問題、曖昧な結果、一致なしの場合は再生が変わりません。エラーはCarPlayのアラートではなくiPhoneのログに記録されます。

トラブルシューティング

• Searchボタンがない。 Siriを使ってください。車内での文字入力検索はありません。
• 正確なタイトルでも何も起きない。 一致するフォルダー、もう1件の音声ファイル名、最初の50件より後の結果を確認してください。
• iPhoneに「このファイルは再生できません。」と表示される。 唯一一致した音声ファイルがロックされています。ファイルでロックを解除してからSiri検索をやり直してください。
• このロールでは検索結果がない。 ワークスペースの管理者にaccess_filesを依頼するか、すでに権限があるロールに切り替えてください。
• 別のワークスペースが検索される。 先にiPhoneのアクティブなワークスペースを変更してください。
• 起動していない状態から起動しても音が出ない。 サインインを復元し、停車中にもう一度試してください。
• PDFが検索語に一致する。 音声以外のファイルは除外されます。

関連ガイド

• メディアプレビューの操作
• モバイルでファイルを閲覧する