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

2026-09-23

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

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

حداقل نسخه‌ها

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

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

تغییرات قابل‌توجه دیگر

2026-09-16

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

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

2026-09-16

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

برنامه نمونه

2026-08-28

  انتشار عمومی Home APIs نسخه ۱.۱۰.۱  

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

حداقل نسخه‌ها

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

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

تغییرات قابل‌توجه دیگر

2026-08-07

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

برنامه نمونه

2026-08-03

  انتشار عمومی Home APIs نسخه ۱.۱۰  

این نسخهٔ پخش حاوی رفع اشکال است و «کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی خانه» را به کیفیت «دسترسی عمومی» ارتقا می‌دهد.

حداقل نسخه‌ها

2026-07-09

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

تغییرات آتی

2026-07-08

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

محتوای جدید

2026-07-07

«برنامه نمونه Android میاناهای برنامه‌سازی کاربردی Home» برای نسخه پخش «میاناهای برنامه‌سازی کاربردی Home 1.9.1» به‌روزرسانی شده است.

برنامه نمونه

2026-06-26

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

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

حداقل نسخه‌ها

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

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

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

2026-06-09

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

برنامه نمونه

2026-05-29

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

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

حداقل نسخه‌ها

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

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

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

2026-05-26

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

برنامه نمونه

2026-05-01

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

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

حداقل نسخه‌ها

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

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

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

  • راه‌اندازی دستگاه 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 1.8 به‌روز شده است.

برنامه نمونه

2026-04-09

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

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

حداقل نسخه‌ها

  • خدمات Google Play: 26.12.32
  • سفت‌افزار Google hub،‏ Cast،‏ Nest WiFi Pro: 3.78.518349
  • سفت‌افزار مرکز کنترل Google،‏ Cast، همه مراکز کنترل مبتنی بر Cast: 3.78.526062
  • سفت‌افزار مرکز Google،‏ Fuchsia: 29.20251023.103.2101601
  • میان‌افزار هاب Google،‏ 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

  انتشار نسخه بتای عمومی «میاناهای برنامه‌سازی کاربردی خانه» نسخه ۱.۷.۱  

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

حداقل نسخه‌ها

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

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

تغییرات قابل‌توجه دیگر

  • حالت بدون مرکز برداشته شده است.

برنامه نمونه

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

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

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

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

2026-02-13

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

برنامه نمونه

2026-02-09

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

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

حداقل نسخه‌ها

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

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

تغییرات قابل‌توجه دیگر

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

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

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

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

2025-12-22

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

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

حداقل نسخه‌ها

  • خدمات Google Play: 25.47.30
  • سفت‌افزار Google hub،‏ Cast،‏ Nest WiFi Pro: 3.75.479819
  • سفت‌افزار مرکز کنترل Google،‏ Cast، همه مراکز کنترل مبتنی بر Cast: 3.77.505721
  • سفت‌افزار Google hub،‏ Fuchsia: 28.20250723.103.2100300
  • میان‌افزار هاب Google،‏ Google TV Streamer،‏ 4K: UTTK.250729.004
  • کیت توسعه نرم‌افزار Android: home.android.sdk_GHP_1_6
  • برنامه Google Home: 1.6
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: 1.4.1.0

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

تغییرات قابل‌توجه دیگر

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

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

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

2025-10-23

  انتشار عمومی نسخه بتای Home APIs‏ ۱.۵.۱  

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

حداقل نسخه‌ها

  • خدمات Google Play: 25.41.30
  • سفت‌افزار هاب Google،‏ Cast: 3.76.495998
  • سفت‌افزار مرکز Google،‏ Fuchsia: 27.20250422.103.3600
  • کیت توسعه نرم‌افزار Android: home.android.sdk_1_5_1
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: 1.4.1.0

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

تغییرات قابل‌توجه دیگر

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

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

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

2025-09-26

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

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

حداقل نسخه‌ها

  • خدمات Google Play: 25.37.31
  • سفت‌افزار هاب Google،‏ Cast: 3.76.492738
  • سفت‌افزار مرکز Google،‏ Fuchsia: 27.20250422.103.3600
  • کیت توسعه نرم‌افزار Android: home.android.sdk_1_5
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: 1.4.1.0

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

تغییرات قابل‌توجه دیگر

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

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

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

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

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

2025-08-29

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

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

حداقل نسخه‌ها

  • خدمات Google Play: 25.33.32
  • سفت‌افزار هاب Google،‏ Cast: 3.76.495998
  • سفت‌افزار مرکز Google،‏ Fuchsia: 27.20250422.103.3600
  • کیت توسعه نرم‌افزار Android: home.android.sdk_1_4_1
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: 1.4.0.0

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

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

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

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

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

2025-07-31

  انتشار نسخه بتای عمومی میاناهای برنامه‌سازی کاربردی خانه 1.4.0  

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

حداقل نسخه‌ها

  • خدمات Google Play: 25.28.34
  • سفت‌افزار هاب Google،‏ Cast: 3.76.486931
  • سفت‌افزار مرکز Google،‏ Fuchsia: 27.20250422.103.3600
  • کیت توسعه نرم‌افزار Android: home.android.sdk_1_4_0
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: 1.4.0.0

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

