یادداشت‌های انتشار کیت توسعه نرم‌افزار Android برای Home APIs

2026-10-22

  نسخه ۱.۱۱.۱ از Home APIs GA  

این نسخه حاوی رفع اشکال است و کیفیت GA را برای کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

ویژگی‌های جدید

تغییرات مهم دیگر

مشکلات شناخته‌شده

  • پس‌از خاموش و روشن کردن دوربین، ممکن است وضعیت اتصال آن به‌جای ONLINE، PARTIAL_ONLINE گزارش شود. همه ویژگی‌های دوربین ابری همچنان به‌طور عادی کار می‌کنند، به‌جز ازکاراندازی Matter.

2026-09-23

  Home APIs GA release 1.11  

این نسخه حاوی رفع اشکال است و کیفیت GA را برای کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

به‌روزرسانی‌های مهم

ویژگی‌های جدید

تغییرات مهم دیگر

2026-09-16

دو سرور MCP جدید راه‌اندازی کرده‌ایم. Home MCP به نماینده‌های شخصی اجازه می‌دهد به‌طور ایمن با خانه هوشمند شما تعامل داشته باشند، درحالی‌که Home Developer MCP اسناد Home Developer Center و دیگر منابع خانه هوشمند را برای جستجو و پرسمان دراختیار نماینده‌های دلخواه شما قرار می‌دهد.

ویژگی‌های جدید

2026-09-16

«برنامه نمونه Android» برای Home APIs برای نسخه ۱.۱۰.۱ از Home APIs به‌روزرسانی شده است.

برنامه نمونه

2026-08-28

  Home APIs GA release 1.10.1  

این نسخه حاوی رفع اشکال است و کیفیت GA را برای کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

به‌روزرسانی‌های مهم

ویژگی‌های جدید

تغییرات مهم دیگر

2026-08-07

«برنامه نمونه Android» برای Home APIs برای نسخه ۱.۱۰ از Home APIs به‌روز شده است.

برنامه نمونه

2026-08-03

  Home APIs GA release 1.10  

این نسخه حاوی رفع اشکال است و کیت توسعه نرم‌افزار Android برای Home APIs را به کیفیت GA ارتقا می‌دهد.

پایین‌ترین نسخه‌ها

2026-07-09

پرچم forceLaunch منسوخ شده است. برنامه‌ها باید به ForcePermissionFlow enum منتقل شوند تا رفتار واسط کاربر رضایت را مشخص کنند.

تغییرات آینده

2026-07-08

راهنمای دستگاه رهیاب مرزی برای Android اکنون دردسترس است.

محتوای جدید

2026-07-07

برنامه نمونه Android برای Home APIs برای نسخه ۱.۹.۱ از Home APIs به‌روزرسانی شده است.

برنامه نمونه

2026-06-26

  Home APIs Public Beta release 1.9.1  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

ویژگی‌های جدید

مشکلات شناخته‌شده برطرف شد

  • راه‌اندازی با «جفت‌سازی سریع» برای مدل‌های دستگاه Google Nest Cam ویژه فضای باز (سیمی، نسل دوم)، Google Nest Cam ویژه فضای بسته (سیمی، نسل سوم)، و Doorbell (سیمی، نسل سوم) پشتیبانی نمی‌شود.

2026-06-09

برنامه نمونه Android برای Home APIs برای نسخه ۱.۹.۰ از Home APIs به‌روز شده است.

برنامه نمونه

2026-05-29

  Home APIs Public Beta release 1.9  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

ویژگی‌های جدید

مشکلات شناخته‌شده

  • راه‌اندازی با «جفت‌سازی سریع» برای مدل‌های دستگاه Google Nest Cam ویژه فضای باز (سیمی، نسل دوم)، Google Nest Cam ویژه فضای بسته (سیمی، نسل سوم)، و Doorbell (سیمی، نسل سوم) پشتیبانی نمی‌شود.

2026-05-26

برنامه نمونه Home APIs Android برای نسخه ۱.۸.۱ از Home APIs به‌روزرسانی شده است.

برنامه نمونه

2026-05-01

  Home APIs Public Beta release 1.8.1  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

ویژگی‌های جدید

  • مشخصه دماپا اکنون از قابلیت‌های «خواندن/به‌روزرسانی»، «روشن/خاموش»، و «زمان‌سنج» پشتیبانی می‌کند

