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

เพื่อความสะดวกในการใช้งาน เรามีลักษณะบางอย่างในเวอร์ชันที่เรียบง่ายขึ้นให้ใช้งานกับ 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	LevelControlTrait OnOffTrait

ลักษณะที่เรียบง่ายและ Discovery API

Discovery API จะรายงานลักษณะที่เรียบง่ายขึ้น รวมถึงลักษณะมาตรฐานที่เกี่ยวข้อง ตราบใดที่มีการกำหนดค่าลักษณะทั้ง 2 อย่างเป็น ReferencedAutomationTypes อย่างถูกต้องในการกำหนดค่าสำหรับแอปของคุณ ตัวอย่างเช่น หากมีอุปกรณ์ DimmableLightDeviceType อยู่ในโครงสร้าง และนักพัฒนาแอปได้ลงทะเบียนทั้งลักษณะ LevelControlTrait และ BrightnessTrait ไว้ Discovery API จะระบุว่ามีลักษณะทั้ง 2 อย่างอยู่ นักพัฒนาแอปสามารถเลือกใช้ลักษณะใดลักษณะหนึ่งในระบบอัตโนมัติของตน

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