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

۲۰۲۶-۰۲-۰۹

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

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

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

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

• API اتوماسیون
  • اتوماسیون‌های محلی: بر اساس شرایطی مانند اتصال، نوع دستگاه و ویژگی‌ها، برخی از اتوماسیون‌ها اکنون می‌توانند به صورت محلی اجرا شوند.
• رابط برنامه‌نویسی دستگاه
  • فعال‌سازی قابلیت «تجربه خارج از جعبه دوربین» (OOBE) در برنامه‌ها.
  • ویژگی‌های جدید دوربین و زنگ درب

    برای جزئیات بیشتر به راهنمای دستگاه دوربین برای اندروید و راهنمای دستگاه زنگ در برای اندروید مراجعه کنید.

  • تنظیمات
    • تم‌های چیم .
    • صرفه‌جویی خودکار در مصرف باتری .
    • تنظیمات برگزیده مصرف باتری
  • وضعیت دستگاه
    • وضعیت شارژ باتری .
    • سطوح باتری .
  • اطلاعات دستگاه
    • شماره سریال .
    • مدل .
    • نسخه نرم‌افزار .

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

• HomeException.unsupported با HomeException.unimplemented جایگزین شده است تا با کدهای خطای استاندارد همسو شود.
• مولد کد بسته‌بندی‌شده برای ویژگی‌های سفارشی برای نسخه ۱.۷ تغییر کرده است. توسعه‌دهندگانی که ویژگی‌های سفارشی دارند، پس از ادغام SDK نسخه ۱.۷، باید ویژگی‌های خود را دوباره کامپایل کنند.

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

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

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

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

۲۰۲۵-۱۲-۲۲

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

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

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

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

• API اتوماسیون
  • پشتیبانی از ویژگی‌های آب و هوا

    پشتیبانی از ویژگی آب و هوا در شروع‌کننده‌ها و شرایط اتوماسیون اضافه شد. به Starter based on weather مراجعه کنید.

• رابط برنامه‌نویسی دستگاه
  • پشتیبانی از قابلیت‌های بیشتر دوربین و زنگ درب:
    • تنظیمات جدید:
      • دید در شب روشن/خاموش.
      • روشنایی LED وضعیت.
      • دریچه دید دوربین.
      • جهت گیری تصویر.
      • حساسیت به بیدار شدن از خواب.
      • حداکثر طول رویداد
      • صدای زنگوله می‌آید.

      برای اطلاعات بیشتر به راهنمای دستگاه دوربین برای اندروید مراجعه کنید.

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

  • حالت بدون توپی

    کاربران اکنون می‌توانند بدون نیاز به هاب مستقل، دستگاه‌های Matter را به صورت آن‌بورد نصب و کنترل کنند.

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

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

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

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

۲۰۲۵-۱۰-۲۳

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

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

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

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

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

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

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

۲۰۲۵-۰۹-۲۶

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

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

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

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

• API اتوماسیون
  • شروع‌کننده‌ها، شرط‌ها و اکشن‌ها اکنون ساختارهای Matter را به عنوان پارامتر می‌پذیرند.
• رابط برنامه‌نویسی دستگاه
  • نوع دستگاه دوربین اضافه شد. ویژگی‌های دوربین زیر نیز برای نوع دستگاه زنگ در در دسترس هستند:
  • پخش زنده دوربین.
  • دوربین مکالمه دو طرفه.
  • شروع و توقف ضبط دوربین.
• نمونه برنامه اندروید
  • پشتیبانی از نوع دستگاه دوربین:
    • پخش زنده دوربین.
    • دوربین مکالمه دو طرفه.
    • شروع و توقف ضبط دوربین.
    • مجوزهای نوع دستگاه محدود شده.
  • راه‌اندازی چند مدیر (به اشتراک‌گذاری دستگاه راه‌اندازی‌شده).
  • اتوماسیون OnOff از پیش تعریف شده

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

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

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

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

۲۰۲۵-۰۹-۰۸

نسخه ۱.۴.۱ اپلیکیشن نمونه برای اندروید منتشر شد.

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

• ایجاد، تغییر نام، به‌روزرسانی و حذف یک اتاق.
• سفارش به یک شرکت ثالث از شرکت Matter.

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

• لینک صفحه لغو مجوزها اکنون کار می‌کند.

۲۹-۰۸-۲۰۲۵

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

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

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

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

• رابط برنامه‌نویسی دستگاه
  • یک DecommissionIneligibleReason جدید برای تلاش برای از رده خارج کردن یک دستگاه چند منبعی تعریف شده است. به Multi-source devices مراجعه کنید.

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

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

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

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

