นำอุปกรณ์ออก

การนำอุปกรณ์ออกเกี่ยวข้องกับการเลิกใช้งานอุปกรณ์จากโครงสร้าง ผู้ใช้สามารถ ทำได้โดยใช้ Google Home app (GHA) และแอปสามารถ เลิกใช้งานอุปกรณ์สมาร์ทโฮมโดยอัตโนมัติได้ โดยมีข้อจำกัดเกี่ยวกับอุปกรณ์ที่นำออกได้ นอกจากนี้ การนำอุปกรณ์ออกอาจส่งผลต่อโครงสร้างและประสบการณ์ของผู้ใช้ สำหรับแอปของคุณ

สิ่งที่คุณนำออกได้

คุณนำอุปกรณ์ต่อไปนี้ออกโดยใช้โปรแกรมผ่าน Home API ได้

  • Matter อุปกรณ์ที่แอปของคุณมีสิทธิ์เข้าถึง
  • Matter หากแอปของคุณมีสิทธิ์เข้าถึงอุปกรณ์ทั้งหมดที่เชื่อมต่อผ่านบริดจ์ การนำบริดจ์ออกจะเป็นการนำอุปกรณ์ Matter ทั้งหมดที่เชื่อมต่อกับบริดจ์ออก
  • อุปกรณ์กล้องและกริ่งประตูที่รองรับ ซึ่งรวมถึงกล้องและกริ่งประตู Google Nest ที่รองรับ Matter รวมถึงกล้องของพาร์ทเนอร์ที่เข้ากันได้ ดูรายละเอียดเกี่ยวกับรุ่นที่รองรับและไม่รองรับได้ที่ กล้องและกริ่งประตู

สิ่งที่คุณนำออกไม่ได้

คุณนำอุปกรณ์ต่อไปนี้ออกแบบเป็นโปรแกรมผ่าน Home API ไม่ได้

  • Matter อุปกรณ์ที่แอปของคุณไม่มี สิทธิ์ของผู้ใช้
  • อุปกรณ์แต่ละเครื่องที่เชื่อมต่ออยู่หลังบริดจ์ Matter
  • มีอุปกรณ์ที่ลิงก์ไว้ Cloud-to-cloud เครื่อง
  • อุปกรณ์แบบ 2 เส้นทางที่ไม่ใช่กล้อง (อุปกรณ์ที่ใช้ทั้ง Matter และ Cloud-to-cloud นอกเหนือจาก กล้องและกริ่งประตูที่รองรับ)
  • อุปกรณ์กล้องและกริ่งประตูที่ไม่รองรับ รวมถึงจออัจฉริยะที่มีกล้องในตัวและกล้องรุ่นเดิมที่ไม่รองรับ Matter (ดูกล้องและกริ่งประตู)

ข้อควรพิจารณาที่สำคัญก่อนนำอุปกรณ์ออก

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

  • หากอุปกรณ์มีฟังก์ชันหลายอย่าง เช่น หลอดไฟอัจฉริยะที่ทำหน้าที่เป็นฮับด้วย การนำอุปกรณ์ดังกล่าวออกจะเป็นการนำอุปกรณ์ที่เชื่อมโยงทั้งหมดออกด้วย แอป ควรแจ้งให้ผู้ใช้ทราบหากฟังก์ชันของอุปกรณ์หลายอย่างได้รับผลกระทบ
  • การนำกล้องหรือกริ่งประตูออกจะเป็นการลบประวัติวิดีโอทุกวันตลอด 24 ชั่วโมง ประวัติวิดีโอของเหตุการณ์ คลิปที่บันทึกไว้ และข้อมูลคลังใบหน้าที่คุ้นเคย ที่เชื่อมโยงกับกล้องนั้นในโครงสร้างบ้านทั้งหมดอย่างถาวร
  • การเลิกใช้งานกล้องจะไม่ยกเลิกการสมัครใช้บริการที่ใช้งานอยู่ เช่น Google Home Premium หรือบริการตรวจสอบของพาร์ทเนอร์ การสมัครใช้บริการ จะดำเนินต่อไปจนกว่าผู้ใช้จะยกเลิก
  • เมื่อเลิกใช้งานกล้องหรือกริ่งประตู แพลตฟอร์ม Home APIs จะแสดงหน้าจอยืนยันที่ Google จัดการให้แก่ผู้ใช้เพื่ออธิบายว่า ระบบจะลบประวัติวิดีโออย่างถาวร ผู้ใช้ต้องยืนยันข้อความนี้ ก่อนนำอุปกรณ์ออก
  • โปรดใช้ความระมัดระวังในการลบอุปกรณ์ในแพลตฟอร์มที่แชร์ เนื่องจากอาจส่งผลกระทบโดยไม่ตั้งใจต่อผู้อื่น
  • การนำอุปกรณ์ออกต้องดำเนินการในแพลตฟอร์มที่ได้รับการตรวจสอบสิทธิ์เท่านั้น เช่น โทรศัพท์มือถือ ไม่ใช่ในอุปกรณ์ที่ไม่ได้รับการตรวจสอบสิทธิ์ เช่น ทีวี การดำเนินการดังกล่าวละเมิดนโยบายสำหรับนักพัฒนาแอป Google Home

