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