تغییرات قابل‌توجه دیگر

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

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

  • دستگاه‌های جاروبرقی که به پایه متصل شده‌اند وضعیت «متصل به پایه» را ثبت نمی‌کنند.

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

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

2025-06-26

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

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

حداقل نسخه‌ها

  • خدمات Google Play: 25.23.31
  • میان‌افزار هاب Google،‏ Cast،‏ Google Home،‏ Google Home Mini، و Google Nest Mini: 3.75.468362
  • سفت‌افزار Google hub،‏ Cast،‏ Google Nest Audio: 3.75.476451
  • سفت‌افزار مرکز فرمان Google،‏ Fuchsia: 26.20250116.103.2900
  • کیت توسعه نرم‌افزار Android: home.android.sdk_1_3_2
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: با هر نسخه‌ای کار می‌کند
  • نسخه Matter: 1.4.0.0

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

  • آرتیفیکت کیت توسعه نرم‌افزار به دو آرتیفیکت جداگانه تقسیم شده است: چارچوب کیت توسعه نرم‌افزار «میاناهای برنامه‌سازی کاربردی خانه» (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 نسخه 1.3.1  

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

حداقل نسخه‌ها

  • خدمات Google Play: 25.19.32
  • سفت‌افزار توپی Google،‏ Cast: 3.75.468222
  • سفت‌افزار مرکز فرمان Google،‏ 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‏ 1.3  

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

حداقل نسخه‌ها

  • خدمات Google Play: 25.16.33
  • سفت‌افزار توپی Google،‏ Cast: 3.75.468222
  • سفت‌افزار مرکز فرمان Google،‏ 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

  انتشار عمومی نسخه بتای «میاناهای برنامه‌سازی کاربردی خانه» ۱.۲.۱  

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

حداقل نسخه‌ها

  • خدمات Google Play: 25.09.33
  • حداقل نسخه‌های سفت‌افزار مرکز کنترل Google:
    • پخش محتوا: ۳.۷۵.۴۶۸۲۲۲
    • Fuchsia: 24.20241009.103.19006011
  • کیت توسعه نرم‌افزار Android: home.android.sdk_202503_EAP_1_2_1_RC02
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • ‫androidx.core کتابخانه: 1.10.0
  • نسخه Matter: 1.4.0.0
‫۱. این ساخت درحال‌حاضر درحال عرضه شدن به تولید است و تا ۲۲ آوریل ۲۰۲۵ برای همه دستگاه‌ها دردسترس خواهد بود.

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

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

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

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

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

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

2025-03-14

  انتشار نسخه بتا عمومی Home APIs نسخه ۱.۲.۰  

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

حداقل نسخه‌ها

  • حداقل نسخه «خدمات Google Play»: 25.06.32
  • حداقل نسخه‌های سفت‌افزار هاب Google:
    • نسخه Cast: 3.75.456944
    • حداقل نسخه Fuchsia: 24.20241009.103.1900601
  • کیت توسعه نرم‌افزار Android: home.android.sdk_1_2_0_RC06
  • حداقل نسخه برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • حداقل نسخه کتابخانه androidx.core: 1.10.0
  • نسخه Matter: 1.3.0.0
    • توجه: از انواع و خوشه‌های دستگاه Matter موقت پشتیبانی نمی‌شود.

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

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

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

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

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

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

2025-01-29

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

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

حداقل نسخه‌ها

  • حداقل نسخه «خدمات Google Play»: 25.02.32
  • حداقل نسخه‌های سفت‌افزار هاب Google:
    • نسخه Cast: 3.75.456944
    • حداقل نسخه Fuchsia: 24.20241009.103.1900500
  • ‫Android SDK: home.android.sdk_202412_EAP_1_1_RC04
  • حداقل نسخه برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • حداقل نسخه کتابخانه androidx.core: 1.10.0
  • نسخه Matter: 1.3.0.0
    • توجه: از انواع و خوشه‌های دستگاه Matter موقت پشتیبانی نمی‌شود.

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

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

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

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

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

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

2025-01-14

راهنمایی به‌روزشده برای مقداردهی اولیه «میاناهای برنامه‌سازی کاربردی Home».

روشن‌تر کرده‌ایم که نمونه‌ای از «خانه» باید به‌عنوان تک‌نمونه زمینه‌ای مقداردهی اولیه شود. این کار باعث می‌شود تجربه کاربری روان‌تری در برنامه داشته باشید و از خطاهای مربوط به جلسه‌های نامعتبر جلوگیری می‌کند.

2025-01-07

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

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

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

حداقل نسخه‌ها

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

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

  • عوض کردن «حساب 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 می‌شود.
  • پس‌از انجام بازنشانی کارخانه‌ای برای هاب، ممکن است فرمان‌های دستگاه‌های جدیداً راه‌اندازی‌شده با وجود اینکه دستگاه به‌عنوان آنلاین گزارش شده است، ناموفق باشد.