フレンドリー名のリソースとアセット

Note: Sign in to the developer console to build or publish your skill.

フレンドリー名のリソースとアセット

ユーザーがスキルやデバイスを使用するときに、より自由な言葉でAlexaに話しかけられるように、特定の機能に複数のフレンドリー名を指定できます。たとえば、洗濯機デバイスにデフォルトの洗濯モードがある場合、複数のフレンドリー名を指定すると、ユーザーは「アレクサ、洗濯モードを通常に設定して」と話しかけたり、「アレクサ、洗濯モードをコットンに設定して」と話しかけたりできるようになります。フレンドリー名を使用して、スキルやデバイスに複数の言語でアクセスすることもできます。

重要： ユーザーは、Alexaに話しかけるときにどのフレンドリー名でも参照できますが、最初のフレンドリー名は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オブジェクトの詳細

プロパティ	説明	型	必須
`@type`	ラベルの種類です。有効な値：`asset`、`text`	文字列	◯
`value`	フレンドリー名の値です。	オブジェクト	◯
`value.assetId`	グローバルAlexaカタログのアセット識別子です。`@type` = `asset`の場合には必須です。	文字列	✕
`value.text`	フレンドリー名のテキストです。`@type` = `text`の場合には必須です。	文字列	✕
`value.locale`	フレンドリー名の言語とロケールです。 `@type` = `text`の場合には必須です。	文字列	✕

CapabilityResourcesオブジェクト

一部のインターフェースを実装する場合、特に同じデバイスに複数回実装できるインターフェースでは、それぞれのインターフェースインスタンスにフレンドリー名を付けることができます。このようなインターフェースの例として、 Alexa.ModeController、Alexa.RangeController、Alexa.ToggleController、Alexa.InventoryLevelSensor、Alexa.InventoryUsageSensorがあります。

フレンドリー名を指定するには、検出プロセスで、Discover.ResponseイベントにCapabilityResourcesオブジェクトを含めます。

CapabilityResourcesの例

以下は、コーヒーカプセルの使用状況を追跡するためにAlexa.InventoryUsageSensorインターフェースをサポートするコーヒーメーカーのDiscover.Responseメッセージの例です。ユーザーがこのセンサーを「コーヒーカプセル」と呼ぶことができるように、応答でフレンドリー名を指定します。この例では、フレンドリー名を複数の言語でも提供します。

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

{
  "event": {
    "header": {
      "namespace": "Alexa.Discovery",
      "name": "Discover.Response",
      "payloadVersion": "3",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
    },
    "payload": {
      "endpoints": [
        {
          "endpointId": "エンドポイントの一意のID",
          "manufacturerName": "コーヒーメーカープラス",
          "description": "コーヒーメーカープラスのスマートコーヒーメーカー",
          "friendlyName": "コーヒーメーカー",
          "displayCategories": [
            "OTHER"
          ],
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.InventoryUsageSensor",
              "instance": "Sensor.CoffeePod",
              "version": "3",
              "configuration": {
                "measurement": {
                  "@type": "Count"
                },
                "replenishment": {
                  "@type": "DashReplenishmentId",
                  "value": "リフィルオプションのReplenishment ID"
                }
              },
              "capabilityResources": {
                "friendlyNames": [
                  {
                    "@type": "text",
                    "value": {
                      "text": "コーヒーカプセル",
                      "locale": "ja-JP"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "Cápsulas de Café",
                      "locale": "es-MX"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "Capsules de café",
                      "locale": "fr-CA"
                    }
                  }
                ]
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PowerController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "powerState"
                  }
                ],
                "retrievable": true,
                "proactivelyReported": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3"
            }
          ]
        }
      ]
    }
  }
}

CapabilityResourcesプロパティの詳細

プロパティ	説明	型	必須
`friendlyNames`	ユーザーがAlexaに話しかけるときに、インターフェースインスタンスを指定するために使用できるフレンドリー名です。配列の最初のフレンドリー名は、エンドポイントで一意である必要があります。	`Label`オブジェクトの配列	◯

ModeResourcesプロパティ

Alexa.ModeControllerを実装する場合は、モードリソースを使用して、サポートされるモードにフレンドリー名を指定します。フレンドリー名を指定するには、検出プロセスで、Discover.ResponseイベントにmodeResourcesプロパティを含めます。

ModeResourcesの例

以下は、Alexa.ModeControllerインターフェースをサポートする洗濯機へのDiscover.Responseメッセージの例です。この例には、WashCycleという名前のモードが1つ含まれています。応答では、次のように複数のフレンドリー名を指定します。

ユーザーがWashCycleモードを別の名前で参照できるように、応答のcapabilityResourcesプロパティでフレンドリー名を指定します。WashCycleモードには、NormalとDelicatesという2つの設定があります。
ユーザーがモード設定を別の名前で参照できるように、応答のmodeResourcesプロパティでフレンドリー名を指定します。ユーザーは、「アレクサ、洗濯設定をニットに設定して」などのフレーズを話しかけることができます。

