フレンドリー名のリソースとアセット
ユーザーがスキルやデバイスを使用するときに、より自由な言葉でAlexaに話しかけられるように、特定の機能に複数のフレンドリー名を指定できます。たとえば、洗濯機デバイスにデフォルトの洗濯モードがある場合、複数のフレンドリー名を指定すると、ユーザーは「アレクサ、洗濯モードを通常に設定して」と話しかけたり、「アレクサ、洗濯モードをコットンに設定して」と話しかけたりできるようになります。 フレンドリー名を使用して、スキルやデバイスに複数の言語でアクセスすることもできます。
フレンドリー名は次の方法で指定できます。
- 独自のフレンドリー名をテキストとして指定できます。
- グローバルAlexaカタログのフレンドリー名を使用できます。
- 独自のフレンドリー名のカタログをアップロードできます。
次の各セクションで説明するように、フレンドリー名は検出プロセスのDiscover.Response
イベントで指定します。
Labelオブジェクト
Label
オブジェクトは、個々のフレンドリー名を表します。名前を定義することも、グローバルAlexaカタログの名前を使用することもできます。
テキストラベルの例
{
"@type": "text",
"value": {
"text": "標準",
"locale": "ja-JP"
}
}
フランス語のテキストラベルの例
{
"@type": "text",
"value": {
"text": "Capsules de café",
"locale": "fr-FR"
}
}
アセットラベルの例
次の例には、フレンドリー名のアセットラベルが含まれています。この例では、Alexa.Setting.Quiet
アセットを使用して、ユーザーがAlexaに話しかけるときに、 「静音」、「静音モード」、「静か」、「サイレント」のどれでも認識されるようにします。
{
"@type": "asset",
"value": {
"assetId": "Alexa.Setting.Quiet"
}
}
Labelオブジェクトの詳細
プロパティ | 説明 | 型 | 必須 |
---|---|---|---|
|
ラベルの種類です。 |
文字列 |
◯ |
|
フレンドリー名の値です。 |
オブジェクト |
◯ |
|
グローバルAlexaカタログのアセット識別子です。 |
文字列 |
✕ |
|
フレンドリー名のテキストです。 |
文字列 |
✕ |
|
フレンドリー名の言語とロケールです。 |
文字列 |
✕ |
CapabilityResourcesオブジェクト
一部のインターフェースを実装する場合、特に同じデバイスに複数回実装できるインターフェースでは、それぞれのインターフェースインスタンスにフレンドリー名を付けることができます。このようなインターフェースの例として、 Alexa.ModeController
、Alexa.RangeController
、Alexa.ToggleController
、Alexa.InventoryLevelSensor
、Alexa.InventoryUsageSensor
があります。
フレンドリー名を指定するには、検出プロセスで、Discover.Response
イベントにCapabilityResources
オブジェクトを含めます。
CapabilityResourcesの例
以下は、コーヒーカプセルの使用状況を追跡するためにAlexa.InventoryUsageSensor
インターフェースをサポートするコーヒーメーカーのDiscover.Response
メッセージの例です。ユーザーがこのセンサーを「コーヒーカプセル」と呼ぶことができるように、応答でフレンドリー名を指定します。この例では、フレンドリー名を複数の言語でも提供します。
CapabilityResourcesプロパティの詳細
プロパティ | 説明 | 型 | 必須 |
---|---|---|---|
|
ユーザーがAlexaに話しかけるときに、インターフェースインスタンスを指定するために使用できるフレンドリー名です。配列の最初のフレンドリー名は、エンドポイントで一意である必要があります。 |
|
◯ |
ModeResourcesプロパティ
Alexa.ModeController
を実装する場合は、モードリソースを使用して、サポートされるモードにフレンドリー名を指定します。フレンドリー名を指定するには、検出プロセスで、Discover.Response
イベントにmodeResources
プロパティを含めます。
ModeResourcesの例
以下は、Alexa.ModeController
インターフェースをサポートする洗濯機へのDiscover.Response
メッセージの例です。この例には、WashCycle
という名前のモードが1つ含まれています。応答では、次のように複数のフレンドリー名を指定します。
- ユーザーが
WashCycle
モードを別の名前で参照できるように、応答のcapabilityResources
プロパティでフレンドリー名を指定します。WashCycle
モードには、Normal
とDelicates
という2つの設定があります。 - ユーザーがモード設定を別の名前で参照できるように、応答の
modeResources
プロパティでフレンドリー名を指定します。ユーザーは、「アレクサ、洗濯設定をニットに設定して」などのフレーズを話しかけることができます。
この例では、グローバルAlexaカタログのアセットを使用し、複数の言語でフレンドリー名を指定します。
ModeResourcesプロパティの詳細
プロパティ | 説明 | 型 | 必須 |
---|---|---|---|
|
ユーザーがAlexaに話しかけるときに、モード値として使用できるフレンドリー名です。 |
|
◯ |
PresetResourcesプロパティ
Alexa.RangeController
を実装する場合は、プリセットリソースを使用して、サポートされるプリセット範囲の値にフレンドリー名を指定できます。フレンドリー名を指定するには、検出プロセスで、Discover.Response
イベントにpresetResources
プロパティを含めます。
PresetResourcesの例
以下は、Alexa.RangeController
インターフェースをサポートする扇風機のDiscover.Response
メッセージの例です。この例には、Fan.Speed
という範囲が1つ含まれています。応答では、次のように複数のフレンドリー名を指定します。
- ユーザーが扇風機の風速の範囲を別の名前で参照できるように、応答の
capabilityResources
プロパティでフレンドリー名を指定します。 - ユーザーが扇風機の最大風速と最小風速を別の名前で参照できるように、応答の
presetResources
プロパティでフレンドリー名を指定します。ユーザーは、「アレクサ、扇風機を低速に設定して」などのフレーズを話しかけることができます。
この例では、グローバルAlexaカタログのアセットを使用します。この例では、フレンドリー名を複数の言語でも提供します。
PresetResourcesプロパティの詳細
プロパティ | 説明 | 型 | 必須 |
---|---|---|---|
|
ユーザーがAlexaに話しかけるときに、プリセット範囲の値として使用できるフレンドリー名です。 |
|
◯ |
グローバルAlexaカタログ
スキルでは、事前定義されたフレンドリー名のグローバルAlexaカタログを使用できます。カタログ内の各項目は、1つ以上のフレンドリー名をサポートするアセットIDです。スキルで指定したアセットIDごとに、ユーザーは複数のフレンドリー名にアクセスできるようになります。テーブル内の最初のフレンドリー名が、Alexaアプリに表示される名前です。
アセットIDには、値の取得元カタログを識別する名前空間が付いています。Alexa
名前空間は、Amazonが精選したグローバルカタログを表します。
アセットID | サポートされるフレンドリー名 |
---|---|
|
オフボタン |
|
オンボタン |
|
明るくするボタン |
|
暗くするボタン |
|
メインボタン |
|
最上部ボタン |
|
最下部ボタン |
|
中央ボタン |
|
中間ボタン |
|
上ボタン |
|
下ボタン |
|
左ボタン |
|
右ボタン |
|
第1ボタン |
|
第2ボタン |
|
第3ボタン |
|
第4ボタン |
|
第5ボタン |
|
第6ボタン |
|
第7ボタン |
|
第8ボタン |
|
2回押し |
|
2回プッシュ |
|
長押し |
|
長プッシュ |
|
1回押し |
|
1回プッシュ |
|
空気清浄機、エアクリーナー、清浄機 |
|
カメラ |
|
扇風機、送風機 |
|
ルーター、インターネットルーター、ネットワークルーター、Wi-Fiルーター、ネットルーター |
|
シェード、ブラインド、カーテン、ローラー、シャッター、ドレープ、日よけ、ウィンドウシェード、内付けブラインド |
|
シャワー |
|
ヒーター、ポータブルヒーター |
|
洗濯機、洗濯乾燥機 |
|
ダブルクリック |
|
ダブルタップ |
|
シングルクリック |
|
下にスワイプ |
|
左にスワイプ |
|
右にスワイプ |
|
上にスワイプ |
|
タップ |
|
2.4GゲストWi-Fi、2.4Gゲストネットワーク、ゲストネットワーク2.4G、2GゲストWi-Fi |
|
5GゲストWi-Fi、5Gゲストネットワーク、ゲストネットワーク5G、5GゲストWi-Fi |
|
自動、オートマチック、自動モード、オートモード |
|
向き |
|
乾燥サイクル、乾燥プリセット、乾燥設定、乾燥機サイクル、乾燥機プリセット、乾燥機設定 |
|
風速、送風速度、送風スピード、速さ、回転速度 |
|
ゲストWi-Fi、ゲストネットワーク、ゲストネット |
|
暖房 |
|
モード |
|
ナイト、ナイトモード |
|
開口部、高さ、リフト、幅 |
|
首振り、旋回、首振りモード、首回し、前後移動 |
|
プリセット、設定 |
|
静音、静音モード、静か、サイレント |
|
温度、気温 |
|
洗濯モード、洗濯プリセット、洗濯設定 |
|
水温、給水温度、湯温 |
|
可動式、可動式シャワー、可動型シャワー、ハンドシャワー |
|
固定シャワー、オーバーヘッドシャワー、据え付けシャワー、据え付けシャワーヘッド、備え付けシャワーヘッド |
|
度 |
|
ラジアン |
|
フィート |
|
インチ |
|
キロメートル |
|
メートル、メーター、m |
|
マイル |
|
ヤード |
|
グラム、g |
|
キログラム、kg |
|
パーセント |
|
摂氏、セ氏、度、C、°C、百分度 |
|
度 |
|
華氏、カ氏、°F、度、F |
|
ケルビン、度ケルビン、度K、度、K |
|
立方フィート |
|
立方メートル、立方メーター |
|
ガロン |
|
リットル、リッター、L |
|
パイント |
|
クオート、クォート |
|
オンス、oz |
|
ポンド、lbs |
|
閉じる |
|
デリケート |
|
高 |
|
低 |
|
最大、強 |
|
中、ミディアム |
|
最小、弱 |
|
開く |
|
スピード洗濯、お急ぎ洗濯、お急ぎモード、スピードモード |
ユーザー定義のカタログをアップロードする
独自のカスタム用語を定義したユーザー定義のカタログをアップロードすることもできます。
ローカライズが必要なフレンドリー名にはカタログを使用することをお勧めします。ユーザー定義の名前と設定については、プレーンテキストを使用し、変更がある場合はAddOrUpdateReport
でAlexaに通知してください。
予約語
以下の予約語はフレンドリー名として使用しないでください。
alarm, alarms, all alarms, away mode, bass, camera, date, date today, day, do not disturb, drop in, music, night light, notification, playing, sleep sounds, time, timer, today in music, treble, volume, way f. m.
関連トピック
最終更新日: 2024 年 07 月 11 日