開発する公開SystemインターフェースSystemインターフェースv1.1v1.1v1.0Systemインターフェースは、複数のクライアントコンポーネントに及ぶイベントを提供します。バージョンの変更点SoftwareInfoイベントを送信してReportSoftwareInfoディレクティブを受信するには、機能APIを使用してバージョン1.1の宣言をする必要があります。機能APIバージョン1.1のSystemインターフェースを使用するには、機能APIの呼び出し内で宣言する必要があります。その他の詳細については、機能APIを参照してください。}SynchronizeStateイベントSynchronizeStateイベントは、新しい接続が確立されたときに、すべての製品コンポーネントの状態を更新するためにAVSに送信される必要があります。}コンテキストこのイベントでは、製品がAlexaに対して、すべてのクライアントコンポーネントのステータスをコンテキストオブジェクトに格納して報告しなければならない。その他の情報については、コンテキストを参照してください。特定のメッセージを表すのに使用される一意のIDです。空のペイロードを送信する必要があります。UserInactivityReportイベントこのイベントは非アクティブな1時間が経過した後、ユーザーのアクションが行われるまでの間1時間ごとに送信される必要があります。このイベントにより、Alexaに最後に操作が検知されてからの経過時間が提供されます。ユーザー操作は製品内にユーザーが存在していると確認できるアクションとして定義されます。製品上のボタンの操作、Alexaとの対話、GUIアフォーダンスの使用などです。ユーザー操作が検知されたら、非アクティブ状態のトラッキングに使用するタイマーを0にリセットする必要があります。ヒント:inactiveTimeInSecondsに提供される値は、常に3600(1時間)の倍数になる必要があります。非アクティブな時間が4時間の場合、値は14400となります。特定のメッセージを表すのに使用される一意のIDです。前回のユーザーとの対話からの時間(秒)です。longResetUserInactivityディレクティブResetUserInactivityディレクティブは、UserInactivityReportによって使用される非アクティブタイマーをリセットするために、クライアントに送信されます。Alexaアプリ上でのユーザーとの対話によってこのディレクティブがトリガーされます。特定のメッセージを表すのに使用される一意のIDです。文字列SetEndpointディレクティブ以下の状況に該当する場合、SetEndpointディレクティブはクライアントにエンドポイントを変更するよう指示します。ユーザーの国/地域の設定が、接続された先のエンドポイントでサポートされていない場合。Amazonサイト上の「コンテンツと端末の管理」ページでユーザーの国/地域の設定が英国(UK)に設定されており、クライアントが米国(US)のエンドポイントに接続した場合、SetEndpointディレクティブが送信されてクライアントにUKをサポートするエンドポイントに接続するよう指示します。ユーザーが国/地域の設定(または住所)を変更した場合。USのエンドポイントに接続したユーザーが国/地域の設定をUSからUKに変更すると、SetEndpointディレクティブが送信されてクライアントにUKをサポートするエンドポイントに接続するよう指示します。重要:エンドポイントの切り替えに失敗すると、ユーザーがカスタム設定や国、地域固有のコンテンツにアクセスできなくなる場合があります。特定のメッセージを表すのに使用される一意のIDです。ユーザーの国/地域設定をサポートするAVSエンドポイントのURLです。エンドポイントのURLには、プロトコルおよび/またはポートが含まれる場合があります。文字列SoftwareInfoイベントこのイベントは、ファームウェアのバージョンなど、製品のソフトウェア情報をAlexaに伝えます。以下のようなシナリオで送信される必要があります。永続性メモリを持つ製品の場合、イベントは製品の初回起動時と、ファームウェアバージョンがアップデートされるたびに送信される必要があります。永続性メモリを持たない製品の場合、イベントは製品の起動/再起動時に送信される必要があります。ReportSoftwareInfoディレクティブの受信時。イベントが正常に処理されたら、製品は204のHTTPステータスコード(本文は空)を受信します。イベントが処理されない場合、製品は500のHTTPステータスコードと例外メッセージを受信します。identifier(UUID)です。文字列として表される正符号付き32ビット整数です。400ステータスコードが返されます。重要:"0"は有効なファームウェアバージョンではありません。無効"123""8701""20170207""50.3""avs-123.4x""ask.201-(1.23.4-test)"文字列ReportSoftwareInfoディレクティブこのディレクティブは、製品に対して現在のソフトウェア情報をSoftwareInfoイベントを使用してAlexaに報告するよう指示します。identifier(UUID)です。文字列ExceptionEncounteredイベントAVSからのディレクティブを実行できないとき、クライアントはこのイベントを送信する必要があります。}コンテキストこのイベントでは、製品がAlexaに対して、すべてのクライアントコンポーネントのステータスをコンテキストオブジェクトに格納して報告しなければならない。その他の情報については、コンテキストを参照してください。特定のメッセージを表すのに使用される一意のIDです。ディレクティブを実行できないとき、クライアントはAVSに対してディレクティブを文字列として返す必要があります。エラーのキー/値ペアです。ディレクティブを実行できないときに、クライアントがAVSに返す必要があるエラーです。ログやトラブルシューティング用のその他のエラー詳細です。クライアントに送信されたディレクティブの形式が正しくない、またはペイロードがディレクティブの仕様に準拠していません。デバイスがディレクティブを処理中にエラーが発生し、そのエラーが指定されたカテゴリーに当てはまりません。警告:これはSystemインターフェースの現行バージョンではありません。一部の機能がサポートされない場合があります。目的の機能ではない場合、インターフェースのバージョンを選択を使用して正しいバージョンに変更してください。Systemインターフェースは、複数のクライアントコンポーネントに及ぶイベントを提供します。バージョンの変更点ドキュメントの誤りを修正しました。SoftwareInfoイベントとReportSoftwareInfoディレクティブがSystemインターフェースのバージョン1.1に移動されました。バージョンを切り替えるには、このページの上部にあるバージョン選択をお試しください。機能APIバージョン1.0のSystemインターフェースを使用するには、機能APIの呼び出し内で宣言する必要があります。その他の詳細については、機能APIを参照してください。}SynchronizeStateイベントSynchronizeStateイベントは、新しい接続が確立されたときに、すべての製品コンポーネントの状態を更新するためにAVSに送信される必要があります。}コンテキストこのイベントでは、製品がAlexaに対して、すべてのクライアントコンポーネントのステータスをコンテキストオブジェクトに格納して報告しなければならない。その他の情報については、コンテキストを参照してください。特定のメッセージを表すのに使用される一意のIDです。空のペイロードを送信する必要があります。UserInactivityReportイベントこのイベントは非アクティブな1時間が経過した後、ユーザーのアクションが行われるまでの間1時間ごとに送信される必要があります。このイベントにより、Alexaに最後に操作が検知されてからの経過時間が提供されます。ユーザー操作は製品内にユーザーが存在していると確認できるアクションとして定義されます。製品上のボタンの操作、Alexaとの対話、GUIアフォーダンスの使用などです。ユーザー操作が検知されたら、非アクティブ状態のトラッキングに使用するタイマーを0にリセットする必要があります。ヒント:inactiveTimeInSecondsに提供される値は、常に3600(1時間)の倍数になる必要があります。非アクティブな時間が4時間の場合、値は14400となります。特定のメッセージを表すのに使用される一意のIDです。前回のユーザーとの対話からの時間(秒)です。longResetUserInactivityディレクティブResetUserInactivityディレクティブは、UserInactivityReportによって使用される非アクティブタイマーをリセットするために、クライアントに送信されます。Alexaアプリ上でのユーザーとの対話によってこのディレクティブがトリガーされます。特定のメッセージを表すのに使用される一意のIDです。文字列SetEndpointディレクティブ以下の状況に該当する場合、SetEndpointディレクティブはクライアントにエンドポイントを変更するよう指示します。ユーザーの国/地域の設定が、接続された先のエンドポイントでサポートされていない場合。Amazonサイト上の「コンテンツと端末の管理」ページでユーザーの国/地域の設定が英国(UK)に設定されており、クライアントが米国(US)のエンドポイントに接続した場合、SetEndpointディレクティブが送信されてクライアントにUKをサポートするエンドポイントに接続するよう指示します。ユーザーが国/地域の設定(または住所)を変更した場合。USのエンドポイントに接続したユーザーが国/地域の設定をUSからUKに変更すると、SetEndpointディレクティブが送信されてクライアントにUKをサポートするエンドポイントに接続するよう指示します。重要:エンドポイントの切り替えに失敗すると、ユーザーがカスタム設定や国、地域固有のコンテンツにアクセスできなくなる場合があります。特定のメッセージを表すのに使用される一意のIDです。ユーザーの国/地域設定をサポートするAVSエンドポイントのURLです。エンドポイントのURLには、プロトコルおよび/またはポートが含まれる場合があります。文字列ExceptionEncounteredイベントAVSからのディレクティブを実行できないとき、クライアントはこのイベントを送信する必要があります。}コンテキストこのイベントでは、製品がAlexaに対して、すべてのクライアントコンポーネントのステータスをコンテキストオブジェクトに格納して報告しなければならない。その他の情報については、コンテキストを参照してください。特定のメッセージを表すのに使用される一意のIDです。ディレクティブを実行できないとき、クライアントはAVSに対してディレクティブを文字列として返す必要があります。エラーのキー/値ペアです。ディレクティブを実行できないときに、クライアントがAVSに返す必要があるエラーです。ログやトラブルシューティング用のその他のエラー詳細です。クライアントに送信されたディレクティブの形式が正しくない、またはペイロードがディレクティブの仕様に準拠していません。デバイスがディレクティブを処理中にエラーが発生し、そのエラーが指定されたカテゴリーに当てはまりません。