為方便使用,部分特徵的簡易版可與 iOS 上的 Automation API 搭配使用。
簡化特徵可取代標準 Home API 特徵,類似於外觀模式的運作方式。簡化特徵提供的指令,可讓特定裝置類型更輕鬆地完成常見工作。簡化特徵是 Home API 特徵,與其他 Home API 特徵一樣,適用於 Matter 和 Cloud-to-cloud 裝置。
簡化特徵提供的屬性和指令子集,比相應的標準特徵更為特定裝置。舉例來說,標準 LevelControlTrait
特徵是通用特徵,可用於任何裝置,只要該裝置有設定,可在數值範圍內持續變化。BrightnessTrait
是簡化的特徵,可代表 LevelControlTrait
,並只提供 DimmableLightDeviceType
裝置所需的指令和屬性。BrightnessTrait
有一個 moveToBrightness
指令,可接收單一 brightnessPercent
引數,而 LevelControlTrait
則有數個 move
指令,其中大多數指令至少有四個參數,可支援更多用途。
下表列出每個簡化特徵和基礎標準特徵。每個特徵名稱都會連結至對應的 API 說明文件:
簡化特徵 | 標準特徵 |
---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTrait OnOffTrait
|
簡化特徵和 Discovery API
Discovery API 會回報簡化特徵以及其基礎標準特徵,前提是這兩項特徵在應用程式設定中已正確設為 ReferencedAutomationTypes
。舉例來說,如果結構體中出現 DimmableLightDeviceType
裝置,且開發人員已註冊 LevelControlTrait
和 BrightnessTrait
特徵,Discovery API 就會指出這兩項特徵都存在。開發人員可以在自動化動作中選擇使用任一特徵。
詳情請參閱主畫面設定。