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

2026-05-01

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

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

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

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

  • تتيح سمة الترموستات الآن إمكانات القراءة/التعديل والتشغيل/الإيقاف والمؤقت

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

  • قد يتعذّر إعداد جهاز Matter.
  • لا يعرض مصباح Philips BLE الحالة الصحيحة.
  • وقت الاستجابة يتسبّب في عدم استقرار الشبكة وبطء أوقات الاستجابة.

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

  • يتعذّر إعداد بعض الأجهزة باستخدام جهاز Google TV Streamer بدقة 4K.
  • عندما يكون الموزّع هو Nest Wifi Pro أو Google Nest Hub أو Google Nest Hub Max، يعرض تطبيق Google Home الأجهزة المتعددة الأجزاء على شكل مربّعات متعددة.

2026-04-10

تم تعديل تطبيق Home APIs Android Sample App ليتوافق مع الإصدار 1.8 من Home APIs.

نموذج التطبيق

2026-04-09

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

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

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

  • الإصدار 26.12.32 من "خدمات Google Play"
  • البرامج الثابتة لجهاز Google Hub وCast وNest WiFi Pro: ‏3.78.518349
  • البرامج الثابتة لجهاز Google Hub وCast وجميع أجهزة Hub الأخرى المستندة إلى Cast: 3.78.526062
  • برامج Google Hub الثابتة، Fuchsia: ‏29.20251023.103.2101601
  • برنامج Google hub الثابت وGoogle TV Streamer و4K: UTTK.250729.004
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_GHP_1_8_0
  • تطبيق Google Home: يعمل مع أي إصدار
  • مكتبة androidx.core: تعمل مع أي إصدار
  • إصدار Matter: 1.4.1.0
  • إصدار Matter: دعم تجريبي للإصدار 1.5.0

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

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

  • لا يمكن تغيير وحدات درجة الحرارة (مئوية/فهرنهايت) في ترموستات Google Nest Learning Thermostat (الجيل الرابع).
  • في نسخة الويب من تطبيق Google Home على الأجهزة الجوّالة، يحجب العنوان الرمز العلوي وزر الرجوع. قد يتعذّر على المستخدمين الرجوع إلى الصفحة السابقة أو رؤية عناصر واجهة المستخدم الرئيسية.
  • قد يُبلغ أحد مراكز Android TV عن أجهزة Matter على أنّها "غير متصلة بالإنترنت" بشكل غير صحيح.

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

  • قد يتعذّر إعداد جهاز Matter.

2026-03-13

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

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

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

  • خدمات Google Play:
  • البرامج الثابتة لجهاز Google Hub وCast وNest WiFi Pro: ‏3.78.518349
  • البرامج الثابتة لجهاز Google Hub وCast وجميع أجهزة Hub الأخرى المستندة إلى Cast: 3.78.516526
  • برامج Google Hub الثابتة، Fuchsia: 29.20251023.103.2201
  • برنامج Google hub الثابت وGoogle TV Streamer و4K: UTTK.250729.004
  • ‫Android SDK: home.android.sdk_GHP_1_7_1
  • تطبيق Google Home: الإصدار 1.7.1
  • مكتبة androidx.core: تعمل مع أي إصدار
  • إصدار Matter: 1.4.1.0
  • إصدار Matter: دعم تجريبي للإصدار 1.5.0

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

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

  • تمت إزالة وضع "بدون محور".

نموذج التطبيق

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

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

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

  • لا يمكن تغيير وحدات درجة الحرارة (مئوية/فهرنهايت) في ترموستات Google Nest Learning Thermostat (الجيل الرابع).
  • قد يحدث تأخير في ثبات الاتصال بالشبكة واستجابة الجهاز.
  • في نسخة الموقع الإلكتروني المخصّصة للأجهزة الجوّالة من ‫Google Home للويب، يتم حجب الرمز العلوي وزر الرجوع بواسطة عنوان الصفحة. قد يتعذّر على المستخدمين الرجوع إلى الصفحة السابقة أو رؤية عناصر واجهة المستخدم الرئيسية.
  • قد يتوقف الجهاز في حالة "جارٍ الاتصال..." بعد تجربة التشغيل لأول مرة في "الوضع الموحّد".
  • قد يتعذّر إعداد جهاز Matter.
  • قد يُبلغ مركز Android TV بشكل غير صحيح عن حالة أجهزة Matter بأنّها "غير متصلة بالإنترنت".
  • قد لا يظهر إصدار البرنامج الصحيح في "إصدار البرنامج الحالي لجهاز الكاميرا".
  • يعرض شريط تمرير واجهة مستخدم الترموستات درجات حرارة خارج النطاق.
  • عند ضبط "مدة الرنين"، لن يرنّ الجهاز للمدة المحدّدة.

