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


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世代)
  • Amazon Echo Show 15
  • Amazon Echo Pop

推奨事項

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

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

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

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

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

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

APLテンプレート 使用例 サンプル発話

Headline

中央揃えの短いメッセージを背景画像付きで表示する場合に使用します。施設のようこそ画面などに適しています。

「アレクサ、<施設用スキル名>を開いて」

Image list

画像とテキストのスクロールリストを表示する場合に使用します。以下のような応答に適しています。

  • レストランで提供されている料理とドリンクのリスト
  • 施設で利用できるサービスのリスト
  • 検索結果

「アレクサ、おすすめのレストランを教えて」

Text list

テキストベースの項目のスクロールリストを、必要に応じてヘッダーと背景画像を付けて表示する場合に使用します。メニュー項目などに適しています。このテンプレートは、リスト内の各項目に対応する画像がない場合に使用します。

「アレクサ、朝食は何?」

Detail

テキストと画像を表示して、サービス名、営業時間、場所、説明など、施設のサービスに関する情報を構造的に提示する場合に使用します。

「アレクサ、売店は開いてる?」

Karaoke

このテンプレートは、ほかのテンプレートが適さない場合に使用します。通常、2行を超える長文テキストを自動的にスクロールします。Alexaが話す内容と同じテキストを画面に表示できます。

「アレクサ、Wi-Fiに接続する方法を教えて」

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

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

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

ホーム画面でのローテーション表示にカードを追加するには、プロアクティブサジェスチョンREST APIを使用して、ユニットのリストを対象とするキャンペーンを作成します。各キャンペーンには、タイトル、本文、背景のURLなど、画面に表示するコンテンツを含めます。送信するサジェスチョンごとに1つのキャンペーンを作成します。

以下の例は、タイマーの設定方法を説明するカードを示しています。

クリップボードにコピーされました。


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/enterprise/suggestions/home/defaultTemplate"
                    },
                    "datasources": {
                        "displayText": {
                            "title": "タイマーをセットするには",
                            "body": "「{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"
        }
    }
}

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

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

サジェスチョンのタイプ タイトルテキスト 本文テキスト

アラーム

目覚ましをセットするには

「アレクサ、アラームを午前6時にセットして」と言ってみてください。

タイマー

タイマーをセットするには

「アレクサ、タイマーを10分にセットして」と言ってみてください。

エンターテインメント

Alexaで音楽を聴く

「アレクサ、音楽をかけて」と言ってみてください。

エンターテインメント

Alexaで好きなジャンルの音楽を聴く

「アレクサ、ジャズをかけて」と言ってみてください。

エンターテインメント

Alexaでラジオを聴く

「アレクサ、NHKラジオ第1を流して」と言ってみてください。

エンターテインメント

見たい番組を探すには

「アレクサ、今夜のテレビ番組は?」と言ってみてください。

ニュース

フラッシュニュースを聞くには

「アレクサ、ニュースを流して」と言ってみてください。

コミュニケーション

ゲストサービスに連絡するには

「アレクサ、フロントに電話して」と言ってみてください。

スマートホーム

室温を調整するには

「アレクサ、温度を21度に設定して」と言ってみてください。

スマートホーム

音声でカーテンを開閉する

「アレクサ、カーテンを閉めて」と言ってみてください。

施設固有のようこそ画面

こんにちは、アレクサです

「アレクサ、何ができる?」と言ってみてください。

施設固有のようこそ画面

こちらは<施設名>です

「アレクサ、施設について教えて」と言ってみてください。

施設情報

Wi-Fiに接続するには

「アレクサ、Wi-Fiに接続する方法を教えて」と言ってみてください。

施設情報

チェックアウト時刻は午前11時です

「アレクサ、チェックアウトを延長できる?」と言ってみてください。

施設サービス

お部屋の清掃が必要な場合

「アレクサ、部屋を掃除して」と言ってみてください。

施設サービス

朝食メニューを確認する

「アレクサ、朝食は何?」と言ってみてください。

施設サービス

お車が必要な場合

「アレクサ、タクシーを頼んで」と言ってみてください。

施設サポート

お困りですか?

「アレクサ、ヘルプをお願い」と言ってみてください。

固定視覚アラートを送信する

