ลักษณะที่เรียบง่ายใน iOS

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

ดูข้อมูลเพิ่มเติมได้ที่การกำหนดค่าบ้าน