เพื่อความสะดวกในการใช้งาน เราจึงมีลักษณะบางอย่างในเวอร์ชันที่เรียบง่ายให้ใช้กับ 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 อย่าง
นักพัฒนาแอปอาจเลือกใช้ลักษณะใดลักษณะหนึ่งในการทำงานอัตโนมัติ
ดูข้อมูลเพิ่มเติมได้ที่การกำหนดค่าหน้าแรก