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

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