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

07-01-2025

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

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

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