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

การนำอุปกรณ์ออกเกี่ยวข้องกับการเลิกใช้งานอุปกรณ์จากโครงสร้าง ผู้ใช้สามารถ ทำได้โดยใช้ 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

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

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

val eligibility = device.checkDecommissionEligibility()

if (eligibility is DecommissionEligibility.Ineligible) {
  println("The device cannot be decommissioned.")
} else if (eligibility is DecommissionEligibility.EligibleWithSideEffects) {
  println("The device can be decommissioned but there will be side effects on other devices.")
} else if (eligibility is DecommissionEligibility.Eligible) {
  println("The device can be decommissioned.")
}

อุปกรณ์ Matter

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

หากต้องการนำMatterอุปกรณ์ออก ให้โทรหา decommissionDevice() ในอุปกรณ์

val decommissionedDeviceIds = device.decommissionDevice()

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

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

if (decommissionedDeviceIds.contains(deviceId)) {
  println("Decommission successful!")
} else {
  println("Decommission failed!")
}

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

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

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

  • 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 ชั่วโมง ประวัติเหตุการณ์ คลิป และข้อมูลคลังใบหน้าที่คุ้นเคยที่บันทึกไว้ทั้งหมด ซึ่งเชื่อมโยงกับอุปกรณ์ในโครงสร้างทั้งหมดอย่างถาวร

หากผู้ใช้ปิดหรือยกเลิกหน้าจอยืนยัน decommissionDevice() จะเกิด HomeException

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

kotlin try { val decommissionedDeviceIds = device.decommissionDevice() if (decommissionedDeviceIds.contains(device.id)) { // Camera was successfully decommissioned } } catch (e: HomeException) { // Handle cancellation or decommission error }

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

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

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

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

var removedDevice: HomeDevice? = null
runBlockingCustom {
  try {
    removedDevice = homeManager.devices().get(deviceId)
  } catch (exception: Exception) {
    println("removal successful!")
  }
}
if (removedDevice != null) {
  println("removal failed!")
}