إزالة جهاز

تتضمّن إزالة جهاز إيقافه نهائيًا من البنية. يمكن للمستخدم إجراء ذلك باستخدام Google Home app (GHA)، ويمكن للتطبيق إيقاف جهاز منزلي ذكي نهائيًا بشكل آلي. هناك قيود على الأجهزة التي يمكن إزالتها. يمكن أن تؤثر إزالة جهاز أيضًا في بنية تطبيقك وتجارب المستخدمين.

المحتوى الذي يمكنك إزالته

يمكنك إزالة الأجهزة التالية آليًا من خلال واجهات برمجة التطبيقات Home:

  • Matter جهازًا حصل تطبيقك على أذونات الوصول إليها.
  • يمكن استخدام جسر Matter، شرط أن يكون تطبيقك لديه إذن بالوصول إلى جميع الأجهزة المتصلة من خلال الجسر. تؤدي إزالة الجسر إلى إزالة جميع أجهزة Matter المرتبطة به.
  • أجهزة الكاميرات وأجراس الأبواب المتوافقة، بما في ذلك كاميرات وأجراس Google Nest المتوافقة مع Matter، بالإضافة إلى كاميرات الشركاء المتوافقة لمعرفة تفاصيل حول الطُرز المتوافقة وغير المتوافقة، يُرجى الاطّلاع على الكاميرات وأجراس الباب.

ما لا يمكنك إزالته

لا يمكن إزالة الأجهزة التالية آليًا من خلال واجهات برمجة التطبيقات Home:

  • Matter جهازًا لا يملك تطبيقك أذونات المستخدمين عليه.
  • الأجهزة الفردية المتصلة من خلال جسر Matter
  • Cloud-to-cloud جهازًا مرتبطًا
  • الأجهزة ذات المسار المزدوج غير الكاميرات (الأجهزة التي تتضمّن كلاً من Matter وCloud-to-cloud، بخلاف الكاميرات وأجراس الباب المتوافقة)
  • أجهزة الكاميرات وأجراس الأبواب غير المتوافقة، بما في ذلك الشاشات الذكية المزودة بكاميرات والكاميرات القديمة التي لا تتوافق مع Matter (راجِع الكاميرات وأجراس الأبواب)

اعتبارات مهمة قبل إزالة جهاز

عندما يزيل تطبيقك جهازًا، تتم إزالته من البنية بأكملها، ما يؤثر في جميع المستخدمين وجميع التطبيقات، بما في ذلك GHA. استنادًا إلى نوع الجهاز، قد تترتّب آثار جانبية إضافية على إيقاف جهاز نهائيًا:

  • إذا كان الجهاز يوفّر وظائف متعددة، مثل مصباح ذكي يعمل أيضًا كمركز، ستؤدي إزالته إلى إزالة جميع الأجهزة المرتبطة به. يجب أن يبلغ التطبيق المستخدم إذا تأثّرت وظائف متعددة في الجهاز.
  • عند إزالة كاميرا أو جرس باب، سيتم نهائيًا حذف كل بيانات سجلّ الفيديوهات على مدار الساعة وسجلّ الأحداث بالفيديو والمقاطع المسجّلة ومكتبة الوجوه المألوفة المرتبطة بهذه الكاميرا في جميع أجزاء بنية المنزل.
  • لا يؤدي إيقاف الكاميرا إلى إلغاء الاشتراكات النشطة، مثل اشتراك 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 (الجيل الأول) وNest Cam Outdoor (الجيل الأول) وNest Cam IQ و Nest Doorbell (سلكي، الجيل الأول)
  • Cloud-to-cloud الكاميرات وأجراس الأبواب المرتبطة بحسابات تابعة لجهات خارجية

عندما يبدأ تطبيقك عملية إيقاف كاميرا أو جرس باب، تعرض المنصة شاشة تأكيد تديرها Google للمستخدم. تُعلم هذه الشاشة المستخدم بأنّ إزالة الكاميرا سيؤدي إلى حذف نهائي لكل بيانات سجلّ الفيديو على مدار الساعة وسجلّ الأحداث والمقاطع ومكتبة الوجوه المألوفة المرتبطة بالجهاز في جميع أنحاء المنزل.

إذا أغلق المستخدم شاشة التأكيد أو ألغاها، سيُظهر 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!")
}