固定視覚アラートはプロアクティブサジェスチョンと似ていますが、異なる点として、有効期限が切れるかゲストがアラートを解除するまで、カードが画面上に表示され続けます。今後のイベント、予定、ゲストにとって重要なその他の情報には、固定視覚アラートを使用します。ゲストが音声またはタップ操作で作成した予約や予定ごとに、個別のアラートを設定できます。

固定視覚アラートを発行するには、通知APIを使用して、表示するコンテンツと有効期限を指定します。

以下の例は、ゲストにウォーキングを促す視覚アラートを示しています。

クリップボードにコピーされました。


POST /v3/notifications HTTP/1.1
Host: api.amazonalexa.com
Accept: application/json
Authorization: Bearer {access token}
{
    "recipients": [{
            "type": "Unit",
            "id": "amzn1.alexa.unit.did.unitId1"
        },
        {
            "type": "Unit",
            "id": "amzn1.alexa.unit.did.unitId2"
        }
    ],
    "notification": {
        "variants": [{
            "type": "PersistentVisualAlert",
            "content": {
                "variants": [{
                    "type": "V0Template",
                    "values": [{
                        "locale": "ja-JP",
                        "document": {
                            "type": "Link",
                            "src": "doc://alexa/apl/documents/enterprise/notifications/persistentvisualalert/defaultTemplate"
                        },
                        "datasources": {
                            "displayText": {
                                "title": "エクササイズリマインダー",
                                "body": "ウォーキングの時間です。"
                            },
                            "background": {
                                "backgroundImageSource": "https://www.example.com/image.jpg"
                            }
                        }
                    }]
                }]
            },
            "dismissalTime": "2021-04-30T10:15:00.00Z"
        }]
    }
}

固定視覚アラートの例

以下の表に、ゲストに表示できる固定アラートの例を示します。

アラートのタイプ タイトルテキスト 本文テキスト

アクティビティ

エクササイズリマインダー

ウォーキングの時間です。

アクティビティ

今夜午後7時、<アクティビティ>

<アクティビティ>にご参加ください。

予定

<予定>リマインダー

<予定>が午後3時から始まります。

サービス

朝食

朝食は午後1時まで提供されます。

メンテナンス

テレビの修理が完了しました

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

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

質問: 表示できるカードの最大数はいくつですか?
プロアクティブサジェスチョンはいくつでも送信できますが、Alexaに表示できるカードの最大数は20です。Alexaは、作成日時に基づいて最初の20件のカードを新着順に表示します。
質問: Alexaは、プロアクティブサジェスチョンをどのような時間配分で表示しますか?
Alexaは、開発者提供のカードとAlexa提供のカードを4:1の割合で表示します。
質問: 背景画像のサイズ制限を教えてください。
アラートでの画像の最大サイズは100KBです。
質問: Alexaでサポートされる背景画像の形式を教えてください。
アラートの画像では、JPG画像形式がサポートされています。
質問: デバイスのViewportとサイズまたはアスペクト比が一致しない画像を指定するにはどうすればよいですか?
固定視覚アラートの画像は、Viewportのサイズに合わせて拡大または縮小されます。
質問: 視覚アラートとプロアクティブサジェスチョンは、低電力モードでどのように動作しますか?
固定視覚アラートが表示されている場合、デバイスは低電力モードに移行しません。プロアクティブサジェスチョンは低電力モードには影響しません。
質問: キャンペーンに追加できるサジェスチョンの数はいくつですか?
1つのキャンペーンに1つのサジェスチョンを追加できます。Alexaで複数のカードを表示するには、サジェスチョンごとに1つずつキャンペーンを作成します。
質問: 視覚アラートやプロアクティブサジェスチョンのタイトルと本文は必須プロパティですか?
はい。どちらもインターフェースの必須プロパティです。
質問: プロアクティブサジェスチョンで指定する終了日に上限はありますか?
いいえ。任意の終了日を指定できます。
質問: プロアクティブサジェスチョンREST APIリクエストの送信後、カードが表示されるまでの時間はどのくらいですか?
通常、Alexaは、リクエストを受信してから2時間以内に画面上にアラートを表示します。ゲストがデバイスの電源を入れ直した場合は、デバイスでそれまでのローテーションがリセットされ、最新のサジェスチョンが表示されます。
質問: 通知REST APIリクエストの送信後、アラートが表示されるまでの時間はどのくらいですか?
通常、Alexaは、リクエストを受信してから5分以内に画面上にアラートを表示します。


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

最終更新日: 2023 年 11 月 30 日