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への接続方法や、レストランの営業時間を表示できます。
- ユーザーがアラートを解除するまでデバイスに表示され続ける視覚情報を設定するには、固定視覚アラートを使用します。視覚アラートを送信するには、通知APIまたはAlexa Smart Propertiesコンソールを使用します。
スキルからの視覚応答を追加する
施設用スキルからの音声応答を視覚応答で補完すると、詳細情報を提供したり、ゲストがタップ操作でオプションを選択できるようにしたり、施設の画像を表示したり、その他さまざまな処理が可能になります。たとえば、ゲストにレストランの開店時間をたずねられたら、スキルは音声で応答するとともに、その日のレストランの営業時間を画面に表示できます。
スキルからの視覚応答の送信は、APLを使用して行うことができます。APLは、Alexa搭載マルチモーダルデバイスに視覚要素を構築する、レスポンシブ対応のレイアウト言語です。より簡単に視覚応答を作成するには、独自のレイアウトを開発する代わりに、APLのレスポンシブ対応コンポーネントとテンプレートを使用できます。レスポンシブ対応コンポーネントとテンプレートを使用する方法では、テンプレートを選択し、表示するデータを入力します。スキルコードに視覚応答を追加する方法の詳細については、スキルにAPLサポートを追加するを参照してください。
以下の表に、施設用スキルに適した推奨されるAPLテンプレートを示します。
| APLテンプレート | 使用例 | サンプル発話 |
|---|---|---|
|
中央揃えの短いメッセージを背景画像付きで表示する場合に使用します。施設のようこそ画面などに適しています。 |
「アレクサ、<施設用スキル名>を開いて」 | |
|
画像とテキストのスクロールリストを表示する場合に使用します。以下のような応答に適しています。
|
「アレクサ、おすすめのレストランを教えて」 | |
|
テキストベースの項目のスクロールリストを、必要に応じてヘッダーと背景画像を付けて表示する場合に使用します。メニュー項目などに適しています。このテンプレートは、リスト内の各項目に対応する画像がない場合に使用します。 |
「アレクサ、朝食は何？」 | |
|
テキストと画像を表示して、サービス名、営業時間、場所、説明など、施設のサービスに関する情報を構造的に提示する場合に使用します。 |
「アレクサ、売店は開いてる？」 | |
|
このテンプレートは、ほかのテンプレートが適さない場合に使用します。通常、2行を超える長文テキストを自動的にスクロールします。Alexaが話す内容と同じテキストを画面に表示できます。 |
「アレクサ、Wi-Fiに接続する方法を教えて」 |
プロアクティブサジェスチョンを送信する
プロアクティブサジェスチョンを使用すると、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"
}
}
}
プロアクティブサジェスチョンの例
以下の表に、ゲストに表示できるサジェスチョンの例を示します。
| サジェスチョンのタイプ | 第1テキスト | 第2テキスト |
|---|---|---|
|
アラーム |
目覚ましをセットするには |
「アレクサ、アラームを午前6時にセットして」と言ってみてください。 |
|
タイマー |
タイマーをセットするには |
「アレクサ、タイマーを10分にセットして」と言ってみてください。 |
|
エンターテインメント |
Alexaで音楽を聴く |
「アレクサ、音楽をかけて」と言ってみてください。 |
|
エンターテインメント |
Alexaで好きなジャンルの音楽を聴く |
「アレクサ、ジャズをかけて」と言ってみてください。 |
|
エンターテインメント |
Alexaでラジオを聴く |
「アレクサ、NHKラジオ第1を流して」と言ってみてください。 |
|
エンターテインメント |
見たい番組を探すには |
「アレクサ、今夜のテレビ番組は？」と言ってみてください。 |
|
ニュース |
フラッシュニュースを聞くには |
「アレクサ、ニュースを流して」と言ってみてください。 |
|
コミュニケーション |
ゲストサービスに連絡するには |
「アレクサ、フロントに電話して」と言ってみてください。 |
|
スマートホーム |
室温を調整するには |
「アレクサ、温度を21度に設定して」と言ってみてください。 |
|
スマートホーム |
音声でカーテンを開閉する |
「アレクサ、カーテンを閉めて」と言ってみてください。 |
|
施設固有のようこそ画面 |
こんにちは、アレクサです |
「アレクサ、何ができる？」と言ってみてください。 |
|
施設固有のようこそ画面 |
こちらは<施設名>です |
「アレクサ、施設について教えて」と言ってみてください。 |
|
施設情報 |
Wi-Fiに接続するには |
「アレクサ、Wi-Fiに接続する方法を教えて」と言ってみてください。 |
|
施設情報 |
チェックアウト時刻は午前11時です |
「アレクサ、チェックアウトを延長できる？」と言ってみてください。 |
|
施設サービス |
お部屋の清掃が必要な場合 |
「アレクサ、部屋を掃除して」と言ってみてください。 |
|
施設サービス |
朝食メニューを確認する |
「アレクサ、朝食は何？」と言ってみてください。 |
|
施設サービス |
お車が必要な場合 |
「アレクサ、タクシーを頼んで」と言ってみてください。 |
|
施設サポート |
お困りですか？ |
「アレクサ、ヘルプをお願い」と言ってみてください。 |
固定視覚アラートを送信する
固定視覚アラートは、画面付きデバイスに視覚アラートを表示する通知です。このアラートは、ゲストや居住者が解除するか、有効期限が切れるまで、デバイスに表示され続けます。固定視覚アラートは、ユーザーが解除するまでデバイスに「固定」されたままになるため、「固定カード」と呼ばれることもあります。今後のイベント、予定、ゲストや居住者に確認してもらいたいその他の情報には、固定視覚アラートを使用します。
固定視覚アラートを発行するには、通知APIを使用して、表示するコンテンツと有効期限を指定します。APIでは、アラートを表示するために選択できるテンプレートセットが用意されています。テンプレートの詳細については、固定視覚アラートテンプレートを参照してください。
または、Alexa Smart Propertiesコンソールでデフォルトのテンプレートを使用して固定視覚アラートを送信することもできます。詳細については、マネジメントコンソールでコンテンツを管理するを参照してください。
固定視覚アラートのテンプレートでは、背景画像がサポートされます。画像の詳細については、プロアクティブサジェスチョンと視覚アラートの背景画像を参照してください。
以下の例は、テキスト折り返しテンプレートを使用してゲストにウォーキングを促す視覚アラートを作成する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/textWrappingTemplate"
},
"datasources": {
"displayText": {
"primaryText": "エクササイズリマインダー",
"secondaryText": "ウォーキングの時間です。"
},
"background": {
"backgroundImageSource": "https://www.example.com/image.jpg"
}
}
}]
}]
},
"dismissalTime": "2021-04-30T10:15:00.00Z"
}]
}
}
固定視覚アラートの例
以下の表に、ゲストに表示できる固定アラートの例を示します。
| アラートのタイプ | 第1テキスト | 第2テキスト |
|---|---|---|
|
アクティビティ |
エクササイズリマインダー |
ウォーキングの時間です。 |
|
アクティビティ |
今夜午後7時、<アクティビティ> |
<アクティビティ>にご参加ください。 |
|
予定 |
<予定>リマインダー |
<予定>が午後3時から始まります。 |
|
サービス |
朝食 |
朝食は午後1時まで提供されます。 |
|
メンテナンス |
テレビの修理が完了しました |
— |
プロアクティブサジェスチョンと視覚アラートの背景画像
プロアクティブサジェスチョンと視覚アラートには、どちらも背景画像を指定できます。画像については、以下のガイドラインを参考にしてください。
- 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分以内に画面上にアラートを表示します。
関連トピック
最終更新日: 2024 年 11 月 13 日