مشکلات شناخته‌شده برطرف شد

  • ممکن است راه‌اندازی دستگاه Matter ناموفق باشد.
  • چراغ Philips BLE وضعیت صحیح را نشان نمی‌دهد.
  • تأخیر باعث ناپایداری شبکه و کندی زمان پاسخ می‌شود.

مشکلات شناخته‌شده

  • برخی‌از دستگاه‌ها بااستفاده از Google TV Streamer, 4K راه‌اندازی نشدند.
  • وقتی هاب Nest Wifi Pro،‏ Google Nest Hub، یا Google Nest Hub Max باشد، برنامه Google Home دستگاه‌های چندبخشی را به‌صورت چند کاشی نمایش می‌دهد.

2026-04-10

«برنامه نمونه Android» برای Home APIs برای نسخه ۱.۸ Home APIs به‌روز شده است.

برنامه نمونه

2026-04-09

  نسخه ۱.۸ بتای عمومی Home APIs  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: ‏ ۲۶.۱۲.۳۲
  • سفت‌افزار Google hub،‏ Cast،‏ Nest WiFi Pro: نسخه ۳.۷۸.۵۱۸۳۴۹
  • سفت‌افزار مرکز کنترل Google،‏ Cast، همه مراکز کنترل مبتنی بر Cast دیگر: 3.78.526062
  • سفت‌افزار Google Hub،‏ Fuchsia: ‏29.20251023.103.2101601
  • سفت‌افزار Google hub،‏ Google TV Streamer،‏ 4K: ‏UTTK.250729.004
  • کیت توسعه نرم‌افزار Android: home.android.sdk_GHP_1_8_0
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.1.0
  • نسخه Matter: پشتیبانی آزمایشی از نسخه ۱.۵.۰

ویژگی‌های جدید

مشکلات شناخته‌شده برطرف شد

  • نمی‌توان واحد دمای (سانتی‌گراد/فارنهایت) Google Nest Learning Thermostat (نسل چهارم) را تغییر داد.
  • در نسخه تلفن همراه Google Home برای وب، نماد بالا و دکمه برگشتن با سرصفحه پوشانده شده است. ممکن است کاربران نتوانند به عقب برگردند یا عناصر کلیدی میانای کاربر را ببینند.
  • ممکن است کانون Android TV دستگاه‌های Matter را به‌اشتباه «آفلاین» گزارش کند.

مشکلات شناخته‌شده

  • ممکن است راه‌اندازی دستگاه Matter ناموفق باشد.

2026-03-13

  Home APIs Public Beta release 1.7.1  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play:
  • سفت‌افزار Google hub،‏ Cast،‏ Nest WiFi Pro: نسخه ۳.۷۸.۵۱۸۳۴۹
  • سفت‌افزار Google Hub،‏ Cast، همه مراکز کنترل مبتنی بر Cast دیگر: 3.78.516526
  • سفت‌افزار Google Hub،‏ Fuchsia: ‏ 29.20251023.103.2201
  • سفت‌افزار Google hub،‏ Google TV Streamer،‏ 4K: ‏UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_7_1
  • برنامه Google Home: نسخه ۱.۷.۱
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.1.0
  • نسخه Matter: پشتیبانی آزمایشی از نسخه ۱.۵.۰

ویژگی‌های جدید

تغییرات مهم دیگر

  • حالت بدون هاب برداشته شد.

برنامه نمونه

مشکلات شناخته‌شده برطرف شد

  • برای Nest Cam Indoor/Outdoor (باتری‌دار یا سیمی) و Nest Doorbell (باتری‌دار، نسل دوم)، گزینه «زمان باقی‌مانده باتری» در «تنظیمات باتری» وجود ندارد.
  • تنظیم مدت‌زمان زنگ نادیده گرفته می‌شود.
  • چراغ Philips BLE به‌اشتباه به‌عنوان «آنلاین» نشان داده می‌شود، حتی زمانی که دستگاه واقعاً آفلاین است.

