Các đặc điểm được đơn giản hoá trên iOS

Để dễ sử dụng, các phiên bản đơn giản của một số đặc điểm có thể được dùng với Automation API trên iOS.

Đặc điểm đơn giản thay thế cho đặc điểm Home API tiêu chuẩn, tương tự như cách hoạt động của mẫu mặt tiền. Các đặc điểm đơn giản cung cấp những lệnh giúp một số loại thiết bị thực hiện các tác vụ thường gặp dễ dàng hơn. Các đặc điểm đơn giản là đặc điểm của Home API và giống như các đặc điểm khác của Home API, chúng hoạt động cho cả thiết bị Matter và Cloud-to-cloud.

Đặc điểm đơn giản cung cấp một tập hợp con thay thế gồm các thuộc tính và lệnh cụ thể hơn cho thiết bị so với các thuộc tính và lệnh của đặc điểm tiêu chuẩn tương ứng. Ví dụ: đặc điểm tiêu chuẩn LevelControlTrait là một đặc điểm chung có thể dùng cho mọi thiết bị có chế độ cài đặt thay đổi liên tục trong một dải giá trị số. BrightnessTrait là một đặc điểm đơn giản thay cho LevelControlTrait và chỉ cung cấp các lệnh và thuộc tính mà thiết bị DimmableLightDeviceType yêu cầu. BrightnessTrait có một lệnh moveToBrightness nhận một đối số brightnessPercent duy nhất, trong khi LevelControlTrait có nhiều lệnh move, hầu hết các lệnh này có ít nhất 4 tham số để đáp ứng nhiều trường hợp sử dụng hơn.

Bảng sau đây cho thấy từng đặc điểm đơn giản và(các) đặc điểm tiêu chuẩn cơ bản. Mỗi tên đặc điểm đều liên kết đến tài liệu API tương ứng:

Bảng: Đặc điểm đơn giản

Đặc điểm đơn giản	Đặc điểm tiêu chuẩn
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Đặc điểm đơn giản hoá và Discovery API

Discovery API báo cáo các đặc điểm đơn giản cũng như các đặc điểm tiêu chuẩn cơ bản, miễn là cả hai đặc điểm đều được định cấu hình chính xác dưới dạng ReferencedAutomationTypes trong cấu hình cho ứng dụng của bạn. Ví dụ: nếu có thiết bị DimmableLightDeviceType trong cấu trúc và nhà phát triển đã đăng ký cả đặc điểm LevelControlTrait và BrightnessTrait, thì Discovery API sẽ cho biết sự hiện diện của cả hai đặc điểm. Nhà phát triển có thể chọn sử dụng một trong hai đặc điểm này trong quy trình tự động hoá của họ.

Hãy xem phần Cấu hình trang chủ để biết thêm thông tin.