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


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

ユーザーがスキルやデバイスを使用するときに、より自由な言葉で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

ラベルの種類です。
有効な値:assettext

文字列

value

フレンドリー名の値です。

オブジェクト

value.assetId

グローバルAlexaカタログのアセット識別子です。@type = assetの場合には必須です。

文字列

value.text

フレンドリー名のテキストです。@type = textの場合には必須です。

文字列

value.locale

フレンドリー名の言語とロケールです。
@type = textの場合には必須です。

文字列

CapabilityResourcesオブジェクト

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

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

CapabilityResourcesの例

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

CapabilityResourcesプロパティの詳細

プロパティ 説明 必須

friendlyNames

ユーザーがAlexaに話しかけるときに、インターフェースインスタンスを指定するために使用できるフレンドリー名です。配列の最初のフレンドリー名は、エンドポイントで一意である必要があります。

Labelオブジェクトの配列

ModeResourcesプロパティ

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

ModeResourcesの例

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

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

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

ModeResourcesプロパティの詳細

プロパティ 説明 必須

friendlyNames

ユーザーがAlexaに話しかけるときに、モード値として使用できるフレンドリー名です。

Labelオブジェクトの配列

PresetResourcesプロパティ

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

PresetResourcesの例

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

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

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

PresetResourcesプロパティの詳細

プロパティ 説明 必須

friendlyNames

ユーザーがAlexaに話しかけるときに、プリセット範囲の値として使用できるフレンドリー名です。

Labelオブジェクトの配列

グローバルAlexaカタログ

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

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

アセット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 日