مشکلات شناخته‌شده

  • نمی‌توان واحد دمای (سانتی‌گراد/فارنهایت) Google Nest Learning Thermostat (نسل چهارم) را تغییر داد.
  • تأخیرهای احتمالی در پایداری شبکه و پاسخ‌گویی دستگاه.
  • در نسخه تلفن همراه Google Home For Web، نماد بالا و دکمه برگشتن با سرصفحه پوشانده شده است. ممکن است کاربران نتوانند به عقب برگردند یا عناصر کلیدی میانای کاربر را ببینند.
  • ممکن است Hub پس‌از OOBE حالت «فدراسیون» در وضعیت «درحال اتصال…» گیر کند.
  • ممکن است راه‌اندازی دستگاه Matter ناموفق باشد.
  • ممکن است کانون Android TV دستگاه‌های Matter را به‌اشتباه «آفلاین» گزارش کند.
  • ممکن است نسخه نرم‌افزار صحیح برای «نسخه نرم‌افزار دستگاه دوربین فعلی» نشان داده نشود.
  • لغزنده میانای کاربری دماپا دماهایی را نشان می‌دهد که خارج از محدوده هستند.
  • وقتی «مدت زنگ» تنظیم شده باشد، دستگاه برای مدت مشخص‌شده زنگ نمی‌زند.

2026-02-13

برنامه نمونه Android برای Home APIs برای نسخه ۱.۷ از Home APIs به‌روز شده است.

برنامه نمونه

2026-02-09

  Home APIs Public Beta release 1.7  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: ‏ 26.02.34
  • سفت‌افزار Google Hub،‏ Cast،‏ Nest WiFi Pro: ‏ 3.76.508025
  • سفت‌افزار هاب Google،‏ Cast، همه هاب‌های دیگر مبتنی بر Cast: ‏ 3.77.510748
  • سفت‌افزار Google hub،‏ Fuchsia: ‏ 29.20251023.103.2100
  • سفت‌افزار Google hub،‏ Google TV Streamer،‏ 4K: ‏UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_7
  • برنامه Google Home: نسخه ۱٫۷
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.1.0
  • نسخه Matter: پشتیبانی آزمایشی از نسخه ۱.۵.۰

ویژگی‌های جدید

تغییرات مهم دیگر

مشکلات شناخته‌شده برطرف شد

  • ‫History API همیشه nextPageToken برمی‌گرداند که باعث ایجاد حلقه بی‌نهایت می‌شود.
  • هنگام تلاش برای ورود به سیستم حساب جدید، خطای «کاربر جریان اجازه را لغو کرد» رخ می‌دهد.

مشکلات شناخته‌شده

  • برای Nest Cam Indoor/Outdoor (باتری‌دار یا سیمی) و Nest Doorbell (باتری‌دار، نسل دوم)، گزینه «زمان باقی‌مانده باتری» در «تنظیمات باتری» وجود ندارد.
  • تنظیم مدت‌زمان زنگ نادیده گرفته می‌شود.
  • چراغ Philips BLE به‌اشتباه به‌عنوان «آنلاین» نشان داده می‌شود، حتی زمانی که دستگاه واقعاً آفلاین است. راه‌حل: فقط به وضعیت آنلاین «نوع دستگاه خانه هوشمند» (SHDT) تکیه نکنید. درعوض، از نقشه «سرویس وضعیت دستگاه هدف» (TDSS) برای دستگاه‌های دارای منبع LOCAL_SYNC استفاده کنید.

2025-12-22

  Home APIs Public Beta release 1.6  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: ‏ ۲۵.۴۷.۳۰
  • سفت‌افزار Google hub،‏ Cast،‏ Nest WiFi Pro: نسخه 3.75.479819
  • سفت‌افزار هاب Google،‏ Cast، همه هاب‌های دیگر مبتنی بر Cast: نسخه ۳.۷۷.۵۰۵۷۲۱
  • سفت‌افزار Google hub،‏ Fuchsia: ‏ 28.20250723.103.2100300
  • سفت‌افزار Google hub،‏ Google TV Streamer،‏ 4K: ‏UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_6
  • برنامه Google Home: نسخه ۱.۶
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.1.0

ویژگی‌های جدید

تغییرات مهم دیگر

  • برنامه نمونه Android تنظیمات دوربین، خودکارسازی‌های ازپیش‌تعریف‌شده، و پشتیبانی از پنکه و بلندگو را اضافه می‌کند.

