Alexa Smart Properties用のマルチモーダルデバイスをカスタマイズする

Alexa Smart Propertiesでは、Alexaを搭載したマルチモーダルデバイスにレンダリングされる視覚コンテンツによって音声エクスペリエンスを補完できます。ホーム画面を利用して、施設の詳細情報を共有したり、音声またはタップ操作でサービスを注文できるようにしたり、イベント、最新情報、スキルに関する情報をゲストに提供したりできます。

施設用スキルには、ゲストが音声またはタップでマルチモーダルデバイスを操作しているときにAlexaで表示する視覚要素を追加できます。たとえば、ゲストが「アレクサ、朝食は何時？」と問いかけたら、朝食の時間、場所、メニューを表示することができます。また、ゲストがデバイスを操作していないときにAlexaで表示する視覚要素も追加できます。たとえば、今後のイベント情報や施設案内をゲストに提供する画像や視覚メッセージを追加することが可能です。

施設用スキルまたは施設管理アプリから視覚要素を送信する場合は、以下のガイドラインに従ってください。

サポートされるデバイス

Alexa Smart Propertiesでは、以下のAmazon Echoマルチモーダルデバイスを使用できます。

• Amazon Echo Show 5（第1、第2、第3世代）
• Amazon Echo Show 8（第1、第2、第3世代）
• Amazon Echo Show 15

推奨事項

施設内にマルチモーダルデバイスがある場合、Amazonでは、以下の視覚要素を使用してホーム画面をカスタマイズすることを推奨します。

• Alexa Presentation Language（APL）を使用して、施設用スキルからの音声応答と共に、視覚応答を送信します。
• Alexaが施設の場所に基づいてデフォルトの天気カードを表示できるように、デバイスの所在地を正しく設定します。Alexa搭載デバイスの所在地を更新するには、POST住所設定APIを使用します。
• ゲストがデバイスを操作していないときに表示するプロアクティブサジェスチョンを7件以上用意します。Alexaは、各サジェスチョンをローテーションで表示します。サジェスチョンには、以下の情報を含める必要があります。
  • Alexaの機能に関するサジェスチョンを3件。たとえば、音量の変更方法を表示できます。
  • 施設の機能に関するサジェスチョンを4件。たとえば、Wi-Fiへの接続方法や、レストランの営業時間を表示できます。
• ユーザーがアラートを解除するまでデバイスに表示され続ける視覚情報を設定するには、固定視覚アラートを使用します。固定視覚アラートには、プレミアムマルチモーダルアドオン機能が必要です。このアドオンの詳細については、プレミアムマルチモーダルを参照してください。視覚アラートの作成方法の詳細については、固定視覚アラートを作成して管理するを参照してください。

スキルからの視覚応答を追加する

施設用スキルからの音声応答を視覚応答で補完すると、詳細情報を提供したり、ゲストがタップ操作でオプションを選択できるようにしたり、施設の画像を表示したり、その他さまざまな処理が可能になります。たとえば、ゲストにレストランの開店時間をたずねられたら、スキルは音声で応答するとともに、その日のレストランの営業時間を画面に表示できます。

スキルからの視覚応答の送信は、APLを使用して行うことができます。APLは、Alexa搭載マルチモーダルデバイスに視覚要素を構築する、レスポンシブ対応のレイアウト言語です。より簡単に視覚応答を作成するには、独自のレイアウトを開発する代わりに、APLのレスポンシブ対応コンポーネントとテンプレートを使用できます。レスポンシブ対応コンポーネントとテンプレートを使用する方法では、テンプレートを選択し、表示するデータを入力します。スキルコードに視覚応答を追加する方法の詳細については、スキルにAPLサポートを追加するを参照してください。

以下の表に、施設用スキルに適した推奨されるAPLテンプレートを示します。

プロアクティブサジェスチョンを送信する

