یادداشت‌های انتشار Android SDK APIهای صفحه اصلی

۲۰۲۶-۰۵-۰۱

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتای عمومی ۱.۸.۱

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

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

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

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

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

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

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

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

۲۰۲۶-۰۴-۱۰

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

نمونه برنامه

۲۰۲۶-۰۴-۰۹

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتا عمومی ۱.۸

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

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

  • سرویس‌های گوگل پلی: ۲۶.۱۲.۳۲
  • فریمور گوگل هاب، کست، نست وای فای پرو: ۳.۷۸.۵۱۸۳۴۹
  • فریمور گوگل هاب، کست، و سایر هاب‌های مبتنی بر کست: ۳.۷۸.۵۲۶۰۶۲
  • فریمور گوگل هاب، فوشیا: 29.20251023.103.2101601
  • فریمور گوگل هاب، استریمر گوگل تی‌وی، 4K: UTTK.250729.004
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_GHP_1_8_0
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۱.۰
  • نسخه Matter: پشتیبانی آزمایشی برای ۱.۵.۰

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

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

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

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

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

۲۰۲۶-۰۳-۱۳

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتای عمومی ۱.۷.۱

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

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

  • سرویس‌های گوگل پلی:
  • فریمور گوگل هاب، کست، نست وای فای پرو: ۳.۷۸.۵۱۸۳۴۹
  • فریمور گوگل هاب، کست، و سایر هاب‌های مبتنی بر کست: ۳.۷۸.۵۱۶۵۲۶
  • فریمور گوگل هاب، فوشیا: 29.20251023.103.2201
  • فریمور گوگل هاب، استریمر گوگل تی‌وی، 4K: UTTK.250729.004
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_GHP_1_7_1
  • برنامه گوگل هوم: ۱.۷.۱
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۱.۰
  • نسخه Matter: پشتیبانی آزمایشی برای ۱.۵.۰

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

سایر تغییرات قابل توجه

  • حالت بدون توپی (Hubless) حذف شده است.

نمونه برنامه

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

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

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

  • نمی‌توان واحدهای دمای (سانتیگراد/فارنهایت) ترموستات آموزشی گوگل نست (نسل چهارم) را تغییر داد.
  • تأخیرهای احتمالی در پایداری شبکه و پاسخگویی دستگاه.
  • در نسخه موبایل گوگل هوم فور وب، آیکون بالا و دکمه بازگشت توسط یک هدر پنهان شده‌اند. کاربران ممکن است نتوانند به عقب برگردند یا عناصر کلیدی رابط کاربری را ببینند.
  • ممکن است هاب پس از حالت فدرال در OOBE در حالت "در حال اتصال..." گیر کند.
  • راه‌اندازی دستگاه Matter ممکن است با شکست مواجه شود.
  • یک هاب تلویزیون اندروید ممکن است به اشتباه دستگاه‌های Matter را آفلاین گزارش کند.
  • ممکن است نسخه نرم‌افزار صحیح برای نسخه فعلی نرم‌افزار دستگاه دوربین نمایش داده نشود.
  • یک اسلایدر رابط کاربری ترموستات، دماهای خارج از محدوده را نشان می‌دهد.
  • وقتی مدت زمان زنگ تنظیم شده باشد، دستگاه برای مدت زمان مشخص شده زنگ نمی‌زند.

۲۰۲۶-۰۲-۱۳

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

نمونه برنامه

۲۰۲۶-۰۲-۰۹

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتا عمومی ۱.۷

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

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

  • سرویس‌های گوگل پلی: ۲۶.۰۲.۳۴
  • فریمور گوگل هاب، کست، نست وای فای پرو: ۳.۷۶.۵۰۸۰۲۵
  • فریمور گوگل هاب، کست، و سایر هاب‌های مبتنی بر کست: ۳.۷۷.۵۱۰۷۴۸
  • فریمور گوگل هاب، فوشیا: 29.20251023.103.2100
  • فریمور گوگل هاب، استریمر گوگل تی‌وی، 4K: UTTK.250729.004
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_GHP_1_7
  • برنامه گوگل هوم: ۱.۷
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۱.۰
  • نسخه Matter: پشتیبانی آزمایشی برای ۱.۵.۰

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