مشکلات شناخته‌شده

  • کنترل‌های دستگاه پس‌از دوره‌های طولانی استفاده از کار می‌افتند. راه‌حل: هاب را بازراه‌اندازی کنید.
  • ممکن است راه‌اندازی دستگاه Matter ناموفق باشد.
  • هنگام تلاش برای افزودن حساب جدید در «برنامه نمونه» برای Android، خطای «User cancelled Permission flow» (کاربر جریان «اجازه» را لغو کرد) ظاهر می‌شود. راه‌حل: حساب‌های Google را ازطریق تنظیمات دستگاه Android اضافه کنید.
  • یک دوربین امنیتی سیمی Walmart onn که بااستفاده از کیت توسعه نرم‌افزار میاناهای برنامه‌سازی کاربردی Android Home راه‌اندازی شده است نمی‌تواند ازطریق برنامه Google Home جاری‌سازی زنده انجام دهد.
  • دوربین‌هایی که در برنامه‌های Home API راه‌اندازی شده‌اند نمی‌توانند جلسه‌های جاری‌سازی زنده را از برنامه Google Home شروع کنند.

2025-10-23

  Home APIs Public Beta release 1.5.1  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: ‏ ۲۵.۴۱.۳۰
  • سفت‌افزار Google hub،‏ Cast: ‏۳.۷۶.۴۹۵۹۹۸
  • سفت‌افزار Google Hub،‏ Fuchsia: ‏27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5_1
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.1.0

ویژگی‌های جدید

تغییرات مهم دیگر

  • «برنامه نمونه Android» پشتیبانی از «نوع دستگاه زنگ در» (روشن/خاموش، جاری‌سازی زنده، مکالمه دوطرفه) و پیاده‌سازی «میانای برنامه‌سازی کاربردی فعال‌سازی Hub» را اضافه می‌کند.

مشکلات شناخته‌شده برطرف شد

  • «برنامه نمونه» وضعیت دستگاه را به‌درستی در نمای «دستگاه» نشان نمی‌دهد.

2025-09-26

  Home APIs Public Beta release 1.5.0  

این نسخه پشتیبانی از دستگاه‌های «دوربین» را معرفی می‌کند، حاوی رفع اشکال است، و کیفیت نسخه بتا را برای Home APIs Android SDK بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: ‏ 25.37.31
  • سفت‌افزار Google hub،‏ Cast: ‏۳.۷۶.۴۹۲۷۳۸
  • سفت‌افزار Google Hub،‏ Fuchsia: ‏27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.1.0

ویژگی‌های جدید

تغییرات مهم دیگر

  • برنامه نمونه Android پشتیبانی از دوربین، راه‌اندازی چندسرپرستی، و خودکارسازی OnOff ازپیش‌تعریف‌شده را اضافه می‌کند.

مشکلات شناخته‌شده برطرف شد

  • وقتی هاب فعال کنونی به‌اجبار برداشته می‌شود، پنج دقیقه فرصت وجود دارد که درطول آن نمی‌توان برخی‌از دستگاه‌ها را کنترل کرد. پس‌از پنج دقیقه، توانایی کنترل دستگاه‌ها بازیابی می‌شود.
  • پس‌از اینکه کاربر رنگی را از پیش‌تنظیم یا از انتخاب‌گر دمای رنگ انتخاب می‌کند، «چراغ رنگی گسترده» نمی‌تواند رنگ را به‌روز کند.

مشکلات شناخته‌شده

  • هنگام جابه‌جایی از Wi-Fi به شبکه تلفن همراه، ممکن است تأخیر کنترل دستگاه افزایش یابد.
  • کنترل انواع دستگاه‌های «پنکه» که با «ابر به ابر» پشتیبانی می‌شوند ممکن است در «برنامه نمونه» کار نکند.

2025-08-29

  Home APIs Public Beta release 1.4.1  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: ‏ ۲۵.۳۳.۳۲
  • سفت‌افزار Google hub،‏ Cast: ‏۳.۷۶.۴۹۵۹۹۸
  • سفت‌افزار Google Hub،‏ Fuchsia: ‏27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_1
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.0.0

ویژگی‌های جدید

مشکلات شناخته‌شده برطرف شد

  • وقتی کاربر تلاش می‌کند دماپایی را روی حالتی تنظیم کند که از آن پشتیبانی نمی‌کند، «برنامه نمونه Android» ازکار می‌افتد.

مشکلات شناخته‌شده

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

2025-07-31

  Home APIs Public Beta release 1.4.0  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android ای‌پی‌آی‌های Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: ‏ ۲۵.۲۸.۳۴
  • سفت‌افزار Google hub،‏ Cast: ‏۳.۷۶.۴۸۶۹۳۱
  • سفت‌افزار Google Hub،‏ Fuchsia: ‏27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_0
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.0.0

