会話型アクションのサポートは 2023 年 6 月 13 日に終了しました。詳細については、
会話型アクションの廃止をご覧ください。
デバイス トレイト
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
デバイスタイプの機能は、各タイプに追加するトレイトに由来します。トレイトの種類ごとに推奨されるトレイトがありますが、どれも追加できます。
| 名前 |
デバイス トレイト |
説明 |
推奨デバイスタイプ |
| Brightness |
action.devices.traits.Brightness |
明るさの絶対値は 0 から 100 までの正規化された値になります。個々のライトは、LED の構成に基づく範囲内の値に対応していない場合もあります。 |
ライトガイド |
| ColorSpectrum |
action.devices.traits.ColorSpectrum |
これは、RGB カラー範囲を使用するフルカラー電球に適用されます。ライトによっては、ColorSpectrum と ColorTemperature を組み合わせることもあります。アクセント ライトや LED ストリップ ライトでは Spectrum のみにすることもできますが、一部の読書用ライトは Temperature のみを使用します。シンプルな電球や、スマート コンセントにつながった単純なライトでは、どちらも使用しません。 |
ライトガイド |
| ColorTemperature |
action.devices.traits.ColorTemperature |
これは、色温度をケルビン単位で表す温度計に適用されます。これは通常、ColorSpectrum とは別のモダリティになります。また、Spectrum で到達できなくても Temperature で利用可能なホワイト ポイントがある場合もあります。利用可能なトレイトに基づき、Google はリクエストとライトタイプに基づいて適切なモードを選択します（たとえば、リビングルームのライトを白にすると、一部の電球には温度コマンドが送信され、LED ストリップに Spectrum コマンドが送信されます）。 |
ライトガイド |
| Dock |
action.devices.traits.Dock |
このトレイトは、コマンドで充電器に戻るセルフモード デバイス用に設計されています。 |
各種家電製品 |
| OnOff |
action.devices.traits.OnOff |
プラグやスイッチなど、オン / オフで切り替えを行うデバイスに使用します。新しいものも含めて、多くのデバイスでこの機能が使用されています。 |
ライトガイド |
| StartStop |
action.devices.traits.StartStop |
デバイスの起動と停止は、オン / オフと同様の機能を提供します。このトレイトを継承するデバイスは、電源オン / 起動時の動作が異なります。起動と停止が可能なデバイスの中には、単にオン / オフの状態を持つデバイスとは異なり、操作の実行中に一時停止が可能なものもあります。 |
大半の家電製品や掃除機、電源導入の前後に特定の動作を行うデバイスなど。 |
| TemperatureSetting |
action.devices.traits.TemperatureSetting |
このトレイトは、温度点とモードの両方に対応します。 |
エアコンガイド |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2023-12-02 UTC。
[null,null,["最終更新日 2023-12-02 UTC。"],[[["\u003cp\u003eDevice functionality is determined by assigned traits.\u003c/p\u003e\n"],["\u003cp\u003eEach device type has suggested traits, but you can customize them.\u003c/p\u003e\n"],["\u003cp\u003eTraits control actions like brightness, color, on/off state, and temperature.\u003c/p\u003e\n"],["\u003cp\u003eSome traits are recommended for specific device types, like lights or thermostats.\u003c/p\u003e\n"]]],["Device functionality is defined by added traits. Available traits include `Brightness` (0-100 range), `ColorSpectrum` (RGB), and `ColorTemperature` (Kelvin). `Dock` is for self-mobile devices returning for charging. `OnOff` provides basic on/off, while `StartStop` allows starting, stopping, and pausing. `TemperatureSetting` handles temperature points and modes. Each trait has recommended device types, but any combination can be used.\n"],null,["# Device Traits\n\nThe functionality for device types comes from the traits that you add to each one.\nEach device type has a number of recommended traits, but you can add whichever ones you\nwant.\n\n| Name | Device Traits | Description | Recommended Device Types |\n|--------------------------------------------------------------------------|--------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|\n| [Brightness](/assistant/sdk/reference/traits/brightness) | `action.devices.traits.Brightness` | Absolute brightness setting is in a normalized range from 0 to 100 (individual lights may not support every point in the range based on their LED configuration). | [Light Guide](/assistant/smarthome/guides/light) |\n| [ColorSpectrum](/assistant/sdk/reference/traits/colorspectrum) | `action.devices.traits.ColorSpectrum` | This applies to \"full\" color bulbs that take RGB color ranges. Lights may have any combination of ColorSpectrum and [ColorTemperature](/assistant/sdk/reference/traits/colortemperature); accent lights and LED strips may just have Spectrum, whereas some reading bulbs just have Temperature. Basic bulbs, or dumb lights on smart plugs, have neither. | [Light Guide](/assistant/smarthome/guides/light) |\n| [ColorTemperature](/assistant/sdk/reference/traits/colortemperature) | `action.devices.traits.ColorTemperature` | This applies to \"warmth\" bulbs that take a color point in Kelvin. This is generally a separate modality from [ColorSpectrum](/assistant/sdk/reference/traits/colorspectrum), and there may be white points available via Temperature that cannot be reached by Spectrum. Based on available traits, Google may pick the appropriate mode to use based on request and light type (for example, *Make the living room lights white* might send Temperature commands to some bulbs and Spectrum commands to LED strips). | [Light Guide](/assistant/smarthome/guides/light) |\n| [Dock](/assistant/sdk/reference/traits/dock) | `action.devices.traits.Dock` | This trait is designed for self-mobile devices that can be commanded to return for charging. | Various appliances |\n| [OnOff](/assistant/sdk/reference/traits/onoff) | `action.devices.traits.OnOff` | The basic on and off functionality for any device that has binary on and off, including plugs and switches as well as many future devices. | [Light Guide](/assistant/smarthome/guides/light) |\n| [StartStop](/assistant/sdk/reference/traits/startstop) | `action.devices.traits.StartStop` | Starting and stopping a device serves a similar function to turning it on and off. Devices that inherit this trait function differently when turned on and when started. Unlike devices that simply have an on and off state, some devices that can start and stop are also able to pause while performing operation. | Any - mostly appliances and vacuums and other things that have specific activity behavior above and beyond power |\n| [TemperatureSetting](/assistant/sdk/reference/traits/temperaturesetting) | `action.devices.traits.TemperatureSetting` | This trait covers handling both temperature point and modes. | [Thermostat Guide](/assistant/smarthome/guides/thermostat) |"]]