この例では、グローバルAlexaカタログのアセットを使用し、複数の言語でフレンドリー名を指定します。

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

{
  "event": {
    "header": {
      "namespace": "Alexa.Discovery",
      "name": "Discover.Response",
      "payloadVersion": "3",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
    },
    "payload": {
      "endpoints": [
        {
          "endpointId": "エンドポイントの一意のID",
          "manufacturerName": "家電メーカープラス",
          "description": “家電メーカープラスのスマート洗濯機”,
          "friendlyName": "洗濯機",
          "displayCategories": ["OTHER"],
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.ModeController",
              "instance": "Washer.WashCycle",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "mode"
                  }
                ],
                "retrievable": true,
                "proactivelyReported": true,
                "nonControllable": false
              },
              "capabilityResources": {
                "friendlyNames": [
                  {
                    "@type": "asset",
                    "value": {
                      "assetId": "Alexa.Setting.WashCycle"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "洗濯モード",
                      "locale": "ja-JP"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "洗濯設定",
                      "locale": "ja-JP"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "Ciclo de lavado",
                      "locale": "es-MX"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "Cycle de lavage",
                      "locale": "fr-CA"
                    }
                  }
                ]
              },
              "configuration": {
                "ordered": false,
                "supportedModes": [
                  {
                    "value": "WashCycle.Normal",
                    "modeResources": {
                      "friendlyNames": [
                        {
                          "@type": "text",
                          "value": {
                            "text": "標準",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "コットン",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "Ciclo normal",
                            "locale": "es-MX"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "Cycle délicat",
                            "locale": "fr-CA"
                          }
                        }
                      ]
                    }
                  },
                  {
                    "value": "WashCycle.Delicates",
                    "modeResources": {
                      "friendlyNames": [
                        {
                          "@type": "asset",
                          "value": {
                            "assetId": "Alexa.Value.Delicate"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "デリケート",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "ニット",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "Ciclo delicado",
                            "locale": "es-MX"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "Cycle délicat",
                            "locale": "fr-CA"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PowerController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "powerState"
                  }
                ],
                "retrievable": true,
                "proactivelyReported": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3"
            }
          ]
        }
      ]
    }
  }
}

ModeResourcesプロパティの詳細

プロパティ	説明	型	必須
`friendlyNames`	ユーザーがAlexaに話しかけるときに、モード値として使用できるフレンドリー名です。	`Label`オブジェクトの配列	◯

PresetResourcesプロパティ

Alexa.RangeControllerを実装する場合は、プリセットリソースを使用して、サポートされるプリセット範囲の値にフレンドリー名を指定できます。フレンドリー名を指定するには、検出プロセスで、Discover.ResponseイベントにpresetResourcesプロパティを含めます。

PresetResourcesの例

以下は、Alexa.RangeControllerインターフェースをサポートする扇風機のDiscover.Responseメッセージの例です。この例には、Fan.Speedという範囲が1つ含まれています。応答では、次のように複数のフレンドリー名を指定します。

ユーザーが扇風機の風速の範囲を別の名前で参照できるように、応答のcapabilityResourcesプロパティでフレンドリー名を指定します。
ユーザーが扇風機の最大風速と最小風速を別の名前で参照できるように、応答のpresetResourcesプロパティでフレンドリー名を指定します。ユーザーは、「アレクサ、扇風機を低速に設定して」などのフレーズを話しかけることができます。

この例では、グローバルAlexaカタログのアセットを使用します。この例では、フレンドリー名を複数の言語でも提供します。

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

{
  "event": {
    "header": {
      "namespace": "Alexa.Discovery",
      "name": "Discover.Response",
      "payloadVersion": "3",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
    },
    "payload": {
      "endpoints": [
        {
          "endpointId": "エンドポイントの一意のID",
          "manufacturerName": "エンドポイントのメーカー名",
          "description": "Alexaアプリに表示される説明",
          "friendlyName": "Alexaアプリに表示されるデバイス名",
          "displayCategories": ["FAN"],
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.RangeController",
              "instance": "Fan.Speed",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "rangeValue"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true,
                "nonControllable": false
              },
              "capabilityResources": {
                "friendlyNames": [
                  {
                    "@type": "asset",
                    "value": {
                      "assetId": "Alexa.Setting.FanSpeed"
                    }
                  }
                ]
              },
              "configuration": {
                "supportedRange": {
                  "minimumValue": 1,
                  "maximumValue": 10,
                  "precision": 1
                },
                "presets": [
                  {
                    "rangeValue": 10,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "asset",
                          "value": {
                            "assetId": "Alexa.Value.Maximum"
                          }
                        },
                        {
                          "@type": "asset",
                          "value": {
                            "assetId": "Alexa.Value.High"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "最大",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "高速",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "Alta",
                            "locale": "es-MX"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "Élevée",
                            "locale": "fr-CA"
                          }
                        }
                      ]
                    }
                  },
                  {
                    "rangeValue": 1,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "asset",
                          "value": {
                            "assetId": "Alexa.Value.Minimum"
                          }
                        },
                        {
                          "@type": "asset",
                          "value": {
                            "assetId": "Alexa.Value.Low"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "最小",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "低速",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "Baja",
                            "locale": "es-MX"
                          }
                        },
                        {
                          "@type": "text",
                          "value": {
                            "text": "Faible",
                            "locale": "fr-CA"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PowerController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "powerState"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3"
            }
          ]
        }
      ]
    }
  }
}

