AudioActivityTrackerインターフェース(v1.0)
フォーカス管理により、特にユーザーのリクエストがあいまいな場合のAlexaからの応答の精度が向上しました。フォーカスはクラウドで管理されます。クライアントは、オーディオチャンネルのフォーカスがあるのはどのインターフェースかをAlexaに知らせ、該当する場合は各チャンネルのアイドル時間をレポートします。この状態情報は、AudioActivityTracker
名前空間のcontext
コンテナで送信されます。
一般的な使用例と、チャンネルマッピングのすべてのインターフェースについては、フォーカス管理を参照してください。
機能API
AudioActivityTrackerインターフェースのバージョン1.0を使用するには、機能APIの呼び出し内で宣言する必要があります。詳細については、機能APIを参照してください。
{ "type": "AlexaInterface", "interface": "AudioActivityTracker", "version": "1.0" }
AudioActivityTrackerのコンテキスト
このコンテキストオブジェクトは、前回オーディオチャンネルを占有していたのはどのインターフェースかを知らせます。チャンネル(に続いてインターフェース)がアクティブの場合、idleTimeInMilliseconds
は0
です。チャンネルが非アクティブの場合、idleTimeInMilliseconds
は、そのチャンネルがフォーカスを得てから経過した時間になります。
チャンネルが使用されない場合は、AudioActivityTracker
のコンテキストから除外する必要があります。
重要:
idleTimeInMilliseconds
は、レポートされる各チャンネルに必須です。{ "header": { "namespace": "AudioActivityTracker", "name": "ActivityState" }, "payload": { "dialog": { "interface": "{{STRING}}", "idleTimeInMilliseconds": {{LONG}} }, "alert": { "interface": "{{STRING}}", "idleTimeInMilliseconds": {{LONG}} }, "content": { "interface": "{{STRING}}", "idleTimeInMilliseconds": {{LONG}} } } }
ペイロードのパラメーター
パラメーター | 説明 | 型 |
---|---|---|
dialog | 現在ダイアログチャンネルのフォーカスがあるインターフェースについての情報を含むオブジェクトです。チャンネルが使用されない場合は、`AudioActivityTracker`のコンテキストから除外する必要があります。 | オブジェクト |
dialog.interface | インターフェースにダイアログチャンネルのフォーカスがあることを表します。
有効な値:"SpeechSynthesizer"。 |
文字列 |
dialog.idleTimeInMilliseconds | このチャンネルで最後にアクションが発生してからの経過時間をミリ秒で表します。 | long |
alert | 現在アラートチャンネルのフォーカスがあるインターフェースについての情報を含むオブジェクトです。チャンネルが使用されない場合は、`AudioActivityTracker`のコンテキストから除外する必要があります。 | オブジェクト |
alert.interface | インターフェースにアラートチャンネルのフォーカスがあることを表します。
有効な値:"Alerts"。 |
文字列 |
alert.idleTimeInMilliseconds | このチャンネルで最後にアクションが発生してからの経過時間をミリ秒で表します。 | long |
content | 現在コンテンツチャンネルのフォーカスがあるインターフェースについての情報を含むオブジェクトです。チャンネルが使用されない場合は、`AudioActivityTracker`のコンテキストから除外する必要があります。 | オブジェクト |
content.interface | インターフェースにコンテンツチャンネルのフォーカスがあることを表します。
有効な値:"AudioPlayer"、"Bluetooth"。 |
文字列 |
content.idleTimeInMilliseconds | このチャンネルで最後にアクションが発生してからの経過時間をミリ秒で表します。 | long |