マルチモーダルデバイスをカスタマイズする
Alexa Smart Properties for Senior Livingでは、Alexaを搭載したマルチモーダルデバイスにレンダリングされる視覚コンテンツによって音声エクスペリエンスを補完できます。ホーム画面を利用して施設の詳細情報を共有すること、音声またはタップでサービスを注文できるようにすること、イベントや最新情報、スキルに関する情報をゲストに提供することができます。
施設用スキルには、ゲストが音声またはタップでマルチモーダルデバイスを操作しているときにAlexaで表示する視覚要素を追加できます。たとえば、ゲストが「アレクサ、朝食は何時？」と問いかけたら、朝食の時間、場所、メニューを表示することができます。また、ゲストがデバイスを操作していないときにAlexaで表示する視覚要素を追加することもできます。たとえば、画像や視覚的なメッセージを追加して、予定されているイベントや施設内のさまざまな場所の情報をゲストに伝えることができます。
施設用スキルまたは施設管理アプリケーションから視覚要素を送信する場合は、以下のガイドラインに従ってください。
推奨事項
施設内にマルチモーダルデバイスがある場合、Amazonでは、以下の視覚要素を使用してホーム画面をカスタマイズすることを推奨します。
- Alexa Presentation Language（APL）を使用して、施設用スキルからの音声応答と共に、視覚応答を送信します。
- アレクサで施設の場所に応じてデフォルトの天気カードが表示されるように、デバイスの所在地が正しく指定されていることを確認します。Alexa搭載デバイスの所在地を更新するには、POST住所設定APIを使用します。
- ゲストがデバイスを操作していないときに表示するプロアクティブサジェスチョンを少なくとも7つ用意します。Alexaは、各サジェスチョンをローテーションで表示します。サジェスチョンには、以下の情報を含める必要があります。
- Alexaの機能に関するサジェスチョンを3件。たとえば、音量の変更方法を表示できます。
- 施設の機能に関するサジェスチョンを4件。たとえば、Wi-Fiへの接続方法や、レストランの営業時間を表示できます。
- デバイスに常に表示される視覚情報を設定するには、ビジュアルアラートを使用します。
スキルからの視覚応答を追加する
施設用スキルからの音声応答を視覚応答で補完できます。視覚応答で詳細情報を表示したり、ゲストがオプションをタップして選択できるようにしたり、施設の画像を表示したりすることができます。たとえば、ゲストにレストランの開店時間をたずねられたら、スキルは音声で応答するとともに、その日のレストランの営業時間を画面に表示できます。
スキルからの視覚応答の送信は、APLを使用して行うことができます。APLは、Alexa搭載マルチモーダルデバイスに視覚要素を構築する、レスポンシブ対応のレイアウト言語です。独自のレイアウトを作成する代わりに、APLのレスポンシブ対応コンポーネントとテンプレートを使用すると、より簡単に視覚応答を作成できます。レスポンシブ対応コンポーネントとテンプレートを使用する場合は、テンプレートを選択して、表示するデータを入力します。スキルコードに視覚応答を追加する方法の詳細については、スキルにAPLサポートを追加するを参照してください。
以下の表に、施設用スキルに適した推奨されるAPLテンプレートを示します。
| APLテンプレート | 使用例 | サンプル発話 |
|---|---|---|
|
中央揃えの短いメッセージを背景画像付きで表示する場合に使用します。施設のようこそ画面などに適しています。 |
「アレクサ、｛施設用スキル名｝を開いて」 | |
|
画像とテキストのスクロールリストを表示する場合に使用します。以下のような応答に適しています。
|
「アレクサ、おすすめのレストランを教えて」 | |
|
テキストベースの項目のスクロールリストを、必要に応じてヘッダーと背景画像を付けて表示する場合に使用します。メニュー項目などに適しています。このテンプレートは、リストの各項目に対応する画像がない場合に使用します。 |
「アレクサ、朝食は何？」 | |
|
テキストと画像を表示して、サービス名、営業時間、場所、説明など、施設のサービスに関する情報を構造的に提示する場合に使用します。 |
「アレクサ、売店は開いてる？」 | |
|
このテンプレートは、ほかのテンプレートが適さない場合に使用します。通常、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 年 03 月 06 日