スキルリクエスト内のウィジェットに関する情報

スキルリクエスト内のウィジェットに関する情報

スキルにウィジェットが含まれている場合、スキルに送信されるリクエストには、そのウィジェットに関する追加情報が含まれる場合があります。特定のリクエストの詳細は、ユーザーのデバイスにウィジェットがインストールされているかどうか、ユーザーがリクエストを行ったときにウィジェットが表示されていたかどうかなど、さまざまな要因によって異なります。スキルに関連付けられていないウィジェットの情報がリクエストに含まれることはありません。

ウィジェットの視覚コンテキスト

Alexa.Presentation[contexts]配列には、リクエスト時にデバイスに表示されていたウィジェットのAlexa Presentation Language（APL）視覚コンテキストを表すAlexa.Presentation.APLオブジェクトが格納されます。配列に含まれるのは、スキルに関連付けられたウィジェットのうち、表示されていた各ウィジェットの視覚コンテキストです。

ウィジェットを識別できるように、オブジェクトにはpresentationUriが含まれています。さらに、このオブジェクトはcomponentsVisibleOnScreenを提供します。これは、ウィジェットでユーザーに表示されていたAPLコンポーネントの詳細を示す配列です。

componentsVisibleOnScreenで使用されるルールと構造は、完全なAPLドキュメントの視覚コンテキストと同じです。詳細については、スキルリクエストのAPL視覚コンテキストを参照してください。

このページは役に立ちましたか？

最終更新日: 2025 年 12 月 23 日