プロアクティブサジェスチョンを使用すると、Alexa搭載マルチモーダルデバイスに視覚コンテンツを表示して、施設に関する情報（イベント、サービス、アメニティなど）をゲストに提供できます。Alexaは、これらのサジェスチョンをホーム画面にカードとして表示します。ゲストからの問い合わせに応答していないとき、Alexaは、カードをローテーションして最新のサジェスチョンを最初に表示します。

施設に合わせて視覚コンテンツをカスタマイズし、スケジュールに従ってサジェスチョンを送信します。このコンテンツは、ゲストにAlexa機能の使い方を案内するAlexa提供のカードと、施設に関する情報を表示する開発者提供のカードの組み合わせにする必要があります。プロアクティブサジェスチョンは、施設情報やイベント、天気、ニュースなど、緊急でないコンテンツに適しています。また、ゲストのモバイルデバイスをAlexaに接続する方法や、施設のWi-Fiに接続する方法など、ゲストに役立つ情報も表示できます。

ホーム画面でのローテーション表示にカードを追加するには、プロアクティブサジェスチョンREST APIを使用して、ユニットのリストを対象とするキャンペーンを作成します。各キャンペーンには、画面に表示するコンテンツを含めます。APIでは、コンテンツを表示するために選択できるテンプレートセットが用意されています。テンプレートの詳細については、キャンペーンテンプレートを参照してください。送信するサジェスチョンごとに1つのキャンペーンを作成します。各テンプレートには背景画像を含めることができます。

または、Alexa Smart Propertiesコンソールを使用してプロアクティブサジェスチョンを作成することもできます。詳細については、マネジメントコンソールでコンテンツを管理するを参照してください。

固定のプロアクティブサジェスチョンのテンプレートでは、背景画像がサポートされます。画像の詳細については、プロアクティブサジェスチョンと視覚アラートの背景画像を参照してください。

以下は、テキスト折り返しテンプレートを使用して、タイマーの設定方法を説明するカードを表示する例です。

POST /v1/proactive/campaigns HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {access token}
{
  "suggestion": {
    "variants": [
      {
        "placement": {
          "channel": "HOME"
        },
        "content": {
          "values": [
            {
              "locale": "ja-JP",
              "document": {
                "type": "Link",
                "src": "doc://alexa/apl/documents/home/cards/textWrapping"
              },
              "datasources": {
                "displayText": {
                  "primaryText": "タイマーをセットするには",
                  "secondaryText": "「{WakeWord}、タイマーを10分にセットして」と言ってみてください。"
                },
                "background": {
                  "backgroundImageSource": "https://www.example.com/image.jpg"
                }
              }
            }
          ]
        }
      }
    ]
  },
  "targeting": {
    "type": "UNITS",
    "values": [
      {
        "id": "amzn1.alexa.unit.did.unitId1"
      }
    ]
  },
  "scheduling": {
    "activationWindow": {
      "end": "2022-12-31T00:00:00.00Z"
    }
  }
}

プロアクティブサジェスチョンの例

以下の表に、ゲストに表示できるサジェスチョンの例を示します。

プロアクティブサジェスチョンと視覚アラートの背景画像

プロアクティブサジェスチョンと視覚アラートには、どちらも背景画像を指定できます。画像については、以下のガイドラインを参考にしてください。

• PNGまたはJPG形式の画像を指定できます。
• 画像ファイルのサイズは400KB以内にする必要があります。
• 各テンプレートでは、画面全体に表示されるように画像のサイズが均一に拡大または縮小されます（「best-fill」）。つまり、画像のアスペクト比とデバイス画面のアスペクト比が一致しない場合は、画像が途切れる可能性があります。そのため、以下の推奨事項を検討してください。
  • 画像の端までテキストがある画像は使用しないでください。画像のサイズ調整によって、テキストが切り詰められる可能性があります。
  • 可能であれば、ユニットで使用されているものと同じタイプのデバイスで、画像をテストしてください。
  • 別々のユニットに異なるデバイスが含まれている場合は、デバイスに合わせて画像を最適化できるように、異なるカードまたはアラートを使用して個々のユニットをターゲットにすることを検討してください。この方法は、同一のユニット内ですべてのデバイスのアスペクト比が同じである場合に有効です。

