iOS での特徴の簡素化

使いやすさを考慮して、一部のトレイトの簡略版を 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	LevelControlTrait OnOffTrait

簡略化されたトレイトと Discovery API

Discovery API は、簡略化されたトレイトと基盤となる 標準トレイトを報告します。ただし、両方のトレイトがアプリの構成で ReferencedAutomationTypesとして正しく構成されている必要があります。たとえば、構造内に a DimmableLightDeviceTypeデバイスがあり、デベロッ 101}パーが両方の LevelControlTrait と BrightnessTrait トレイトを登録した場合、Discovery API は両方のトレイトの存在を示します。デベロッパーは、自動化でどちらのトレイトを使用するかを選択できます。

詳細については、ホーム構成をご覧ください 。