iOS 上的簡化特徵

為方便使用,部分特徵的簡化版本可搭配 iOS 上的 Automation API 使用。

簡化特徵會取代標準 Home API 特徵,類似於外觀模式的運作方式。簡化特徵會提供指令,方便特定裝置類型執行常見工作。簡化特徵是 Home API 特徵,與其他 Home API 特徵一樣,適用於 MatterCloud-to-cloud 裝置。

簡化特徵提供替代屬性和指令子集,與對應的標準特徵相比,更適合特定裝置。舉例來說,標準 LevelControlTrait 特徵是通用特徵,適用於任何具有設定的裝置,且設定會在數值範圍內持續變化。BrightnessTrait 是簡化的特徵,可取代 LevelControlTrait,並只提供 DimmableLightDeviceType 裝置所需的指令和屬性。BrightnessTrait 具有 moveToBrightnessbrightnessPercent 指令,而 LevelControlTrait 具有多個 move 指令,其中大多數指令至少有四個參數,可因應更廣泛的用途。

下表列出各項簡化特徵和基礎標準特徵。每個特徵名稱都會連結至對應的 API 說明文件:

表格:簡化特徵
簡化特徵 標準特徵
SimplifiedThermostatTrait ThermostatTrait
BrightnessTrait LevelControlTrait
SimplifiedOnOffTrait OnOffTrait
VolumeTrait LevelControlTrait
OnOffTrait

簡化特徵和 Discovery API

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

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