マルチモーダルデバイスに関するよくある質問

Alexa搭載マルチモーダルデバイスのカスタマイズに関するよくある質問（FAQ）を以下に示します。

質問： 表示できるカードの最大数はいくつですか？

プロアクティブサジェスチョンはいくつでも送信できますが、Alexaに表示できるカードの最大数は20です。Alexaは、作成日時に基づいて最初の20件のカードを新着順に表示します。

質問： Alexaは、プロアクティブサジェスチョンをどのような時間配分で表示しますか？

Alexaは、開発者提供のカードとAlexa提供のカードを4:1の割合で表示します。

質問： 背景画像のサイズ制限を教えてください。

アラートでの画像の最大サイズは400KBです。画像の詳細については、前述のプロアクティブサジェスチョンと視覚アラートの背景画像を参照してください。

質問： Alexaでサポートされる背景画像の形式を教えてください。

アラートの画像では、JPGまたはPNGの画像形式がサポートされています。画像の詳細については、前述のプロアクティブサジェスチョンと視覚アラートの背景画像を参照してください。

質問： デバイスのViewportとサイズまたはアスペクト比が一致しない画像を指定するにはどうすればよいですか？

アラートやプロアクティブサジェスチョンの場合は、テンプレートによって画面全体に表示されるように画像のサイズが均一に拡大または縮小されます（「best-fill」）。画像の詳細については、前述のプロアクティブサジェスチョンと視覚アラートの背景画像を参照してください。

施設用スキルの応答で提供するAPLドキュメントの場合は、画像のサイズを拡大または縮小する方法を指定できます。これらの応答の推奨テンプレートには、それぞれbackgroundScaleパラメーターが含まれています。この設定によって、画像サイズの調整方法が決まります。Headlineなどを参照してください。

質問： 視覚アラートとプロアクティブサジェスチョンは、低電力モードでどのように動作しますか？

固定視覚アラートが表示されている場合、デバイスは低電力モードに移行しません。プロアクティブサジェスチョンは低電力モードには影響しません。

質問： キャンペーンに追加できるサジェスチョンの数はいくつですか？

1つのキャンペーンに1つのサジェスチョンを追加できます。Alexaで複数のカードを表示するには、サジェスチョンごとに1つずつキャンペーンを作成します。

質問： 視覚アラートやプロアクティブサジェスチョンの必須プロパティを教えてください。

必須プロパティは、アラートやサジェスチョンに使用するテンプレートによって異なります。たとえば、テキスト折り返しテンプレートでは、primaryTextプロパティが必須となります。プロアクティブサジェスチョンのテンプレートの詳細については、キャンペーンテンプレートを参照してください。アラートのテンプレートの詳細については、固定視覚アラートテンプレートを参照してください。

質問： プロアクティブサジェスチョンで指定する終了日に上限はありますか？

いいえ。任意の終了日を指定できます。

質問： プロアクティブサジェスチョンREST APIリクエストの送信後、カードが表示されるまでの時間はどのくらいですか？

通常、Alexaは、リクエストを受信してから2時間以内に画面上にアラートを表示します。ゲストがデバイスの電源を入れ直した場合は、デバイスでそれまでのローテーションがリセットされ、最新のサジェスチョンが表示されます。

質問： 通知REST APIリクエストの送信後、アラートが表示されるまでの時間はどのくらいですか？

通常、Alexaは、リクエストを受信してから5分以内に画面上にアラートを表示します。

関連トピック

• 視覚デザイン： Alexa Presentation Language
• チュートリアル： 視覚応答をカスタムスキルに追加する
• Alexa Smart Propertiesについて

最終更新日: 2024 年 06 月 19 日