ویژگی‌های جدید

تغییرات مهم دیگر

  • «برنامه نمونه Android» دستگاه‌های فقط Matter را حذف می‌کند، نام دستگاه‌ها را تغییر می‌دهد، و تماس‌های API منسوخ‌شده را جایگزین می‌کند.

مشکلات شناخته‌شده برطرف شد

  • جاروبرقی‌هایی که در جایگاه قرار گرفته‌اند وضعیت «در جایگاه» را ثبت نمی‌کنند.

مشکلات شناخته‌شده

  • پس‌از خروج از سیستم تلفن و ورود مجدد به سیستم، برنامه Home APIs نمی‌تواند دستگاه‌ها را کنترل کند. راه‌حل: برنامه را ببندید و حداقل ۱۰ ثانیه صبر کنید.

2025-06-26

  Home APIs Public Beta release 1.3.2  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: نسخه ۲۵.۲۳.۳۱
  • سفت‌افزار Google hub،‏ Cast،‏ Google Home،‏ Google Home Mini، و Google Nest Mini: ‏ 3.75.468362
  • سفت‌افزار Google hub،‏ Cast،‏ Google Nest Audio: ‏۳.۷۵.۴۷۶۴۵۱
  • سفت‌افزار Google Hub،‏ Fuchsia: ‏ 26.20250116.103.2900
  • Android SDK: home.android.sdk_1_3_2
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.0.0

ویژگی‌های جدید

  • ساخته کیت توسعه نرم‌افزار به دو ساخته جداگانه تقسیم شده است: چارچوب کیت توسعه نرم‌افزار Home APIs (play-services-home-17.0.0.aar) و ویژگی‌های کیت توسعه نرم‌افزار و انواع دستگاه (play-services-home-types-17.0.0.aar). از این نسخه به بعد، توسعه‌دهندگان باید هر دو ساخته را در مسیرهای کتابخانه زمان ترجمه و زمان اجرای پروژه خود بگنجانند.

تغییرات مهم دیگر

  • «برنامه نمونه Android» اضافه می‌کند: کاربران می‌توانند اتصال را قطع کنند و اجازه‌ها را از برنامه لغو کنند.
  • برنامه نمونه Android اضافه می‌کند: مصنوعات کیت توسعه نرم‌افزار به‌روزرسانی‌شده برای گنجاندن play-services-home-17.0.0 و play-services-home-types-17.0.0.

مشکلات شناخته‌شده

  • جاروبرقی‌هایی که در جایگاه قرار گرفته‌اند وضعیت «در جایگاه» را ثبت نمی‌کنند.

2025-06-05

  Home APIs Public Beta release 1.3.1  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • «خدمات Google Play»:‏ ۲۵.۱۹.۳۲
  • سفت‌افزار Google hub،‏ Cast: ‏3.75.468222
  • سفت‌افزار Google Hub،‏ Fuchsia: ‏ 26.20250116.103.2201
  • Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.0.0

ویژگی‌های جدید

تغییرات مهم دیگر

  • «برنامه نمونه Android» عملکردهایی را برای ثبت وضعیت ساختارها، دستگاه‌ها، انواع، ویژگی‌ها، و خودکارسازی‌ها اضافه می‌کند تا اشکال‌زدایی آسان‌تر شود.

مشکلات شناخته‌شده برطرف شد

مشکلات شناخته‌شده

  • در «برنامه نمونه Android»، دکمه «ایجاد خودکارسازی» گاهی اوقات برای فعال شدن به چند ضربه نیاز دارد.

2025-05-12

  Home APIs Public Beta release 1.3  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: ‏ ۲۵.۱۶.۳۳
  • سفت‌افزار Google hub،‏ Cast: ‏3.75.468222
  • سفت‌افزار Google Hub،‏ Fuchsia: ‏ 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: ‏ 1.4.0.0

ویژگی‌های جدید

مشکلات شناخته‌شده برطرف شد

  • هنگام جابه‌جایی از Wi-Fi به شبکه تلفن همراه، ممکن است تأخیر کنترل دستگاه افزایش یابد.
  • پس‌از بازنشانی کارخانه‌ای هاب، ممکن است دستگاه‌ها آفلاین به‌نظر برسند.