PresetResourcesプロパティの詳細

プロパティ	説明	型	必須
`friendlyNames`	ユーザーがAlexaに話しかけるときに、プリセット範囲の値として使用できるフレンドリー名です。	`Label`オブジェクトの配列	◯

グローバルAlexaカタログ

スキルでは、事前定義されたフレンドリー名のグローバルAlexaカタログを使用できます。カタログ内の各項目は、1つ以上のフレンドリー名をサポートするアセットIDです。スキルで指定したアセットIDごとに、ユーザーは複数のフレンドリー名にアクセスできるようになります。テーブル内の最初のフレンドリー名が、Alexaアプリに表示される名前です。

アセットIDには、値の取得元カタログを識別する名前空間が付いています。Alexa名前空間は、Amazonが精選したグローバルカタログを表します。

重要： このグローバルAlexaカタログは、Alexaがサポートするすべての言語にローカライズされます。

アセットID	サポートされるフレンドリー名
`Alexa.Button.OffButton`	オフボタン
`Alexa.Button.OnButton`	オンボタン
`Alexa.Button.BrightenButton`	明るくするボタン
`Alexa.Button.DimButton`	暗くするボタン
`Alexa.Button.MainButton`	メインボタン
`Alexa.Button.TopButton`	最上部ボタン
`Alexa.Button.BottomButton`	最下部ボタン
`Alexa.Button.CenterButton`	中央ボタン
`Alexa.Button.MiddleButton`	中間ボタン
`Alexa.Button.UpButton`	上ボタン
`Alexa.Button.DownButton`	下ボタン
`Alexa.Button.LeftButton`	左ボタン
`Alexa.Button.RightButton`	右ボタン
`Alexa.Button.FirstButton`	第1ボタン
`Alexa.Button.SecondButton`	第2ボタン
`Alexa.Button.ThirdButton`	第3ボタン
`Alexa.Button.FourthButton`	第4ボタン
`Alexa.Button.FifthButton`	第5ボタン
`Alexa.Button.SixthButton`	第6ボタン
`Alexa.Button.SeventhButton`	第7ボタン
`Alexa.Button.EighthButton`	第8ボタン
`Alexa.Button.DoublePress`	2回押し
`Alexa.Button.DoublePush`	2回プッシュ
`Alexa.Button.LongPress`	長押し
`Alexa.Button.LongPush`	長プッシュ
`Alexa.Button.SinglePress`	1回押し
`Alexa.Button.SinglePush`	1回プッシュ
`Alexa.DeviceName.AirPurifier`	空気清浄機、エアクリーナー、清浄機
`Alexa.DeviceName.Camera`	カメラ
`Alexa.DeviceName.Fan`	扇風機、送風機
`Alexa.DeviceName.Router`	ルーター、インターネットルーター、ネットワークルーター、Wi-Fiルーター、ネットルーター
`Alexa.DeviceName.Shade`	シェード、ブラインド、カーテン、ローラー、シャッター、ドレープ、日よけ、ウィンドウシェード、内付けブラインド
`Alexa.DeviceName.Shower`	シャワー
`Alexa.DeviceName.SpaceHeater`	ヒーター、ポータブルヒーター
`Alexa.DeviceName.Washer`	洗濯機、洗濯乾燥機
`Alexa.Gesture.DoubleClick`	ダブルクリック
`Alexa.Gestures.DoubleTap`	ダブルタップ
`Alexa.Gesture.SingleClick`	シングルクリック
`Alexa.Gesture.SwipeDown`	下にスワイプ
`Alexa.Gesture.SwipeLeft`	左にスワイプ
`Alexa.Gesture.SwipeRight`	右にスワイプ
`Alexa.Gesture.SwipeUp`	上にスワイプ
`Alexa.Gesture.Tap`	タップ
`Alexa.Setting.2GGuestWiFi`	2.4GゲストWi-Fi、2.4Gゲストネットワーク、ゲストネットワーク2.4G、2GゲストWi-Fi
`Alexa.Setting.5GGuestWiFi`	5GゲストWi-Fi、5Gゲストネットワーク、ゲストネットワーク5G、5GゲストWi-Fi
`Alexa.Setting.Auto`	自動、オートマチック、自動モード、オートモード
`Alexa.Setting.Direction`	向き
`Alexa.Setting.DryCycle`	乾燥サイクル、乾燥プリセット、乾燥設定、乾燥機サイクル、乾燥機プリセット、乾燥機設定
`Alexa.Setting.FanSpeed`	風速、送風速度、送風スピード、速さ、回転速度
`Alexa.Setting.GuestWiFi`	ゲストWi-Fi、ゲストネットワーク、ゲストネット
`Alexa.Setting.Heat`	暖房
`Alexa.Setting.Mode`	モード
`Alexa.Setting.Night`	ナイト、ナイトモード
`Alexa.Setting.Opening`	開口部、高さ、リフト、幅
`Alexa.Setting.Oscillate`	首振り、旋回、首振りモード、首回し、前後移動
`Alexa.Setting.Preset`	プリセット、設定
`Alexa.Setting.Quiet`	静音、静音モード、静か、サイレント
`Alexa.Setting.Temperature`	温度、気温
`Alexa.Setting.WashCycle`	洗濯モード、洗濯プリセット、洗濯設定
`Alexa.Setting.WaterTemperature`	水温、給水温度、湯温
`Alexa.Shower.HandHeld`	可動式、可動式シャワー、可動型シャワー、ハンドシャワー
`Alexa.Shower.RainHead`	固定シャワー、オーバーヘッドシャワー、据え付けシャワー、据え付けシャワーヘッド、備え付けシャワーヘッド
`Alexa.Unit.Angle.Degrees`	度
`Alexa.Unit.Angle.Radians`	ラジアン
`Alexa.Unit.Distance.Feet`	フィート
`Alexa.Unit.Distance.Inches`	インチ
`Alexa.Unit.Distance.Kilometers`	キロメートル
`Alexa.Unit.Distance.Meters`	メートル、メーター、m
`Alexa.Unit.Distance.Miles`	マイル
`Alexa.Unit.Distance.Yards`	ヤード
`Alexa.Unit.Mass.Grams`	グラム、g
`Alexa.Unit.Mass.Kilograms`	キログラム、kg
`Alexa.Unit.Percent`	パーセント
`Alexa.Unit.Temperature.Celsius`	摂氏、セ氏、度、C、°C、百分度
`Alexa.Unit.Temperature.Degrees`	度
`Alexa.Unit.Temperature.Fahrenheit`	華氏、カ氏、°F、度、F
`Alexa.Unit.Temperature.Kelvin`	ケルビン、度ケルビン、度K、度、K
`Alexa.Unit.Volume.CubicFeet`	立方フィート
`Alexa.Unit.Volume.CubicMeters`	立方メートル、立方メーター
`Alexa.Unit.Volume.Gallons`	ガロン
`Alexa.Unit.Volume.Liters`	リットル、リッター、L
`Alexa.Unit.Volume.Pints`	パイント
`Alexa.Unit.Volume.Quarts`	クオート、クォート
`Alexa.Unit.Weight.Ounces`	オンス、oz
`Alexa.Unit.Weight.Pounds`	ポンド、lbs
`Alexa.Value.Close`	閉じる
`Alexa.Value.Delicate`	デリケート
`Alexa.Value.High`	高
`Alexa.Value.Low`	低
`Alexa.Value.Maximum`	最大、強
`Alexa.Value.Medium`	中、ミディアム
`Alexa.Value.Minimum`	最小、弱
`Alexa.Value.Open`	開く
`Alexa.Value.QuickWash`	スピード洗濯、お急ぎ洗濯、お急ぎモード、スピードモード

ユーザー定義のカタログをアップロードする

独自のカスタム用語を定義したユーザー定義のカタログをアップロードすることもできます。

注：ユーザー定義のカタログをアップロードする機能はまもなく利用できるようになります。

ローカライズが必要なフレンドリー名にはカタログを使用することをお勧めします。ユーザー定義の名前と設定については、プレーンテキストを使用し、変更がある場合は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 日

フレンドリー名のリソースとアセット

Labelオブジェクト

テキストラベルの例

フランス語のテキストラベルの例

アセットラベルの例

Labelオブジェクトの詳細

CapabilityResourcesオブジェクト

CapabilityResourcesの例

CapabilityResourcesプロパティの詳細

ModeResourcesプロパティ

ModeResourcesの例

ModeResourcesプロパティの詳細

PresetResourcesプロパティ

PresetResourcesの例

PresetResourcesプロパティの詳細

グローバルAlexaカタログ

ユーザー定義のカタログをアップロードする

予約語

関連トピック

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