۲۰۲۵-۰۷-۳۱

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

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

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

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

• API اتوماسیون
  • می‌توان اتوماسیون‌ها را به تعداد دفعات محدودی اجرا کرد. به بخش «محدود کردن تعداد اجراها» مراجعه کنید.

• رابط برنامه‌نویسی دستگاه
  • امکان حذف برنامه‌ای یک دستگاه Matter. به بخش حذف یک دستگاه مراجعه کنید.
  • اعضای منسوخ‌شده‌ی HomeDevice زیر حذف شده‌اند:
    1. HomeDevice.trait() . برای دسترسی به دستگاه‌ها و ابرداده‌های دستگاه برای اندروید به این بخش مراجعه کنید.
    2. HomeDevice.isInRoom . به جای آن HomeDevice.roomId استفاده کنید.
    3. HomeDevice.isInStructure . به جای آن HomeDevice.structureId استفاده کنید.
• ساختار API
  • Home.hasPermissions() اکنون هم وضعیت مجوز OAuth برای کاربر (دسترسی به ساختار) و هم مجوزهای اعطایی برنامه را در بر می‌گیرد.
• نمونه برنامه اندروید
  • فراخوانی‌های API منسوخ‌شده جایگزین شدند.
  • تغییر نام یک دستگاه.
  • دستگاه‌های فقط-متد-را حذف کنید.

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

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

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

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

۲۰۲۵-۰۷-۰۸

با نسخه ۳.۷۶.۴۷۹۸۱۹ از فریمور کست، نست وای‌فای پرو اکنون می‌تواند به عنوان یک هاب رابط برنامه‌نویسی کاربردی خانگی (Home 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 .

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

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

۲۰۲۵-۰۶-۰۵

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

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

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

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

صفات

• ویژگی SyntheticSwitch را معرفی می‌کند که مدیریت رویدادهای تولید شده توسط دستگاه‌های Matter Switch را ساده می‌کند و به سوئیچ‌ها اجازه می‌دهد تا شروع‌کننده‌های اتوماسیون را فعال کنند.
• ویژگی ExtendedDoorLock یک تغییر اساسی دارد: نوع داده فیلد user_id از String به Long تغییر یافته است.
  • ExtendedDoorLockTrait.LockStateChange.user_id
  • ExtendedDoorLockTrait.PrivacyModeActor.user_id

  برنامه‌هایی که از این ویژگی استفاده می‌کنند باید دوباره کامپایل شوند.

نمونه برنامه اندروید

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

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

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

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

• اگر مکان خانه در برنامه Google Home (GHA) تنظیم نشده باشد، برنامه Google Home هنگام ایجاد اتوماسیون با خطای FailedPreconditionException از کار می‌افتد (برای نحوه تنظیم مکان خانه به تغییر آدرس خانه Google مراجعه کنید).
• در برنامه نمونه اندروید، دستگاهی با connectivityState PARTIALLY_ONLINE قبلاً به کاربر به صورت آفلاین نمایش داده می‌شد. این حالت اکنون به صورت آنلاین نمایش داده می‌شود.

۲۰۲۵-۰۵-۱۲

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

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

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

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

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

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

اگر مکان خانه در برنامه Google Home (GHA) تنظیم نشده باشد، برنامه Google Home هنگام ایجاد اتوماسیون با خطای FailedPreconditionException از کار می‌افتد (برای نحوه انجام این کار به بخش تغییر آدرس خانه Google مراجعه کنید).

• راه حل: قبل از تلاش برای ایجاد اتوماسیون، با استفاده از Discovery API بررسی کنید که آدرس خانه موجود باشد.

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

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

۲۰۲۵-۰۴-۰۹

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

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

• سرویس‌های گوگل پلی: ۲۵.۰۹.۳۳
• حداقل نسخه‌های فریمور گوگل هاب:
  • بازیگران: ۳.۷۵.۴۶۸۲۲۲
  • فوشیا: 24.20241009.103.1900601 ¹
• کیت توسعه نرم‌افزار اندروید: 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 و پیام "مسیری پیدا نشد." صادر می‌شود.
• در محیطی که شامل چندین ساختار و چندین کاربر است، جابجایی بین ساختارها و کاربران ممکن است منجر به عدم بازگشت دستگاه‌ها شود.

۱۴-۰۳-۲۰۲۵

این نسخه شامل رفع اشکالات و افزایش کیفیت نسخه بتا برای 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 هیچ کاندیدی را برنگرداند.

۲۹-۰۱-۲۰۲۵

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

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

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

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

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

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

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

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

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

۱۴-۰۱-۲۰۲۵

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

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

۲۰۲۵-۰۱-۰۷

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

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