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