مشکلات شناخته‌شده

2025-04-09

  Home APIs Public Beta release 1.2.1  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • خدمات Google Play: ‏ ۲۵.۰۹.۳۳
  • حداقل نسخه‌های سفت‌افزار Google Hub:
    • Cast: 3.75.468222
    • ‫Fuchsia: ‏ 24.20241009.103.1900601۱
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • androidx.core کتابخانه: 1.10.0
  • نسخه Matter: 1.4.0.0
۱. این ساخت درحال‌حاضر درحال عرضه شدن برای تولید است و تا ۲۲ آوریل ۲۰۲۵ برای همه دستگاه‌ها دردسترس خواهد بود.

ویژگی‌های جدید

  • بهبود عملکرد هنگام بار کردن اشیا از Home Graph.
  • Automation API
    • پشتیبانی از فیلترهای نهاد اضافه شد که به خودکارسازی‌ها امکان می‌دهد دستگاه‌ها را به‌طور پویا براساس معیارهای مشخص‌شده در خودکارسازی انتخاب کنند.
  • Device API
    • اطلاعات دستگاه ابربه‌ابر اکنون در BasicInformationTrait دردسترس است.

مشکلات شناخته‌شده

  • هنگام جابه‌جایی از Wi-Fi به شبکه تلفن همراه، ممکن است تأخیر کنترل دستگاه افزایش یابد.
  • پس‌از بازنشانی کارخانه‌ای هاب، ممکن است دستگاه‌ها آفلاین به‌نظر برسند.

مشکلات شناخته‌شده برطرف شد

  • اگر Discovery API قبل‌از مقداردهی اولیه یا قبل‌از تکمیل مقداردهی اولیه فراخوانده شود، HomeException با code 14: UNKNOWN و پیام «مسیری پیدا نشد» ایجاد می‌شود.
  • در محیطی که شامل چندین ساختار و چندین کاربر است، جابه‌جایی بین ساختارها و کاربران ممکن است منجر به برگردانده نشدن هیچ دستگاهی شود.

2025-03-14

  Home APIs Public Beta release 1.2.0  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • حداقل نسخه خدمات Google Play: ‏۲۵.۰۶.۳۲
  • حداقل نسخه‌های سفت‌افزار Google Hub:
    • نسخه Cast: ‏ 3.75.456944
    • Fuchsia min version: 24.20241009.103.1900601
  • Android SDK: home.android.sdk_1_2_0_RC06
  • حداقل نسخه برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • androidx.core حداقل نسخه کتابخانه: ۱.۱۰.۰
  • نسخه Matter: 1.3.0.0
    • توجه: انواع دستگاه و خوشه‌های Matter موقت پشتیبانی نمی‌شوند.

ویژگی‌های جدید

  • Automation API:
    • پشتیبانی از گستره‌های تاریخ و تاریخ‌های جزئی در شرایط خودکارسازی. استفاده از تاریخ‌ها با بین را ببینید.
    • در نسخه‌های قبلی، Discovery API برای برخی‌از فیلدهای نقشه بیتی NumberSetConstraint برمی‌گرداند درحالی‌که باید BitmapConstraint برمی‌گرداند. این فیلدها اکنون همان‌طور که انتظار می‌رود BitmapConstraint را برمی‌گردانند. این محدود به نقشه‌های بیتی optionsMask و optionsOverride در فرمان‌های ویژگی LevelControl است.

مشکلات شناخته‌شده

  • هنگام جابه‌جایی از Wi-Fi به شبکه تلفن همراه، ممکن است تأخیر کنترل دستگاه افزایش یابد.
  • پس‌از بازنشانی کارخانه‌ای هاب، ممکن است دستگاه‌ها آفلاین به‌نظر برسند.
  • اگر Discovery API قبل‌از مقداردهی اولیه یا قبل‌از تکمیل مقداردهی اولیه فراخوانده شود، HomeException با code 14: UNKNOWN و پیام «مسیری پیدا نشد» ایجاد می‌شود.
    • راهکار: فقط زمانی Discovery API را فراخوانی کنید که واقعاً به نامزدهای خودکارسازی نیاز دارید. نهادهای نامزد را پیش‌واکشی و ذخیره نکنید. قبل‌از فراخوانی روش‌های Discovery API روی یک موجودیت، بررسی کنید که آیا آن موجودیت آنلاین است یا نه.
  • در محیطی که شامل چندین ساختار و چندین کاربر است، جابه‌جایی بین ساختارها و کاربران ممکن است منجر به برگردانده نشدن هیچ دستگاهی شود.

