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

2025-03-14

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

حداقل نسخه ها

• حداقل نسخه خدمات Google Play: 25.06.32
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.75.456944
  • نسخه کوتاه فوشیا: 24.20241009.103.1900601
• Android SDK: home.android.sdk_202412_EAP_1_2_RC01
• نسخه حداقل برنامه 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

این نسخه حاوی رفع اشکال است و کیفیت دسترسی عمومی (GA) را برای 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، عدم تطابق را برطرف می کند.

2025-01-14

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

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

07-01-2025

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

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

2025-03-14

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

حداقل نسخه ها

• حداقل نسخه خدمات Google Play: 25.06.32
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.75.456944
  • نسخه کوتاه فوشیا: 24.20241009.103.1900601
• Android SDK: home.android.sdk_202412_EAP_1_2_RC01
• نسخه حداقل برنامه 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

این نسخه حاوی رفع اشکال است و کیفیت دسترسی عمومی (GA) را برای 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، عدم تطابق را برطرف می کند.

2025-01-14

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

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

07-01-2025

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

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

2025-03-14

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

حداقل نسخه ها

• حداقل نسخه خدمات Google Play: 25.06.32
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.75.456944
  • نسخه کوتاه فوشیا: 24.20241009.103.1900601
• Android SDK: home.android.sdk_202412_EAP_1_2_RC01
• نسخه حداقل برنامه 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

این نسخه حاوی رفع اشکال است و کیفیت دسترسی عمومی (GA) را برای 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، عدم تطابق را برطرف می کند.

2025-01-14

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

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

07-01-2025

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

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

2025-03-14

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

حداقل نسخه ها

• حداقل نسخه خدمات Google Play: 25.06.32
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.75.456944
  • نسخه کوتاه فوشیا: 24.20241009.103.1900601
• Android SDK: home.android.sdk_202412_EAP_1_2_RC01
• نسخه حداقل برنامه 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

این نسخه حاوی رفع اشکال است و کیفیت دسترسی عمومی (GA) را برای 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، عدم تطابق را برطرف می کند.

2025-01-14

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

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

07-01-2025

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

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