AudioActivityTrackerインターフェース(v1.0)

フォーカス管理により、特にユーザーのリクエストがあいまいな場合のAlexaからの応答の精度が向上しました。フォーカスはクラウドで管理されます。クライアントは、オーディオチャンネルのフォーカスがあるのはどのインターフェースかをAlexaに知らせ、該当する場合は各チャンネルのアイドル時間をレポートします。この状態情報は、AudioActivityTracker名前空間のcontextコンテナで送信されます。

一般的な使用例と、チャンネルマッピングのすべてのインターフェースについては、フォーカス管理を参照してください。

機能API

AudioActivityTrackerインターフェースのバージョン1.0を使用するには、機能APIの呼び出し内で宣言する必要があります。詳細については、機能APIを参照してください。

{
    "type": "AlexaInterface",
    "interface": "AudioActivityTracker",
    "version": "1.0"
}

AudioActivityTrackerのコンテキスト

このコンテキストオブジェクトは、前回オーディオチャンネルを占有していたのはどのインターフェースかを知らせます。チャンネル(に続いてインターフェース)がアクティブの場合、idleTimeInMilliseconds0です。チャンネルが非アクティブの場合、idleTimeInMillisecondsは、そのチャンネルがフォーカスを得てから経過した時間になります。

チャンネルが使用されない場合は、AudioActivityTrackerのコンテキストから除外する必要があります。

{
    "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