使いやすさを考慮して、一部の特性の簡略化されたバージョンが iOS の Automation API で使用できます。
簡略化されたトレイトは、ファサード パターンの仕組みと同様に、標準の Home API トレイトの代わりになります。簡素化されたトレイトは、特定のデバイスタイプで一般的なタスクを容易にするコマンドを提供します。簡素化されたトレイトは Home API トレイトであり、他の Home API トレイトと同様に、Matter デバイスと Cloud-to-cloud デバイスの両方で機能します。
簡素化されたトレイトは、対応する標準トレイトよりもデバイス固有の属性とコマンドの代替サブセットを提供します。たとえば、標準の LevelControlTrait トレイトは、数値の範囲にわたって連続的に変化する設定を持つデバイスに使用できる汎用トレイトです。BrightnessTrait は、LevelControlTrait の代わりとなる簡素化されたトレイトで、DimmableLightDeviceType デバイスに必要なコマンドと属性のみを提供します。BrightnessTrait には、単一の brightnessPercent 引数を取る moveToBrightness コマンドがあります。一方、LevelControlTrait には複数の move コマンドがあり、そのほとんどには、より幅広いユースケースに対応するために少なくとも 4 つのパラメータがあります。
次の表に、各簡略化されたトレイトと、基になる標準トレイトを示します。各トレイト名は、対応する API ドキュメントにリンクしています。
| 簡略化された特性 | 標準トレイト |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
簡素化された特性と Discovery API
Discovery API は、簡素化されたトレイトとその基盤となる標準トレイトの両方が、アプリの構成で ReferencedAutomationTypes として正しく構成されている限り、簡素化されたトレイトとその基盤となる標準トレイトを報告します。たとえば、DimmableLightDeviceType デバイスが構造内に存在し、デベロッパーが LevelControlTrait トレイトと BrightnessTrait トレイトの両方を登録した場合、Discovery API は両方のトレイトの存在を示します。デベロッパーは、自動化でどちらのトレイトを使用するかを選択できます。
詳細については、ホーム構成をご覧ください。