مشکلات شناخته‌شده برطرف شد

  • اولین باری که برنامه Home APIs پس‌از راه‌اندازی HomeManager.structures() را فراخوانی می‌کند، هیچ ساختمانی دریافت نمی‌کند، حتی اگر یک یا چند ساختمان وجود داشته باشد. این امر این تصور نادرست را ایجاد می‌کند که هیچ ساختاری با «حساب Google» مرتبط نیست.
  • هنگام بار کردن، ایجاد، و ویرایش خودکارسازی‌ها، ممکن است کاربران زمان انتظار طولانی‌ای را تجربه کنند.
  • کاربرانی که جریان راه‌اندازی را از برنامه «دوربین» شروع می‌کنند، باید رمزینه پاسخ‌سریع را دو بار اسکن کنند تا راه‌اندازی Matter تکمیل شود.
  • در ساختاری که حاوی بیش‌از ۲۰۰ دستگاه است، Discovery API ممکن است هیچ نامزدی را برنگرداند.

2025-01-29

  Home APIs Public Beta release 1.1.0  

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتا را برای کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی Home بهبود می‌بخشد.

پایین‌ترین نسخه‌ها

  • حداقل نسخه «خدمات Google Play»:‏ ۲۵.۰۲.۳۲
  • حداقل نسخه‌های سفت‌افزار Google Hub:
    • نسخه Cast: ‏ 3.75.456944
    • Fuchsia min version: 24.20241009.103.1900500
  • Android SDK: home.android.sdk_202412_EAP_1_1_RC04
  • حداقل نسخه برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • androidx.core حداقل نسخه کتابخانه: ۱.۱۰.۰
  • نسخه Matter: 1.3.0.0
    • توجه: انواع دستگاه و خوشه‌های Matter موقت پشتیبانی نمی‌شوند.

ویژگی‌های جدید

  • میانای برنامه‌سازی کاربردی جاری‌سازی:
    • جاری‌سازی‌های رویدادی ارائه می‌دهد که درباره ساختمان‌ها، اتاق‌ها، و دستگاه‌هایی که اضافه، تغییر، و برداشته شده‌اند اطلاع‌رسانی می‌کند.
    • مشترک شدن در رویدادهای رابطه نهاد را ببینید.
  • Batching API (آزمایشی):

مشکلات شناخته‌شده

  • هنگام بار کردن، ایجاد، و ویرایش خودکارسازی‌ها، ممکن است کاربران زمان انتظار طولانی‌ای را تجربه کنند.
  • کاربرانی که جریان راه‌اندازی را از برنامه «دوربین» شروع می‌کنند، باید رمزینه پاسخ‌سریع را دو بار اسکن کنند تا راه‌اندازی Matter تکمیل شود.
  • در ساختاری که حاوی بیش‌از ۲۰۰ دستگاه است، Discovery API ممکن است هیچ نامزدی را برنگرداند.

مشکلات شناخته‌شده برطرف شد

  • ممکن است عوض کردن «حساب Google» واردشده به سیستم ناموفق باشد و منجر به خطا شود.
  • دستگاه‌های Google TV ممکن است برای خودکارسازی‌هایی که از ویژگی MediaPlayback استفاده می‌کنند کار نکنند.
  • در ساختمانی که فقط حاوی یک Google Hub است:
    • ممکن است دستگاه‌های Matter در برنامه Google Home آفلاین به‌نظر برسند.
    • «دستیار Google» نمی‌تواند دستگاه‌های Matter را کنترل کند.
    • نمایشگرهای هوشمند نمی‌توانند دستگاه‌های Matter را کنترل کنند یا وضعیت هیچ‌کدام از دستگاه‌های Matter را نمایش دهند.
  • برای برخی‌از دستگاه‌ها، ممکن است برنامه همیشه وضعیت دقیق را نشان ندهد و برنامه شما ممکن است وضعیتی را گزارش کند که با وضعیت گزارش‌شده توسط برنامه Google مانند برنامه Google Home متفاوت باشد. این معمولاً به‌دلیل عدم گزارش وضعیت دستگاه‌ها به Google است.
    • راه‌حل: بررسی وضعیت با برنامه Google عدم تطابق را برطرف می‌کند.