سایر تغییرات قابل توجه

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

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

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

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

۲۰۲۵-۱۲-۲۲

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتا عمومی ۱.۶

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

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

  • سرویس‌های گوگل پلی: ۲۵.۴۷.۳۰
  • فریمور گوگل هاب، کست، نست وای فای پرو: ۳.۷۵.۴۷۹۸۱۹
  • فریمور گوگل هاب، کست، و سایر هاب‌های مبتنی بر کست: ۳.۷۷.۵۰۵۷۲۱
  • فریمور گوگل هاب، فوشیا: 28.20250723.103.2100300
  • فریمور گوگل هاب، استریمر گوگل تی‌وی، 4K: UTTK.250729.004
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_GHP_1_6
  • برنامه گوگل هوم: ۱.۶
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۱.۰

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

سایر تغییرات قابل توجه

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

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

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

۲۰۲۵-۱۰-۲۳

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتای عمومی ۱.۵.۱

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

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

  • سرویس‌های گوگل پلی: ۲۵.۴۱.۳۰
  • فریمور گوگل هاب، کست: ۳.۷۶.۴۹۵۹۹۸
  • فریمور گوگل هاب، فوشیا: 27.20250422.103.3600
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_1_5_1
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۱.۰

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

سایر تغییرات قابل توجه

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

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

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

۲۰۲۵-۰۹-۲۶

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتا عمومی ۱.۵.۰

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

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

  • سرویس‌های گوگل پلی: ۲۵.۳۷.۳۱
  • فریمور گوگل هاب، کست: ۳.۷۶.۴۹۲۷۳۸
  • فریمور گوگل هاب، فوشیا: 27.20250422.103.3600
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_1_5
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۱.۰

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

سایر تغییرات قابل توجه

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

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

  • وقتی هاب فعال فعلی به اجبار حذف می‌شود، یک بازه زمانی پنج دقیقه‌ای وجود دارد که در طی آن کنترل برخی دستگاه‌ها امکان‌پذیر نیست. پس از پنج دقیقه، قابلیت کنترل دستگاه‌ها بازیابی می‌شود.
  • پس از اینکه کاربر رنگی را از میان رنگ‌های از پیش تعیین‌شده یا از انتخابگر دمای رنگ انتخاب می‌کند، چراغ رنگی توسعه‌یافته (Extended Color Light) رنگ را به‌روزرسانی نمی‌کند.

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

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

۲۹-۰۸-۲۰۲۵

نسخه بتای عمومی ۱.۴.۱ برای رابط‌های برنامه‌نویسی کاربردی خانگی

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

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

  • سرویس‌های گوگل پلی: ۲۵.۳۳.۳۲
  • فریمور گوگل هاب، کست: ۳.۷۶.۴۹۵۹۹۸
  • فریمور گوگل هاب، فوشیا: 27.20250422.103.3600
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_1_4_1
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۰.۰

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

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

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

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

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

۲۰۲۵-۰۷-۳۱

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتای عمومی ۱.۴.۰

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

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

  • سرویس‌های گوگل پلی: ۲۵.۲۸.۳۴
  • فریمور گوگل هاب، کست: ۳.۷۶.۴۸۶۹۳۱
  • فریمور گوگل هاب، فوشیا: 27.20250422.103.3600
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_1_4_0
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۰.۰

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

سایر تغییرات قابل توجه

  • برنامه نمونه اندروید، دستگاه‌های Matter-only را حذف می‌کند، نام دستگاه‌ها را تغییر می‌دهد و فراخوانی‌های API منسوخ‌شده را جایگزین می‌کند.

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

  • دستگاه‌های جاروبرقی که به داک متصل شده‌اند، حالت داک را ثبت نمی‌کنند.

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

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

۲۰۲۵-۰۶-۲۶

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتای عمومی ۱.۳.۲

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

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

  • سرویس‌های گوگل پلی: ۲۵.۲۳.۳۱
  • فریمور گوگل هاب، کست، گوگل هوم، گوگل هوم مینی و گوگل نست مینی: ۳.۷۵.۴۶۸۳۶۲
  • فریمور گوگل هاب، کست، گوگل نست آدیو: ۳.۷۵.۴۷۶۴۵۱
  • فریمور گوگل هاب، فوشیا: 26.20250116.103.2900
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_1_3_2
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۰.۰

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

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

