iOS 上的簡化特徵

為方便使用,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

只要在應用程式設定中將這兩種特徵正確設定為 ReferencedAutomationTypes,Discovery API 就會回報簡化特徵及其基礎標準特徵。舉例來說,如果結構中存在 DimmableLightDeviceType 裝置,且開發人員同時註冊了 LevelControlTrait 和 BrightnessTrait 特徵,Discovery API 就會指出這兩種特徵的存在。開發人員可以選擇在自動化動作中使用任一特徵。

詳情請參閱「住家設定」。