2025-01-14

راهنمای به‌روزشده برای مقداردهی اولیه Home APIs.

واضح‌تر کرده‌ایم که نمونه‌ای از Home باید به‌عنوان سینگلتون بافت مقداردهی اولیه شود. این کار تجربه کاربری روان‌تری را در برنامه‌تان تضمین می‌کند و از بروز خطا در جلسه‌های نامعتبر جلوگیری می‌کند.

2025-01-07

  انتشار نسخه بتای عمومی Home APIs  

درطول نسخه بتای عمومی توسعه‌دهنده، همه توسعه‌دهندگان می‌توانند ساختن و آزمایش کردن برنامه‌هایشان را شروع کنند.

این نسخه حاوی رفع اشکال است و کیفیت نسخه بتای کیت توسعه نرم‌افزار Android برای ای‌پی‌آی‌های Home را بهبود می‌بخشد، ازجمله پشتیبانی بهبودیافته برای دستگاه‌های Google Nest Audio و Google TV.

پایین‌ترین نسخه‌ها

  • حداقل نسخه خدمات Google Play: ‏۲۴.۴۵.۳۴
  • حداقل نسخه‌های سفت‌افزار Google Hub:
    • نسخه Cast: ‏ 3.74.444798
    • Fuchsia min version: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • حداقل نسخه برنامه Google Home‏ (GHA): با هر نسخه‌ای کار می‌کند
  • androidx.core حداقل نسخه کتابخانه: ۱.۱۰.۰
  • نسخه Matter: 1.3.0.0
    • توجه: انواع دستگاه و خوشه‌های موقت Matter پشتیبانی نمی‌شوند.

مشکلات شناخته‌شده

  • ممکن است عوض کردن «حساب Google» واردشده به سیستم ناموفق باشد و منجر به خطا شود.
    • راه‌حل: جریان اجازه‌ها را دوباره اجرا کنید یا برنامه را بازراه‌اندازی کنید.
  • دستگاه‌های Google TV ممکن است برای خودکارسازی‌هایی که از ویژگی MediaPlayback استفاده می‌کنند کار نکنند.
  • در ساختمانی که فقط حاوی یک هاب Google است:
    • ممکن است دستگاه‌های Matter در برنامه Google Home (GHA) آفلاین به‌نظر برسند.
    • «دستیار Google» نمی‌تواند دستگاه‌های Matter را کنترل کند.
    • نمایشگرهای هوشمند نمی‌توانند دستگاه‌های Matter را کنترل کنند یا وضعیت هیچ دستگاه Matter را نمایش دهند.
  • برای برخی‌از دستگاه‌ها، ممکن است برنامه همیشه وضعیت دقیق را منعکس نکند و برنامه شما ممکن است وضعیتی را گزارش کند که با وضعیت گزارش‌شده توسط برنامه Google مانند برنامه Google Home (GHA) متفاوت باشد. این مشکل معمولاً به‌دلیل این است که دستگاه‌ها وضعیت را به Google گزارش نمی‌کنند.
    • راه‌حل: بررسی وضعیت با برنامه Google عدم تطابق را برطرف می‌کند.

مشکلات شناخته‌شده برطرف شد

  • اگر برنامه درطول فرایند راه‌اندازی کوچک شود، ممکن است راه‌اندازی ناموفق باشد.
    • راه‌حل: از suppressHalfSheetNotification() API برای سرکوب کردن اعلان‌های نیم‌برگ هنگام استفاده از Commissioning API در برنامه‌تان استفاده کنید.
  • ممکن است مشکلی در سمت سرور مانع از عملکرد چکانه‌های OkGoogle در خودکارسازی‌ها شود.
  • هنگام استفاده از کانونی که Fuchsia را اجرا می‌کند و هیچ دستگاه Matter در ساختار آن وجود ندارد، اگر کانون بیش‌از ۳ ساعت غیرفعال بماند، راه‌اندازی اولین دستگاه Matter باعث می‌شود دستگاه Matter آفلاین شود.
  • پس‌از بازنشانی داده‌های کارخانه برای هاب، ممکن است فرمان‌های ارسال‌شده به دستگاه‌های تازه راه‌اندازی‌شده باوجود آنلاین گزارش شدن دستگاه ناموفق باشد.