برداشتن دستگاه

برداشتن دستگاه شامل ازکار انداختن آن در ساختار می‌شود. کاربر می‌تواند این کار را بااستفاده از Google Home app (GHA) انجام دهد، و برنامه می‌تواند به‌طور برنامه‌نویسی‌شده دستگاه خانه هوشمند را از کار بیندازد. محدودیت‌هایی برای دستگاه‌هایی که می‌توانند برداشته شوند وجود دارد. همچنین، برداشتن دستگاه می‌تواند بر ساختار و تجربه‌های کاربری برنامه‌تان تأثیر بگذارد.

آنچه می‌توانید بردارید

می‌توانید دستگاه‌های زیر را به‌صورت برنامه‌نویسی‌شده ازطریق Home API بردارید:

  • Matter دستگاهی که برنامه‌تان برای آن‌ها اجازه دارد.
  • پل‌های Matter، به‌شرطی که برنامه‌تان به همه دستگاه‌های متصل‌شده ازطریق پل دسترسی داشته باشد. با برداشتن پل، همه دستگاه‌های Matter متصل به آن برداشته می‌شود.
  • دستگاه‌های دوربین و زنگ در پشتیبانی‌شده، ازجمله دوربین‌ها و زنگ‌های در Google Nest سازگار با Matter و همچنین دوربین‌های شریک سازگار. برای جزئیات مربوط به مدل‌های پشتیبانی‌شده و پشتیبانی‌نشده، دوربین‌ها و زنگ‌های در را ببینید.

مواردی که نمی‌توانید بردارید

دستگاه‌های زیر را نمی‌توان به‌صورت برنامه‌نویسی‌شده ازطریق Home APIs برداشت:

  • Matter دستگاهی که برنامه شما برای آن‌ها اجازه‌های کاربر را ندارد.
  • دستگاه‌های تکی متصل‌شده پشت پل Matter.
  • ‫Cloud-to-cloud دستگاه پیوندشده.
  • دستگاه‌های دومسیره بدون دوربین (دستگاه‌هایی که هم Matter و هم Cloud-to-cloud را پیاده‌سازی می‌کنند، به‌غیراز دوربین‌ها و زنگ‌های در پشتیبانی‌شده).
  • دستگاه‌های دوربین و زنگ در پشتیبانی‌نشده، ازجمله نمایشگرهای هوشمند با دوربین‌های داخلی و دوربین‌های قدیمی که از Matter پشتیبانی نمی‌کنند (به دوربین‌ها و زنگ‌های در مراجعه کنید).

ملاحظات مهم قبل‌از برداشتن دستگاه

وقتی برنامه‌تان دستگاهی را برمی‌دارد، آن دستگاه از کل ساختار برداشته می‌شود و این امر بر همه کاربران و همه برنامه‌ها، ازجمله GHA، تأثیر می‌گذارد. بسته به نوع دستگاه، ممکن است ازکار انداختن دستگاه عوارض جانبی دیگری داشته باشد:

  • اگر دستگاهی چند عملکرد ارائه می‌دهد، مثلاً چراغ هوشمندی که به‌عنوان کانون هم عمل می‌کند، برداشتن آن باعث برداشتن همه دستگاه‌های منسوب به آن نیز می‌شود. اگر چند عملکرد دستگاه تحت‌تأثیر قرار می‌گیرد، برنامه باید به کاربر اطلاع دهد.
  • با برداشتن دوربین یا زنگ در، همه سابقه ویدیویی شبانه‌روزی، سابقه ویدیویی رویداد، کلیپ‌های ضبط‌شده، و داده‌های کتابخانه چهره آشنای مرتبط با آن دوربین در کل ساختار خانه برای همیشه حذف می‌شود.
  • ازکار انداختن دوربین اشتراک‌های فعال را لغو نمی‌کند، مثلاً Google Home Premium یا سرویس‌های پایش شریک. اشتراک‌ها تا زمانی که کاربر لغو نکند ادامه می‌یابند.
  • هنگام ازکار انداختن دوربین یا زنگ در، پلاتفرم Home APIs صفحه تأیید تحت مدیریت Google را به کاربر نشان می‌دهد که توضیح می‌دهد سابقه ویدیویی برای همیشه پاک خواهد شد. کاربر باید این پیام‌واره را تأیید کند تا دستگاه برداشته شود.
  • هنگام حذف دستگاه‌ها در محیط‌های مشترک احتیاط کنید، زیرا این کار می‌تواند پیامدهای ناخواسته‌ای برای دیگران داشته باشد.
  • برداشتن دستگاه فقط باید در سطوح اصالت‌سنجی‌شده، مثل تلفن همراه، انجام شود نه در دستگاه‌های اصالت‌سنجی‌نشده مثل تلویزیون. انجام این کار ناقض خط‌مشی‌های توسعه‌دهندگان Google Home است.

برداشتن دستگاه

بررسی واجدشرایط بودن دستگاه برای برداشته شدن پرهزینه است و فقط باید درصورت لزوم انجام شود. برای بررسی اینکه آیا دستگاهی واجدشرایط برداشته شدن است یا نه، از فرمان زیر استفاده کنید:

let eligibility = try await device.decommissionEligibility

دستگاه‌های Matter

اگر دستگاه پشت پل Matter نباشد، می‌توانید دستگاه Matter را به‌صورت برنامه‌نویسی‌شده بردارید.

برای برداشتن دستگاه Matter، decommission() را در آن فراخوانی کنید:

let decommissionedDeviceIDs = try await device.decommission()

اگر تماس خطایی ایجاد نکند، موفقیت‌آمیز بوده است.

می‌توانید بررسی کنید که آیا شناسه دستگاه در میان شناسه‌های برگردانده‌شده توسط decommission() است یا نه:

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 ویژه فضای بسته (نسل اول)، Nest Cam ویژه فضای باز (نسل اول)، Nest Cam IQ، و Nest Doorbell (سیمی، نسل اول).
  • دوربین‌ها و زنگ‌های در پیوندشده Cloud-to-cloud طرف سوم.

وقتی برنامه‌تان ازکاراندازی دوربین یا زنگ دری را آغاز می‌کند، پلاتفرم صفحه تأیید تحت مدیریت Google را به کاربر نشان می‌دهد. این صفحه به کاربر اطلاع می‌دهد که برداشتن دوربین باعث حذف دائمی همه سابقه ویدیویی بی‌وقفه، سابقه رویداد، کلیپ‌ها، و داده‌های کتابخانه چهره آشنای ضبط‌شده مرتبط با دستگاه در کل ساختار می‌شود.

اگر کاربر صفحه تأیید را ببندد یا لغو کند، decommission() HomeError را برمی‌گرداند.

ازکار انداختن دوربین اشتراک‌های فعال دوربین (مانند Google Home Premium) را لغو نمی‌کند. کاربران باید اشتراک‌ها را به‌طور جداگانه ازطریق ارائه‌دهنده اشتراک لغو کنند.

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، وجود دستگاه را بررسی کنید تا مطمئن شوید باموفقیت برداشته شده است:

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