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

05-06-2025

Home APIs Public Beta نسخه 1.3.1

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

حداقل نسخه ها

  • خدمات Google Play: 25.19.32
  • حداقل نسخه های سیستم عامل هاب گوگل:
    • بازیگران: 3.75.468222
    • فوشیا: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
  • برنامه Google Home: با هر نسخه ای کار می کند
  • کتابخانه androidx.core : با هر نسخه ای کار می کند
  • نسخه اصلی: 1.4.0.0

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

صفات

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

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

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

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

مسائل شناخته شده

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

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

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

12-05-2025

Home APIs Public Beta نسخه 1.3

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

حداقل نسخه ها

  • خدمات گوگل پلی: 25.16.33
  • حداقل نسخه های سیستم عامل هاب گوگل:
    • بازیگران: 3.75.468222
    • فوشیا: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • برنامه Google Home: با هر نسخه ای کار می کند
  • کتابخانه androidx.core : با هر نسخه ای کار می کند
  • نسخه اصلی: 1.4.0.0

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

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

مسائل شناخته شده

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

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

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

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

09-04-2025

Home APIs Public Beta نسخه 1.2.1

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

حداقل نسخه ها

  • خدمات گوگل پلی: 25.09.33
  • حداقل نسخه های سیستم عامل هاب گوگل:
    • بازیگران: 3.75.468222
    • فوشیا: 24.20241009.103.1900601 1
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • برنامه Google Home: با هر نسخه ای کار می کند
  • کتابخانه androidx.core : 1.10.0
  • نسخه اصلی: 1.4.0.0
1. این ساخت در حال حاضر در حال تولید است و تا 22 آوریل 2025 برای همه دستگاه ها در دسترس خواهد بود.

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

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

مسائل شناخته شده

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

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

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

2025-03-14

Home APIs Public Beta نسخه 1.2.0

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

حداقل نسخه ها

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

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

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

مسائل شناخته شده

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

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

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

29-01-2025

Home APIs Public Beta نسخه 1.1.0

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

حداقل نسخه ها

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

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

  • Streaming API:
  • Batching API (تجربی):
    • به برنامه‌نویس اجازه می‌دهد تا چندین دستور را به صورت دسته‌ای ارسال کند که به طور همزمان اجرا می‌شوند.
    • به ارسال چند دستور همزمان مراجعه کنید.

مسائل شناخته شده

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

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

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

14-01-2025

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

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

07-01-2025

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

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

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

حداقل نسخه ها

  • حداقل نسخه خدمات Google Play: 24.45.34
  • حداقل نسخه سیستم عامل هاب گوگل:
    • نسخه بازیگران: 3.74.444798
    • نسخه مین فوشیا: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • نسخه حداقل برنامه Google Home (GHA): با هر نسخه ای کار می کند
  • حداقل نسخه کتابخانه androidx.core : 1.10.0
  • نسخه اصلی: 1.3.0.0
    • توجه: انواع و خوشه‌های دستگاه Provisional Matter پشتیبانی نمی‌شوند.

مسائل شناخته شده

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

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

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