سایر تغییرات قابل توجه

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

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

  • دستگاه‌های جاروبرقی که به داک متصل شده‌اند، حالت داک را ثبت نمی‌کنند.

۲۰۲۵-۰۶-۰۵

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتای عمومی ۱.۳.۱

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

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

  • سرویس‌های گوگل پلی: 25.19.32
  • فریمور گوگل هاب، کست: ۳.۷۵.۴۶۸۲۲۲
  • فریمور گوگل هاب، فوشیا: 26.20250116.103.2201
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_202505_EAP_1_3_1_RC06
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۰.۰

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

سایر تغییرات قابل توجه

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

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

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

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

۲۰۲۵-۰۵-۱۲

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتا عمومی ۱.۳

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

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

  • سرویس‌های گوگل پلی: ۲۵.۱۶.۳۳
  • فریمور گوگل هاب، کست: ۳.۷۵.۴۶۸۲۲۲
  • فریمور گوگل هاب، فوشیا: 26.20250116.103.2201
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_202504_EAP_1_3_RC00
  • برنامه Google Home: با هر نسخه‌ای کار می‌کند
  • کتابخانه androidx.core : با هر نسخه‌ای کار می‌کند
  • نسخه ماده: ۱.۴.۰.۰

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

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

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

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

۲۰۲۵-۰۴-۰۹

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتای عمومی ۱.۲.۱

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

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

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

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

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

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

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

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

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

۱۴-۰۳-۲۰۲۵

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتای عمومی ۱.۲.۰

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

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

  • حداقل نسخه سرویس‌های گوگل پلی: ۲۵.۰۶.۳۲
  • حداقل نسخه‌های فریمور گوگل هاب:
    • نسخه بازیگران: 3.75.456944
    • نسخه حداقل فوشیا: 24.20241009.103.1900601
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_1_2_0_RC06
  • نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
  • نسخه حداقلی کتابخانه androidx.core : ۱.۱۰.۰
  • نسخه ماده: ۱.۳.۰.۰
    • توجه: انواع دستگاه‌ها و خوشه‌های Provisional Matter پشتیبانی نمی‌شوند.

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

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

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

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

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

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

۲۹-۰۱-۲۰۲۵

رابط‌های برنامه‌نویسی کاربردی (APIs) صفحه اصلی نسخه بتای عمومی ۱.۱.۰

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

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

  • حداقل نسخه سرویس‌های گوگل پلی: ۲۵.۰۲.۳۲
  • حداقل نسخه‌های فریمور گوگل هاب:
    • نسخه بازیگران: 3.75.456944
    • نسخه حداقل فوشیا: 24.20241009.103.1900500
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_202412_EAP_1_1_RC04
  • نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
  • نسخه حداقلی کتابخانه androidx.core : ۱.۱۰.۰
  • نسخه ماده: ۱.۳.۰.۰
    • توجه: انواع دستگاه‌ها و خوشه‌های Provisional Matter پشتیبانی نمی‌شوند.

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

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

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

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

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

۱۴-۰۱-۲۰۲۵

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

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

۲۰۲۵-۰۱-۰۷

نسخه بتای عمومی APIهای خانگی

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

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

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

  • حداقل نسخه سرویس‌های گوگل پلی: ۲۴.۴۵.۳۴
  • حداقل نسخه‌های فریمور گوگل هاب:
    • نسخه بازیگران: 3.74.444798
    • نسخه حداقلی فوشیا: 22.20240805.103.161
  • کیت توسعه نرم‌افزار اندروید: home.android.sdk_202411_EAP_1_0_1_RC00
  • نسخه حداقلی برنامه گوگل هوم (GHA): با هر نسخه‌ای کار می‌کند
  • نسخه حداقلی کتابخانه androidx.core : ۱.۱۰.۰
  • نسخه ماده: ۱.۳.۰.۰
    • توجه: انواع دستگاه‌ها و خوشه‌های Provisional Matter پشتیبانی نمی‌شوند.

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

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

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

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