2026-02-13

تم تعديل تطبيق Home APIs Android Sample App ليتوافق مع الإصدار 1.7 من Home APIs.

نموذج التطبيق

2026-02-09

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

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

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

  • الإصدار 26.02.34 من "خدمات Google Play"
  • برامج Google Hub الثابتة وCast وNest WiFi Pro: ‏3.76.508025
  • البرامج الثابتة لـ "مركز Google" وCast وجميع المراكز الأخرى المستندة إلى Cast: 3.77.510748
  • برامج Google Hub الثابتة، Fuchsia: 29.20251023.103.2100
  • برنامج Google hub الثابت و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
  • إصدار Matter: دعم تجريبي للإصدار 1.5.0

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

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

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

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

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

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

2025-12-22

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

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

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

  • خدمات Google Play: الإصدار 25.47.30
  • البرامج الثابتة لجهاز Google Hub وCast وNest WiFi Pro: ‏3.75.479819
  • البرامج الثابتة لجهاز Google Hub وCast وجميع أجهزة Hub الأخرى المستندة إلى Cast: 3.77.505721
  • برامج Google Hub الثابتة، Fuchsia: 28.20250723.103.2100300
  • برنامج Google hub الثابت و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

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

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

  • يضيف تطبيق Android التجريبي إعدادات الكاميرا وعمليات التشغيل الآلي المحدّدة مسبقًا وإمكانية استخدام المروحة ومكبر الصوت.

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

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

2025-10-23

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

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

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

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

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

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

  • يضيف نموذج تطبيق Android إمكانية استخدام نوع جهاز جرس الباب (تشغيل/إيقاف، بث مباشر، التحدّث والاستماع) وتنفيذ واجهة برمجة التطبيقات Hub Activation API.

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

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

2025-09-26

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

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

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

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

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

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

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

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

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

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

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

2025-08-29

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

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

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

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

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

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

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

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

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

2025-07-31

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

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

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

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

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

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

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

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

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

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

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

2025-06-26

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

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

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

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

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

  • تم تقسيم عنصر حزمة تطوير البرامج (SDK) إلى عنصرَين منفصلَين: إطار عمل Home APIs SDK (play-services-home-17.0.0.aar) وسمات حزمة تطوير البرامج (SDK) وأنواع الأجهزة (play-services-home-types-17.0.0.aar). اعتبارًا من هذا الإصدار، على المطوّرين تضمين كلا العنصرَين في مسارات مكتبة وقت التجميع ووقت التشغيل في مشاريعهم.

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

  • تضيف عيّنة تطبيق Android ما يلي: يمكن للمستخدمين قطع الاتصال وإبطال الأذونات من التطبيق.
  • يضيف تطبيق 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
  • برامج Google Hub الثابتة، 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

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

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

  • يضيف تطبيق Android Sample App وظائف لتسجيل حالة المباني والأجهزة والأنواع والسمات وعمليات التشغيل الآلي لتسهيل عملية تصحيح الأخطاء.

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

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

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

2025-05-12

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

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

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

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

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

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

  • قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة 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
  • ‫Android SDK: 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
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_202411_EAP_1_0_1_RC00
  • الحد الأدنى لإصدار تطبيق Google Home (GHA): يعمل مع أي إصدار
  • الحد الأدنى لإصدار مكتبة androidx.core هو 1.10.0
  • إصدار Matter: 1.3.0.0
    • ملاحظة: لا تتوفّر أنواع ومجموعات أجهزة Provisional 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 إلى عدم توفّره.
  • بعد إعادة الضبط على الإعدادات الأصلية لأحد المحاور، قد يتعذّر إرسال الأوامر إلى الأجهزة التي تم إعدادها حديثًا، على الرغم من الإبلاغ عن أنّ الجهاز متصل بالإنترنت.