โมเดลข้อมูลใน iOS

Home API สำหรับ iOS จะแสดงอุปกรณ์ทั้งหมดในระบบนิเวศของ Google Home ในรูปแบบข้อมูลแบบรวม โมเดลข้อมูลนี้ครอบคลุมอุปกรณ์ทุกประเภท (จาก Google Nest หรือผู้ผลิตบุคคลที่สาม) ไม่ว่าจะเป็นเทคโนโลยีสมาร์ทโฮมที่สำคัญ (เช่น Matter หรือ Cloud-to-cloud) และมีแพลตฟอร์ม API ทั่วไปเพื่อสร้างประสบการณ์ของผู้ใช้สำหรับทั้งsmart homeและนักพัฒนาแอปบนอุปกรณ์เคลื่อนที่

ประเภทอุปกรณ์

ประเภทอุปกรณ์ที่แสดงใน Home API เป็นการรวมโมเดลข้อมูล Matter และ Cloud-to-cloud เข้าด้วยกัน บางประเภทมาจาก Matter โดยตรง บางประเภทเป็นส่วนขยายของประเภทอุปกรณ์ Matter และบางประเภทมาจาก Cloud-to-cloud

ประเภทอุปกรณ์ประกอบด้วยลักษณะที่ใช้ในการควบคุมและจัดการอุปกรณ์ ลักษณะต่างๆ จะได้มาจากคลัสเตอร์ Matter และลักษณะ Cloud-to-cloud เช่นเดียวกับประเภทอุปกรณ์ และจะแสดงในรูปแบบทั่วไปที่คล้ายกับคลัสเตอร์ Matter ใน Home API ลักษณะที่ได้มาจาก Matter จะเรียกว่าลักษณะ ไม่ใช่คลัสเตอร์

ด้วยเหตุนี้ ประเภทอุปกรณ์และลักษณะใน Home API จึงมีไว้สำหรับ Matter เป็นหลัก ประเภทอุปกรณ์หรือลักษณะของ Matter จะมีความสำคัญเหนือกว่าแอนะล็อกของ Cloud-to-cloud

ดูรายการประเภทอุปกรณ์และลักษณะของอุปกรณ์ได้ที่ประเภทอุปกรณ์ที่รองรับใน iOS

ลักษณะเฉพาะ

ระบบจะสร้างลักษณะเวอร์ชัน Swift เพื่อใช้ใน Home API และมีฟีเจอร์เพิ่มเติมเฉพาะสำหรับ Home API (ไม่พบใน Matter หรือ Cloud-to-cloud) ตัวอย่างเช่น ลักษณะแต่ละรายการมีเมธอดสำหรับตรวจสอบว่าลักษณะรองรับแอตทริบิวต์หรือคำสั่งที่เฉพาะเจาะจงหรือไม่ ซึ่งจะเป็นประโยชน์เมื่อพิจารณาว่าสามารถอ่านสถานะหรือดำเนินการบางอย่างในอุปกรณ์ของผู้ใช้ได้หรือไม่ เนื่องจากอุปกรณ์บางเครื่องในประเภทอุปกรณ์อาจไม่มีฟีเจอร์เดียวกันทั้งหมด

หากต้องการนำเข้าลักษณะและประเภทอุปกรณ์ ให้นำเข้าโมดูล GoogleHomeTypes ไปยังแอปพลิเคชันของคุณ

import GoogleHomeTypes

นอกจากนี้ คุณยังใช้ typealias สำหรับชื่อลักษณะและประเภทอุปกรณ์เพื่อย่อโค้ดและหลีกเลี่ยงการซ้ำเนมสเปซได้ด้วย

import GoogleHomeTypes

typealias OpenCloseTrait = Google.OpenCloseTrait
typealias OnOffTrait = Matter.OnOffTrait
typealias FanDevice = Matter.FanDeviceType

ระบบรองรับลักษณะส่วนใหญ่สำหรับการใช้งานกับการทำงานอัตโนมัติ และลักษณะบางอย่างจะพร้อมใช้งานสำหรับการทำงานอัตโนมัติเท่านั้น ดูรายละเอียดเพิ่มเติมได้ที่การรองรับลักษณะของ Automation API ใน Android

องค์ประกอบประเภทอุปกรณ์

Home API รองรับคลัสเตอร์แอปพลิเคชัน Matter ส่วนใหญ่เป็นลักษณะเฉพาะในโมเดลข้อมูล คลัสเตอร์การกำหนดค่าระดับต่ำที่ไม่มีประโยชน์โดยตรงสำหรับผู้ใช้ปลายทาง เช่น Binding จะไม่แสดงโดยตรงผ่าน Home API ดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มอุปกรณ์ได้ที่ Structure API

ลักษณะที่ได้มาจากลักษณะสมาร์ทโฮมของ Cloud-to-cloud มักจะมีชื่อเดียวกันระหว่าง Cloud-to-cloud และ Home API เช่น ในตัวอย่างของ OpenCloseTrait ส่วนอื่นๆ จะแสดงเป็นส่วนขยายของลักษณะ Matter ซึ่งสร้างขึ้นโดยใช้ส่วนขยายเฉพาะของผู้ผลิต Matter ลักษณะเหล่านี้จะช่วยลดช่องว่างสำหรับลักษณะ smart home ซึ่งฟังก์ชันการทำงานจะแบ่งระหว่าง SDK ของ Matter และระบบนิเวศของ Google Home ตัวอย่างที่เจาะจงของกรณีนี้คือประเภทอุปกรณ์ Google* ซึ่งมาจาก Cloud-to-cloud แต่ยังไม่มีอุปกรณ์ที่เทียบเท่าใน Matter

ประเภทอุปกรณ์ประกอบด้วยลักษณะจากแหล่งที่มาอย่างใดอย่างหนึ่งหรือทั้ง 2 แหล่ง ได้แก่ Matter หรือ Cloud-to-cloud

ตัวอย่างเช่น FanDeviceType ประกอบด้วยทั้ง 2 อย่างและมีลักษณะ 3 ประการดังนี้

• ลักษณะ IdentifyTrait Matter มีฟังก์ชันการทำงานทั้งหมดจาก Matter IdentifyTrait
• ลักษณะ FanControlTrait Matter มีฟังก์ชันการทำงานทั้งหมดจาก Matter FanControlTrait
• ExtendedFanControlTraitลักษณะของ Google มีฟังก์ชันการทำงานทั้งหมดจาก smart home FanSpeedTrait ของ Google ที่ไม่ครอบคลุมโดยลักษณะของ FanControlTrait Matter

องค์ประกอบลักษณะประเภทนี้มีโมเดลที่ยืดหยุ่นสำหรับฟังก์ชันการทำงานของประเภทอุปกรณ์ที่สมบูรณ์ โดยสรุปโมเดลข้อมูล smart home ที่สำคัญ

กลุ่มอุปกรณ์

กลุ่มอุปกรณ์แสดงถึงคอลเล็กชันอุปกรณ์ที่ผู้ใช้กำหนดภายในโครงสร้างเดียว กลุ่มอุปกรณ์จะแสดงด้วยเอนทิตี DeviceGroup ซึ่งแตกต่างจาก HomeDevice

ดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มอุปกรณ์ได้ที่ Structure API