ملاحظات حول إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Home APIs

2026-02-09

  الإصدار 1.7 من الإصدار التجريبي العلني لواجهات Home APIs  

يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

الحد الأدنى للإصدارات

  • الإصدار 26.02.34 من "خدمات Google Play"
  • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
    • البث:
      • Nest WiFi Pro: 3.76.508025
      • جميع مراكز التحكّم الأخرى المستندة إلى Cast: 3.77.510748
    • Fuchsia: 29.20251023.103.2100
    • ‫Google TV Streamer، بدقة 4K: UTTK.250729.004
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_GHP_1_7
  • تطبيق Google Home: الإصدار 1.7
  • androidx.core المكتبة: تعمل مع أي إصدار
  • إصدار Matter: 1.4.1.0، مع توفير دعم تجريبي للإصدار 1.5.0

الميزات الجديدة

  • واجهة Permissions API

    • تغييرات أخرى جديرة بالذكر

    المشاكل المعروفة التي تم إصلاحها

    • تعرض واجهة برمجة التطبيقات History API دائمًا nextPageToken، ما يؤدي إلى حدوث حلقة لا نهائية.
    • يحدث الخطأ "ألغى المستخدم مسار طلب الإذن" عند محاولة تسجيل الدخول إلى حساب جديد.

    المشاكل المعروفة

    • بالنسبة إلى Nest Cam Indoor/Outdoor (بطارية أو سلكية) وNest Doorbell (بطارية، الجيل الثاني)، لا يتوفّر الخيار "الوقت المتبقي للبطارية" في إعدادات البطارية.
    • يتم تجاهل إعداد مدة الرنين.
    • يظهر مصباح Philips BLE بشكل غير صحيح على أنّه "متصل بالإنترنت" حتى عندما يكون الجهاز غير متصل بالإنترنت.
      • الحل البديل: لا تعتمد فقط على حالة الاتصال بالإنترنت الخاصة بنوع جهاز المنزل الذكي (SHDT). بدلاً من ذلك، استخدِم خريطة Target Device State Service (TDSS) للأجهزة التي تستخدم المصدر LOCAL_SYNC.

    2025-12-22

      الإصدار التجريبي العلني 1.6 من Home APIs  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • خدمات Google Play: الإصدار 25.47.30
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • البث:
        • Nest WiFi Pro: 3.75.479819
        • جميع مراكز التحكّم الأخرى المستندة إلى Cast: 3.77.505721
      • Fuchsia: 28.20250723.103.2100300
      • ‫Google TV Streamer، بدقة 4K: UTTK.250729.004
    • ‫Android SDK: home.android.sdk_GHP_1_6
    • تطبيق Google Home: الإصدار 1.6
    • androidx.core المكتبة: تعمل مع أي إصدار
    • إصدار Matter: 1.4.1.0

    الميزات الجديدة

    • Automation API
    • واجهة برمجة التطبيقات الخاصة بالأجهزة
      • توفير المزيد من إمكانات أجهزة الكاميرات وأجراس الأبواب:
        • الإعدادات الجديدة:
          • تفعيل الرؤية الليلية أو إيقافها
          • سطوع مؤشر LED للحالة
          • إطار عرض الكاميرا
          • اتجاه الصورة
          • حساسية أجهزة الاستشعار لتشغيل الكاميرا
          • المدة القصوى للحدث
          • أصوات الرنين

          لمزيد من المعلومات، راجِع دليل أجهزة الكاميرا على Android.

    • الاتصال
    • Structure API
    • تطبيق Android التجريبي
      • إعدادات الكاميرا وجرس الباب
        • تشغيل/إيقاف الميكروفون
        • تفعيل/إيقاف ميزة "تسجيل الصوت"
      • عمليات التشغيل الآلي المحدّدة مسبقًا
      • تمت إضافة دعم لنوعَي الأجهزة "مروحة" و"مكبّر صوت".
    • تسجيل الدخول باستخدام حساب Google من خلال التطبيق

    المشاكل المعروفة

    • تتوقف أدوات التحكّم بالجهاز عن العمل بعد فترات طويلة من الاستخدام.
      • الحل البديل: أعِد تشغيل الموزّع.
    • قد يتعذّر إعداد جهاز Matter.
    • يظهر الخطأ "ألغى المستخدم عملية منح الأذونات" عند محاولة إضافة حساب جديد في "التطبيق التجريبي لنظام التشغيل Android".
      • الحلّ البديل: أضِف حسابات Google من خلال إعدادات جهاز Android.
    • لا يمكن بث فيديو مباشر من كاميرا المراقبة السلكية من Walmart onn التي تم إعدادها باستخدام حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات Home على Android عبر تطبيق Google Home.

    2025-10-23

      الإصدار 1.5.1 من الإصدار التجريبي العلني لواجهات Home APIs  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • خدمات Google Play: الإصدار 25.41.30
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • Cast: 3.76.495998
      • Fuchsia: 27.20250422.103.3600
    • ‫Android SDK: home.android.sdk_1_5_1
    • تطبيق Google Home: يعمل مع أي إصدار
    • androidx.core المكتبة: تعمل مع أي إصدار
    • إصدار Matter: 1.4.1.0

    الميزات الجديدة

    • Structure API
      • تتيح لك واجهة برمجة التطبيقات الخاصة بتفعيل الجهاز المركزي إمكانية العثور على جهاز Google Home المركزي وتفعيله بشكل آلي. اطّلِع على واجهة برمجة التطبيقات لتفعيل Hub على Android.
    • تطبيق Android التجريبي
      • إتاحة أنواع أجهزة جرس الباب التالية:
        • OnOff
        • بث مباشر
        • التحدّث والاستماع
      • واجهة برمجة تطبيقات تفعيل المحاور: تفعيل المحاور

    المشاكل المعروفة التي تم حلّها

    • لا يعرض "التطبيق التجريبي" حالة الجهاز بشكل صحيح في طريقة العرض الجهاز.

    2025-09-26

      الإصدار 1.5.0 من الإصدار التجريبي العلني لواجهات برمجة التطبيقات Home APIs  

    يتيح هذا الإصدار استخدام أجهزة الكاميرا، ويتضمّن إصلاحات للأخطاء، ويحسّن جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • خدمات Google Play: الإصدار 25.37.31
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • الإصدار: 3.76.492738
      • Fuchsia: 27.20250422.103.3600
    • ‫Android SDK: home.android.sdk_1_5
    • تطبيق Google Home: يعمل مع أي إصدار
    • androidx.core المكتبة: تعمل مع أي إصدار
    • إصدار Matter: 1.4.1.0

    الميزات الجديدة

    • Automation API
      • تقبل إجراءات التفعيل والشروط والإجراءات الآن بنى Matter كمعلَمات.
    • واجهة برمجة التطبيقات الخاصة بالأجهزة
      • تمت إضافة نوع جهاز الكاميرا. تتوفّر أيضًا ميزات "الكاميرا" التالية لنوع جهاز "الجرس الذكي":
        • البث المباشر للكاميرا
        • التحدّث والاستماع من خلال الكاميرا
        • بدء التسجيل بالكاميرا وإيقافه
    • تطبيق Android التجريبي
      • التوافق مع نوع الجهاز "كاميرا":
        • البث المباشر للكاميرا
        • التحدّث والاستماع من خلال الكاميرا
        • بدء التسجيل بالكاميرا وإيقافه
        • أذونات أنواع الأجهزة المحظورة
      • إعداد أجهزة متعدّدة من قِبل مشرفين متعدّدين (مشاركة جهاز تم إعداده).
      • عملية تشغيل آلي OnOff محدّدة مسبقًا

    المشاكل المعروفة

    • قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
    • قد لا يعمل التحكّم في أنواع أجهزة المروحة المتوافقة مع Cloud-to-Cloud في التطبيق التجريبي.

    المشاكل المعروفة التي تم حلّها

    • عند إزالة المحور النشط حاليًا بشكل إجباري، ستكون هناك فترة خمس دقائق يتعذّر خلالها التحكّم في بعض الأجهزة. بعد خمس دقائق، ستتم استعادة إمكانية التحكّم في الأجهزة.
    • بعد أن يختار المستخدم لونًا من إعداد مسبق أو من أداة اختيار درجة حرارة اللون، يتعذّر على مصباح Extended Color Light تعديل اللون.

    2025-09-08

    تم طرح الإصدار 1.4.1 من تطبيق Sample App لنظام التشغيل Android.

    الميزات الجديدة

    • إنشاء غرفة وإعادة تسميتها وتعديلها وحذفها
    • الربط بشبكة Matter تابعة لجهة خارجية

    المشاكل المعروفة التي تم إصلاحها

    • أصبح رابط صفحة إبطال الأذونات يعمل الآن.

    2025-08-29

      الإصدار 1.4.1 من الإصدار التجريبي العلني لواجهات برمجة التطبيقات Home APIs  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • الإصدار 25.33.32 من "خدمات Google Play"
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • Cast: 3.76.495998
      • Fuchsia: 27.20250422.103.3600
    • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_1_4_1
    • تطبيق Google Home: يعمل مع أي إصدار
    • androidx.core المكتبة: تعمل مع أي إصدار
    • إصدار Matter: 1.4.0.0

    الميزات الجديدة

    المشاكل المعروفة

    • عند إزالة المحور النشط حاليًا بشكل إجباري، ستكون هناك فترة خمس دقائق يتعذّر خلالها التحكّم في بعض الأجهزة. بعد خمس دقائق، ستتم استعادة إمكانية التحكّم في الأجهزة.

    المشاكل المعروفة التي تم حلّها

    • يتعطّل تطبيق Android التجريبي عندما يحاول المستخدم ضبط منظم حرارة على وضع غير متوافق معه.

    2025-07-31

      الإصدار التجريبي العلني 1.4.0 من Home APIs  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • خدمات Google Play: الإصدار 25.28.34
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • الإصدار: 3.76.486931
      • Fuchsia: 27.20250422.103.3600
    • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_1_4_0
    • تطبيق Google Home: يعمل مع أي إصدار
    • androidx.core المكتبة: تعمل مع أي إصدار
    • إصدار Matter: 1.4.0.0

    الميزات الجديدة

    المشاكل المعروفة

    • بعد تسجيل الخروج من الهاتف ثم تسجيل الدخول مرة أخرى، لا يمكن لتطبيق Home APIs التحكّم في الأجهزة.
      • الحلّ البديل: أغلق التطبيق أو شغِّله في الخلفية، ثم انتظِر 10 ثوانٍ على الأقل قبل إعادة المحاولة.

    المشاكل المعروفة التي تم حلّها

    • لا تسجّل أجهزة المكنسة الكهربائية التي تم إرساؤها الحالة "تم الإرساء".

    2025-07-08

    باستخدام إصدار البرنامج الثابت 3.76.479819 من Cast، يمكن لجهاز Nest WiFi Pro الآن العمل كمركز لواجهات برمجة التطبيقات الخاصة بمنزل Google.

    2025-06-26

      الإصدار 1.3.2 من الإصدار التجريبي العام لواجهات Home APIs  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • خدمات Google Play: الإصدار 25.23.31
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • البث:
        • ‫Google Home وGoogle Home Mini وGoogle Nest Mini: الإصدار 3.75.468362
        • ‫Google Nest Audio: 3.75.476451
      • Fuchsia: 26.20250116.103.2900
    • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_1_3_2
    • تطبيق Google Home: يعمل مع أي إصدار
    • androidx.core المكتبة: تعمل مع أي إصدار
    • إصدار Matter: 1.4.0.0

    الميزات الجديدة

    • تم تقسيم عنصر حزمة تطوير البرامج (SDK) إلى عنصرَين منفصلَين:
      • إطار عمل حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بالمنزل (play-services-home-17.0.0.aar)
      • سمات حزمة تطوير البرامج (SDK) وأنواع الأجهزة (play-services-home-types-17.0.0.aar)

      اعتبارًا من هذا الإصدار، على المطوّرين تضمين كلتا السمتَين في مسارات مكتبة وقت التشغيل ووقت التجميع الخاصة بمشاريعهم.

    نموذج تطبيق Android

    • يمكن للمستخدمين إلغاء الربط وإبطال الأذونات من التطبيق.
    • تم تعديل عناصر حزمة SDK لتشمل play-services-home-17.0.0 وplay-services-home-types-17.0.0.

    المشاكل المعروفة

    • لا تسجّل أجهزة المكنسة الكهربائية التي تم إرساؤها الحالة "تم الإرساء".

    2025-06-05

      الإصدار 1.3.1 من الإصدار التجريبي العلني لواجهات برمجة التطبيقات Home APIs  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • خدمات Google Play: الإصدار 25.19.32
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • Cast: 3.75.468222
      • Fuchsia: 26.20250116.103.2201
    • ‫Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
    • تطبيق Google Home: يعمل مع أي إصدار
    • androidx.core المكتبة: تعمل مع أي إصدار
    • إصدار Matter: 1.4.0.0

    الميزات الجديدة

    السمات

    • يقدّم هذا التحديث السمة SyntheticSwitch التي تسهّل التعامل مع الأحداث التي تنشئها أجهزة Matter Switch وتتيح لمفاتيح التحكّم تشغيل أدوات بدء التشغيل التلقائي.
    • تتضمّن السمة ExtendedDoorLock تغييرًا غير متوافق مع الإصدارات السابقة، وهو أنّه تم تغيير نوع بيانات الحقل user_id من String إلى Long. يمكنك الاطّلاع على

      يجب إعادة تجميع التطبيقات التي تستخدم هذه السمة.

    نموذج تطبيق Android

    تمت إضافة دوال لتسجيل حالة البُنى والأجهزة والأنواع والسمات وعمليات التشغيل الآلي لتسهيل عملية تصحيح الأخطاء.

    المشاكل المعروفة

    في تطبيق Android التجريبي، يتطلّب الزر إنشاء عملية تشغيل آلي أحيانًا النقر عليه عدة مرات لتشغيله.

    المشاكل المعروفة التي تم إصلاحها

    • يتعطّل تطبيق Google Home عند إنشاء عمليات تشغيل آلي إذا لم يتم ضبط موقع المنزل في تطبيق Google Home (راجِع مقالة تغيير عنوان المنزل على Google لمعرفة كيفية ضبط موقع المنزل).FailedPreconditionException
    • في تطبيق Android التجريبي، كان يتم عرض جهاز يتضمّن connectivityState PARTIALLY_ONLINE للمستخدم على أنّه غير متصل بالإنترنت. ويتم تمثيل هذه الحالة الآن على أنّها متصل.

    2025-05-12

      الإصدار التجريبي العلني 1.3 من واجهات Home APIs  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • الإصدار 25.16.33 من "خدمات Google Play"
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • Cast: 3.75.468222
      • Fuchsia: 26.20250116.103.2201
    • ‫Android SDK: home.android.sdk_202504_EAP_1_3_RC00
    • تطبيق Google Home: يعمل مع أي إصدار
    • androidx.core المكتبة: تعمل مع أي إصدار
    • إصدار Matter: 1.4.0.0

    الميزات الجديدة

    • Automation API
      • تمت إضافة إمكانية استخدام مشغّلات الأحداث المجدوَلة المتكرّرة، ما يتيح للمطوّرين إنشاء عمليات تشغيل آلي تُنفَّذ بشكل دوري استنادًا إلى الوقت الفعلي والوقت الشمسي والشروط المستندة إلى التقويم، وذلك باستخدام تعبيرات cron.
    • واجهة برمجة التطبيقات الخاصة بالأجهزة (Device API)
      • تمت إضافة إمكانية إعادة تسمية الأجهزة. اطّلِع على مقالة تغيير اسم جهاز.
    • واجهة برمجة التطبيقات Structure API
      • تمت إضافة إمكانية إعادة تسمية الغرف. يمكنك الاطّلاع على تغيير اسم غرفة.

    المشاكل المعروفة

    يتعطّل تطبيق Google Home عند إنشاء عمليات تشغيل آلي إذا لم يتم ضبط موقع المنزل في تطبيق Google Home (راجِع مقالة تغيير عنوان المنزل على Google لمعرفة كيفية إجراء ذلك).FailedPreconditionException

    • الحل البديل: تأكَّد من توفّر عنوان المنزل باستخدام Discovery API قبل محاولة إنشاء عمليات التشغيل الآلي.

    المشاكل المعروفة التي تم إصلاحها

    • قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
    • بعد إعادة ضبط الجهاز المركزي على الإعدادات الأصلية، قد تظهر الأجهزة على أنّها غير متصلة بالإنترنت.

    2025-04-09

      الإصدار التجريبي العلني 1.2.1 من Home APIs  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • الإصدار 25.09.33 من "خدمات Google Play"
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • Cast: 3.75.468222
      • ‫Fuchsia: 24.20241009.103.19006011
    • ‫Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
    • تطبيق Google Home: يعمل مع أي إصدار
    • مكتبة androidx.core: الإصدار 1.10.0
    • إصدار Matter: 1.4.0.0
    1. نحن بصدد طرح هذا الإصدار في مرحلة الإنتاج، وسيكون متاحًا على جميع الأجهزة بحلول 22 أبريل 2025.

    الميزات الجديدة

    • تحسين الأداء عند تحميل العناصر من قاعدة بيانات Home Graph
    • Automation API
      • تمت إضافة إمكانية استخدام فلاتر الكيانات، ما يتيح لعمليات التشغيل الآلي اختيار الأجهزة ديناميكيًا استنادًا إلى المعايير المحدّدة في عملية التشغيل الآلي.
    • واجهة برمجة التطبيقات الخاصة بالأجهزة (Device API)
      • تتوفّر الآن معلومات الأجهزة من السحابة الإلكترونية إلى السحابة الإلكترونية في BasicInformationTrait.

    المشاكل المعروفة

    • قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
    • بعد إعادة ضبط الجهاز المركزي على الإعدادات الأصلية، قد تظهر الأجهزة على أنّها غير متصلة بالإنترنت.

    المشاكل المعروفة التي تم حلّها

    • إذا تم استدعاء Discovery API قبل اكتمال عملية التهيئة أو قبل اكتمالها، سيتم عرض HomeException مع code 14: UNKNOWN والرسالة "لم يتم العثور على مسار".
    • في بيئة تحتوي على عدة بنى وعدة مستخدمين، قد يؤدي التبديل بين البنى والمستخدمين إلى عدم عرض أي أجهزة.

    2025-03-14

      الإصدار التجريبي العلني 1.2.0 من واجهات برمجة تطبيقات Home  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • الحد الأدنى لإصدار "خدمات Google Play": 25.06.32
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • إصدار Cast: 3.75.456944
      • الحد الأدنى لإصدار Fuchsia: 24.20241009.103.1900601
    • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_1_2_0_RC06
    • الحد الأدنى لإصدار تطبيق Google Home: يعمل مع أي إصدار
    • الحد الأدنى لإصدار مكتبة androidx.core هو 1.10.0
    • إصدار Matter: 1.3.0.0
      • ملاحظة: لا تتوفّر أنواع أجهزة Matter المؤقتة ومجموعاتها.

    الميزات الجديدة

    • Automation API:
      • إتاحة النطاقات الزمنية والتواريخ الجزئية في شروط التشغيل الآلي راجِع مقالة استخدام التواريخ مع بين.
      • في الإصدارات السابقة، كانت واجهة Discovery API تعرض NumberSetConstraint لبعض حقول الصور النقطية، بينما كان من المفترض أن تعرض BitmapConstraint. تعرض هذه الحقول الآن BitmapConstraint كما هو متوقّع. يقتصر ذلك على صور نقطية optionsMask وoptionsOverride في أوامر السمة LevelControl.

    المشاكل المعروفة

    • قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
    • بعد إعادة ضبط الجهاز المركزي على الإعدادات الأصلية، قد تظهر الأجهزة على أنّها غير متصلة بالإنترنت.
    • إذا تم استدعاء Discovery API قبل اكتمال عملية التهيئة أو قبل اكتمالها، سيتم عرض HomeException مع code 14: UNKNOWN والرسالة "لم يتم العثور على مسار".
      • الحلّ البديل: لا تستدعِ واجهة برمجة التطبيقات Discovery API إلا عندما تحتاج إلى مرشّحين للأتمتة. لا تجلب مسبقًا الكيانات المرشّحة وتخزّنها مؤقتًا. تحقَّق ممّا إذا كان أحد العناصر متصلاً بالإنترنت قبل استدعاء طرق Discovery API عليه.
    • في بيئة تحتوي على عدة بنى وعدة مستخدمين، قد يؤدي التبديل بين البنى والمستخدمين إلى عدم عرض أي أجهزة.

    المشاكل المعروفة التي تم حلّها

    • في المرة الأولى التي يستدعي فيها تطبيق يستخدم واجهات برمجة تطبيقات Home الدالة HomeManager.structures() بعد تشغيله، يتلقّى صفرًا من البُنى، حتى في حال توفّر بنية واحدة أو أكثر. ويؤدي ذلك إلى إعطاء انطباع خاطئ بأنّه لا توجد مبانٍ مرتبطة بحساب Google.
    • عند تحميل عمليات الإعداد التلقائي وإنشائها وتعديلها، قد يواجه المستخدمون فترات انتظار طويلة.
    • على المستخدمين الذين يبدأون عملية الإعداد من تطبيق "الكاميرا" مسح رمز الاستجابة السريعة ضوئيًا مرتين لإكمال عملية إعداد Matter.
    • في بنية تحتوي على أكثر من 200 جهاز، قد لا تعرض واجهة برمجة التطبيقات Discovery أي أجهزة مرشّحة.

    2025-01-29

      الإصدار 1.1.0 من الإصدار التجريبي العلني لواجهات برمجة التطبيقات Home APIs  

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.

    الحد الأدنى للإصدارات

    • الحد الأدنى لإصدار "خدمات Google Play": 25.02.32
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • إصدار Cast: 3.75.456944
      • الحد الأدنى لإصدار Fuchsia: 24.20241009.103.1900500
    • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_202412_EAP_1_1_RC04
    • الحد الأدنى لإصدار تطبيق Google Home: يعمل مع أي إصدار
    • الحد الأدنى لإصدار مكتبة androidx.core هو 1.10.0
    • إصدار Matter: 1.3.0.0
      • ملاحظة: لا تتوفّر أنواع أجهزة Matter المؤقتة ومجموعاتها.

    الميزات الجديدة

    • Streaming API:
      • توفّر هذه السمة مصادر بيانات الأحداث التي تُرسل إشعارات بشأن المباني والغرف والأجهزة التي تمت إضافتها أو تغييرها أو إزالتها.
      • اطّلِع على الاشتراك في أحداث علاقة الكيانات.
    • واجهة برمجة التطبيقات لتنفيذ عمليات مجمّعة (تجريبية):

    المشاكل المعروفة

    • عند تحميل عمليات الإعداد التلقائي وإنشائها وتعديلها، قد يواجه المستخدمون فترات انتظار طويلة.
    • على المستخدمين الذين يبدأون عملية الإعداد من تطبيق "الكاميرا" مسح رمز الاستجابة السريعة ضوئيًا مرتين لإكمال عملية إعداد Matter.
    • في بنية تحتوي على أكثر من 200 جهاز، قد لا تعرض واجهة برمجة التطبيقات Discovery أي أجهزة مرشّحة.

    المشاكل المعروفة التي تم حلّها

    • قد يتعذّر تبديل حساب Google الذي تم تسجيل الدخول إليه، ما يؤدي إلى حدوث خطأ.
    • قد لا تعمل أجهزة Google TV مع عمليات التشغيل الآلي التي تستخدم السمة MediaPlayback.
    • في بنية تتضمّن مركز Google فقط:
      • قد تظهر أجهزة Matter على أنّها غير متصلة بالإنترنت في تطبيق Google Home.
      • لا يمكن لـ "مساعد Google" التحكّم في أجهزة Matter.
      • لا يمكن للشاشات الذكية التحكّم في أجهزة Matter أو عرض حالة أي جهاز Matter.
    • في بعض الأجهزة، قد لا يعرض التطبيق الحالة الدقيقة دائمًا، وقد يبلغ تطبيقك عن حالة مختلفة عن تلك التي يبلغ عنها تطبيق Google، مثل تطبيق Google Home. ويرجع ذلك عادةً إلى أنّ الأجهزة لا تبلغ Google بالحالة.
      • الحلّ البديل: يؤدي التحقّق من الحالة باستخدام أحد تطبيقات Google إلى حلّ مشكلة عدم التطابق.

    2025-01-14

    تم تعديل الإرشادات المتعلّقة بتهيئة واجهات برمجة التطبيقات الخاصة بمنصة Home.

    أوضحنا بشكل أكبر أنّه يجب تهيئة مثيل من Home كعنصر فردي في سياق. يضمن ذلك توفير تجربة أكثر سلاسة للمستخدمين في تطبيقك وتجنُّب حدوث أخطاء في الجلسات غير الصالحة.

    2025-01-07

      إطلاق الإصدار التجريبي العلني من واجهات برمجة التطبيقات Home APIs  

    خلال برنامج الإصدار التجريبي المفتوح للمطوّرين، يمكن لجميع المطوّرين البدء في إنشاء تطبيقاتهم واختبارها.

    يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات على جودة الإصدار التجريبي لحزمة تطوير البرامج (SDK) لواجهات برمجة تطبيقات Home على Android، بما في ذلك تحسين التوافق مع أجهزة Google Nest Audio وGoogle TV.

    الحد الأدنى للإصدارات

    • الحد الأدنى لإصدار "خدمات Google Play": 24.45.34
    • الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
      • إصدار Cast: 3.74.444798
      • الحد الأدنى لإصدار Fuchsia: 22.20240805.103.161
    • ‫Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
    • الحد الأدنى لإصدار تطبيق Google Home (GHA): يعمل مع أي إصدار
    • الحد الأدنى لإصدار مكتبة androidx.core هو 1.10.0
    • إصدار Matter: 1.3.0.0
      • ملاحظة: لا تتوفّر أنواع أجهزة Matter المؤقتة ومجموعاتها.

    المشاكل المعروفة

    • قد يتعذّر تبديل حساب Google الذي تم تسجيل الدخول إليه، ما يؤدي إلى حدوث خطأ.
      • الحل البديل: أعِد تشغيل عملية منح الأذونات أو أعِد تشغيل التطبيق.
    • قد لا تعمل أجهزة Google TV مع عمليات التشغيل الآلي التي تستخدم السمة MediaPlayback.
    • في بنية تتضمّن مركز Google فقط:
      • قد تظهر أجهزة Matter على أنّها غير متصلة بالإنترنت في تطبيق Google Home.
      • لا يمكن لـ "مساعد Google" التحكّم في أجهزة Matter.
      • لا يمكن للشاشات الذكية التحكّم في أجهزة Matter أو عرض حالة أي جهاز متوافق مع Matter.
    • في بعض الأجهزة، قد لا يعرض التطبيق الحالة بدقة دائمًا، وقد يعرض تطبيقك حالة مختلفة عن الحالة التي يعرضها تطبيق من Google، مثل تطبيق Google Home (GHA). ويحدث ذلك عادةً لأنّ الأجهزة لا تُبلغ Google بالحالة.
      • الحلّ البديل: يؤدي التحقّق من الحالة باستخدام أحد تطبيقات Google إلى حلّ مشكلة عدم التطابق.

    المشاكل المعروفة التي تم حلّها

    • قد يتعذّر إعداد الجهاز إذا تم تصغير التطبيق أثناء العملية.
    • قد تمنع مشكلة من جهة الخادم عمل عبارات بدء التشغيل "Ok Google" في عمليات التشغيل الآلي.
    • عند استخدام مركز يعمل بنظام التشغيل Fuchsia ولا يتضمّن أي أجهزة متوافقة مع معيار Matter في البنية، إذا ظل المركز غير نشط لأكثر من 3 ساعات، سيؤدي إعداد أول جهاز متوافق مع معيار Matter إلى عدم توفّره.
    • بعد إعادة ضبط بيانات أحد المحاور على الإعدادات الأصلية، قد يتعذّر إرسال الأوامر إلى الأجهزة التي تم إعدادها حديثًا، على الرغم من الإبلاغ عن أنّ الجهاز متصل بالإنترنت.