นำอุปกรณ์ออก

การตรวจสอบสิทธิ์ของอุปกรณ์ในการนำออกมีค่าใช้จ่ายสูงและควรทำเฉพาะในกรณีที่จำเป็นเท่านั้น หากต้องการตรวจสอบว่าอุปกรณ์มีสิทธิ์นำออกหรือไม่ ให้ใช้คำสั่งต่อไปนี้

swift let eligibility = try await device.decommissionEligibility

อุปกรณ์ Matter

คุณนำอุปกรณ์ Matter ออกได้โดยใช้โปรแกรมหากอุปกรณ์ไม่ได้อยู่หลังบริดจ์ Matter

หากต้องการนำMatterอุปกรณ์ออก ให้โทรหา decommission()อุปกรณ์ดังกล่าว

swift let decommissionedDeviceIDs = try await device.decommission()

หากการเรียกใช้ไม่ทำให้เกิดข้อผิดพลาด แสดงว่าสำเร็จ

คุณตรวจสอบได้ว่ารหัสของอุปกรณ์อยู่ในรายการที่ส่งคืนโดย decommission()หรือไม่ โดยทำดังนี้

swift do { let decommissionedDeviceIDs = try await device.decommission() print("The following devices were decommissioned: \(decommissionedDeviceIDs)") } catch { print("An error occurred: \(error)") }

กล้องและกริ่งประตู

คุณสามารถนำกล้องและกริ่งประตูที่รองรับออกได้แบบเป็นโปรแกรมโดยใช้ decommission()

รุ่นที่รองรับมีดังนี้

  • Google Nest Cam (indoor, wired)
  • Google Nest Cam (outdoor or indoor, battery)
  • Google Nest Cam with floodlight
  • Google Nest Doorbell (battery)
  • Google Nest Doorbell (wired)
  • กล้องและกริ่งประตูของพาร์ทเนอร์ที่เข้ากันได้ (เช่น Walmart onn.)

อุปกรณ์กล้องและกริ่งประตูต่อไปนี้ไม่สามารถเลิกใช้งาน โดยใช้โปรแกรมได้

  • จอแสดงผลอัจฉริยะที่มีกล้องในตัว เช่น Google Nest Hub Max
  • กล้องและกริ่งประตู Nest รุ่นเดิมที่ไม่รองรับ Matter และเชื่อมต่อผ่านบริการระบบคลาวด์เท่านั้น เช่น Nest Cam Indoor (รุ่นที่ 1), Nest Cam Outdoor (รุ่นที่ 1), Nest Cam IQ และ Nest Doorbell (แบบใช้สาย, รุ่นที่ 1)
  • Cloud-to-cloud กล้องและกริ่งประตูของบุคคลที่สามที่ลิงก์ไว้

เมื่อแอปเริ่มหยุดให้บริการกล้องหรือกริ่งประตู แพลตฟอร์มจะแสดงหน้าจอยืนยันที่ Google จัดการต่อผู้ใช้ หน้าจอนี้ จะแจ้งให้ผู้ใช้ทราบว่าการนำกล้องออกจะเป็นการลบประวัติวิดีโอทุกวันตลอด 24 ชั่วโมง ประวัติเหตุการณ์ คลิป และข้อมูลคลังใบหน้าที่คุ้นเคยที่บันทึกไว้ทั้งหมด ซึ่งเชื่อมโยงกับอุปกรณ์ในโครงสร้างทั้งหมดอย่างถาวร

หากผู้ใช้ปิดหรือยกเลิกหน้าจอยืนยัน decommission() จะส่ง HomeError

การเลิกใช้งานกล้องไม่ได้เป็นการยกเลิกการสมัครใช้บริการกล้องที่ใช้งานอยู่ (เช่น Google Home Premium) ผู้ใช้ต้องยกเลิกการสมัครใช้บริการแยกต่างหากผ่าน ผู้ให้บริการสมัครใช้บริการ

swift do { let decommissionedDeviceIDs = try await device.decommission() if decommissionedDeviceIDs.contains(device.id) { // Camera was successfully decommissioned } } catch { // Handle cancellation or decommission error }

อุปกรณ์ที่ไม่ใช่ Matter

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

หากคุณเรียกใช้ decommission() ในอุปกรณ์ที่ไม่รองรับ Matter ระบบจะแสดงข้อผิดพลาด HomeError

เมื่อนำอุปกรณ์ที่ไม่ใช่ Matter ออกแล้ว ให้ตรวจสอบว่าอุปกรณ์นั้นยังอยู่หรือไม่เพื่อยืนยันว่านำออกสำเร็จแล้ว

swift guard try await !self.context.devices().list().contains(where: { $0.id == deviceID }) else { // The device still exists in Home APIs }