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

Để dễ sử dụng, bạn có thể dùng các phiên bản đơn giản của một số đặc điểm 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 facade. Đặc điểm đơn giản cung cấp các lệnh giúp thực hiện các tác vụ phổ biến dễ dàng hơn đối với một số loại thiết bị. Đặc điểm đơn giản là đặc điểm Home API và giống như các đặc điểm Home API khác, chúng hoạt động cho cả MatterCloud-to-cloud thiết bị.

Đặ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 dành riêng cho thiết bị hơn 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 phạm vi giá trị số. BrightnessTrait là một đặc điểm đơn giản thay thế 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 moveToBrightness lệnh nhận một đối số brightnessPercent, trong khi LevelControlTrait có nhiều lệnh move, hầu hết trong số đó có ít nhất bốn tham số để phù hợp với 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 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 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 là ReferencedAutomationTypes trong cấu hình cho ứng dụng của bạn. Ví dụ: nếu thiết bị DimmableLightDeviceType có trong cấu trúc và nhà phát triển đã đăng ký cả đặc điểm LevelControlTraitBrightnessTrait , 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 trong quá trình tự động hoá.

Hãy xem bài viết Cấu hình nhà thông minh để biết thêm thông tin.