เพื่อให้ใช้งานได้ง่าย เราจึงมีลักษณะบางอย่างในเวอร์ชันที่เรียบง่ายให้ใช้กับ Automation API ใน iOS
ลักษณะที่ลดความซับซ้อนจะแทนที่ลักษณะ Home API มาตรฐาน ซึ่งคล้ายกับวิธีการทำงานของ รูปแบบ Facade ลักษณะที่ง่ายขึ้นจะให้คำสั่งที่ช่วยให้งานทั่วไปง่ายขึ้นสำหรับ อุปกรณ์บางประเภท ลักษณะที่ลดความซับซ้อนคือลักษณะของ Home API และจะทำงานได้กับทั้งอุปกรณ์ Matter และ Cloud-to-cloud เช่นเดียวกับลักษณะอื่นๆ ของ Home API
ลักษณะที่ลดความซับซ้อนจะเสนอชุดย่อยของแอตทริบิวต์และคำสั่งที่เป็นทางเลือก ซึ่งมีความเฉพาะเจาะจงกับอุปกรณ์มากกว่าแอตทริบิวต์และคำสั่งของลักษณะมาตรฐานที่เกี่ยวข้อง
ตัวอย่างเช่น ลักษณะ
LevelControlTrait
มาตรฐานเป็นลักษณะทั่วไปที่ใช้ได้กับอุปกรณ์ทุกเครื่องที่มี
การตั้งค่าที่เปลี่ยนแปลงอย่างต่อเนื่องในช่วงค่าตัวเลข
BrightnessTrait เป็นลักษณะที่
เรียบง่ายซึ่งใช้แทน LevelControlTrait และมีเฉพาะ
คำสั่งและแอตทริบิวต์ที่อุปกรณ์ DimmableLightDeviceType
ต้องการ BrightnessTrait มีคำสั่ง
moveToBrightness
ที่รับอาร์กิวเมนต์ brightnessPercent รายการเดียว ในขณะที่
LevelControlTrait มีคำสั่ง move หลายรายการ ซึ่งส่วนใหญ่มีพารามิเตอร์อย่างน้อย
4 รายการเพื่อให้รองรับกรณีการใช้งานที่หลากหลายมากขึ้น
ตารางต่อไปนี้แสดงลักษณะที่ลดความซับซ้อนแต่ละรายการและลักษณะมาตรฐานพื้นฐาน ชื่อลักษณะแต่ละรายการจะลิงก์ไปยังเอกสารประกอบ API ที่เกี่ยวข้อง
| ลักษณะที่เรียบง่าย | ลักษณะมาตรฐาน |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
แอตทริบิวต์ที่เรียบง่ายและ Discovery API
Discovery API จะรายงานลักษณะที่ลดความซับซ้อนลง รวมถึงลักษณะมาตรฐานพื้นฐาน ตราบใดที่กำหนดค่าลักษณะทั้ง 2 อย่างอย่างถูกต้องเป็น ReferencedAutomationTypes ในการกำหนดค่าสำหรับแอปของคุณ ตัวอย่างเช่น หากมีอุปกรณ์ DimmableLightDeviceType ในโครงสร้าง และนักพัฒนาแอปได้ลงทะเบียนทั้งลักษณะ LevelControlTrait และ BrightnessTrait ไว้ Discovery API จะระบุการมีอยู่ของลักษณะทั้ง 2 อย่าง
นักพัฒนาแอปอาจเลือกใช้ลักษณะใดลักษณะหนึ่งในการทำงานอัตโนมัติ
ดูข้อมูลเพิ่มเติมได้ที่การกำหนดค่าหน้าแรก