2025-10-23
الإصدار 1.5.1 من الإصدار التجريبي العلني لواجهات Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء ويعزز جودة الإصدار التجريبي لمجموعة أدوات تطوير البرامج الخاصة بـ Home APIs Android.
الحد الأدنى للإصدارات
- خدمات جوجل بلاي: 25.41.30
- الحد الأدنى لإصدارات البرامج الثابتة لـ Google Hub:
- طاقم العمل: 3.76.495998
- الفوشيا: 27.20250422.103.3600
- مجموعة أدوات تطوير برامج Android: home.android.sdk_1_5_1
- تطبيق Google Home: يعمل مع أي إصدار
androidx.coreالمكتبة: تعمل مع أي إصدار- إصدار Matter: 1.4.1.0
الميزات الجديدة
- واجهة برمجة التطبيقات Structure API
- تتيح لك واجهة برمجة التطبيقات الخاصة بتفعيل الأجهزة المحورية إمكانية العثور على جهاز محوري من Google Home وتفعيله بشكل آلي. اطّلِع على واجهة برمجة التطبيقات لتفعيل "المركز" على Android.
- تتيح لك واجهة برمجة التطبيقات الخاصة بتفعيل الأجهزة المحورية إمكانية العثور على جهاز محوري من Google Home وتفعيله بشكل آلي. اطّلِع على واجهة برمجة التطبيقات لتفعيل "المركز" على Android.
- تطبيق Android التجريبي
- تتوفّر أنواع أجهزة جرس الباب التالية:
- OnOff
- بث مباشر
- التحدّث والاستماع
- واجهة برمجة تطبيقات تفعيل المحاور: تفعيل المحاور
- تتوفّر أنواع أجهزة جرس الباب التالية:
المشاكل المعروفة التي تم إصلاحها
- لا يعرض "التطبيق التجريبي" حالة الجهاز بشكل صحيح في طريقة العرض الجهاز.
2025-09-26
الإصدار 1.5.0 من الإصدار التجريبي العلني لواجهات برمجة التطبيقات Home APIsيتيح هذا الإصدار استخدام أجهزة الكاميرا، ويتضمّن إصلاحات للأخطاء، كما يحسّن جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات Home APIs.
الحد الأدنى للإصدارات
- الإصدار 25.37.31 من "خدمات Google Play"
- الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
- الإصدار: 3.76.492738
- Fuchsia: 27.20250422.103.3600
- حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_1_5
- تطبيق Google Home: يعمل مع أي إصدار
androidx.coreالمكتبة: تعمل مع أي إصدار- إصدار Matter: 1.4.1.0
الميزات الجديدة
- Automation API
- تقبل إجراءات التفعيل والشروط والإجراءات الآن بنى Matter كمعلَمات.
- واجهة برمجة التطبيقات الخاصة بالأجهزة (Device API)
- تمت إضافة نوع جهاز الكاميرا. تتوفّر أيضًا ميزات "الكاميرا" التالية لنوع جهاز "الجرس الذكي":
- البث المباشر للكاميرا
- التحدّث والاستماع من خلال الكاميرا
- بدء التسجيل بالكاميرا وإيقافه
- تطبيق 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يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.33.32
- الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
- طاقم العمل: 3.76.495998
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_4_1
- تطبيق Google Home: يعمل مع أي إصدار
androidx.coreالمكتبة: تعمل مع أي إصدار- إصدار Matter: 1.4.0.0
الميزات الجديدة
- واجهة برمجة التطبيقات الخاصة بالأجهزة (Device API)
- يتم تحديد
DecommissionIneligibleReasonجديد لمحاولة إيقاف جهاز متعدد المصادر. راجِع الأجهزة التي تستخدم مصادر متعددة.
- يتم تحديد
المشاكل المعروفة
- عند إزالة الجهاز المحوري النشط حاليًا بشكل إجباري، ستكون هناك فترة خمس دقائق لا يمكن خلالها التحكّم في بعض الأجهزة. بعد خمس دقائق، ستتم استعادة إمكانية التحكّم في الأجهزة.
المشاكل المعروفة التي تم إصلاحها
- يتعطّل تطبيق Android التجريبي عندما يحاول المستخدم ضبط منظم حرارة على وضع غير متوافق معه.
2025-07-31
الإصدار التجريبي العلني 1.4.0 من Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.28.34
- الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
- الإصدار: 3.76.486931
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_4_0
- تطبيق Google Home: يعمل مع أي إصدار
androidx.coreالمكتبة: تعمل مع أي إصدار- إصدار Matter: 1.4.0.0
الميزات الجديدة
- Automation API
- يمكن حصر عمليات التشغيل الآلي في عدد محدود من المرات. يُرجى الاطّلاع على الحدّ من عدد عمليات التنفيذ.
- Device API
- إمكانية إزالة جهاز Matter آليًا راجِع المقالة إزالة جهاز.
- تمت إزالة أعضاء
HomeDeviceالذين تم إيقافهم نهائيًا:HomeDevice.trait(). يمكنك الاطّلاع على الوصول إلى الأجهزة والبيانات الوصفية للأجهزة على Android.HomeDevice.isInRoom. استخدمHomeDevice.roomIdبدلاً من ذلك.HomeDevice.isInStructure. استخدمHomeDevice.structureIdبدلاً من ذلك.
- Structure API
- يتضمّن
Home.hasPermissions()الآن حالة تفويض OAuth للمستخدم (إمكانية الوصول إلى البنية) بالإضافة إلى منح أذونات التطبيق.
- يتضمّن
- تطبيق Android التجريبي
- تم استبدال طلبات البيانات من واجهة برمجة التطبيقات المتوقفة نهائيًا.
- أعِد تسمية جهاز.
- احذف الأجهزة التي تتوافق مع Matter فقط.
المشاكل المعروفة
- بعد تسجيل الخروج من الهاتف ثم تسجيل الدخول مرة أخرى، لا يمكن لتطبيق Home APIs التحكّم في الأجهزة.
- الحل البديل: أغلق التطبيق أو شغِّله في الخلفية، ثم انتظِر 10 ثوانٍ على الأقل قبل إعادة المحاولة.
المشاكل المعروفة التي تم إصلاحها
- لا تسجّل أجهزة المكنسة الكهربائية التي تم إرساؤها الحالة "تم الإرساء".
2025-07-08
باستخدام الإصدار 3.76.479819 من البرامج الثابتة لخدمة Cast، يمكن لجهاز Nest Wifi Pro الآن العمل كمركز لواجهات برمجة التطبيقات الخاصة بمنزل Google.
2025-06-26
الإصدار 1.3.2 من الإصدار التجريبي العلني لواجهات برمجة التطبيقات Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على Android.
الحد الأدنى للإصدارات
- الإصدار 25.23.31 من "خدمات Google Play"
- الحد الأدنى لإصدارات البرامج الثابتة في 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)
اعتبارًا من هذا الإصدار، على المطوّرين تضمين كلتا السمتَين في مسارات مكتبة وقت التشغيل ووقت التجميع الخاصة بمشاريعهم.
- إطار عمل حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بالمنزل (
نموذج تطبيق Android
- يمكن للمستخدمين إلغاء الربط وإبطال الأذونات من التطبيق.
- تم تعديل عناصر حزمة SDK لتشمل
play-services-home-17.0.0وplay-services-home-types-17.0.0.
المشاكل المعروفة
- لا تسجّل أجهزة المكنسة الكهربائية التي تم إرساؤها الحالة "تم الإرساء".
2025-06-05
الإصدار 1.3.1 من الإصدار التجريبي العام لواجهات Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على Android.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.19.32
- الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
- طاقم العمل: 3.75.468222
- Fuchsia: 26.20250116.103.2201
- مجموعة أدوات تطوير برامج Android: 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 مع ظهور
FailedPreconditionExceptionعند إنشاء عمليات تشغيل آلي إذا لم يتم ضبط الموقع الجغرافي للمنزل في تطبيق Google Home (اطّلِع على تغيير عنوان المنزل على Google لمعرفة كيفية ضبط الموقع الجغرافي للمنزل). - في تطبيق Android التجريبي، كان يتم عرض جهاز يتضمّن
connectivityStatePARTIALLY_ONLINEللمستخدم على أنّه غير متصل بالإنترنت. ويتم تمثيل هذه الحالة الآن على أنّها متصل.
2025-05-12
الإصدار التجريبي العلني 1.3 من Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على Android.
الحد الأدنى للإصدارات
- خدمات جوجل بلاي: 25.16.33
- الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
- طاقم العمل: 3.75.468222
- Fuchsia: 26.20250116.103.2201
- مجموعة أدوات تطوير برامج Android: 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 قبل محاولة إنشاء الأتمتة.
المشاكل المعروفة التي تم إصلاحها
- قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
- بعد إعادة ضبط الجهاز المركزي على الإعدادات الأصلية، قد تظهر الأجهزة على أنّها غير متصلة بالإنترنت.
2025-04-09
الإصدار التجريبي العلني 1.2.1 من Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على Android.
الحد الأدنى للإصدارات
- الإصدار 25.09.33 من "خدمات Google Play"
- الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
- طاقم العمل: 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
الميزات الجديدة
- تحسين الأداء عند تحميل العناصر من قاعدة بيانات Home Graph
- Automation API
- تمت إضافة إمكانية استخدام فلاتر الكيانات، ما يتيح لعمليات التشغيل الآلي اختيار الأجهزة بشكل ديناميكي استنادًا إلى المعايير المحدّدة في عملية التشغيل الآلي.
- Device API
- تتوفّر الآن معلومات الأجهزة من السحابة الإلكترونية إلى السحابة الإلكترونية في
BasicInformationTrait.
- تتوفّر الآن معلومات الأجهزة من السحابة الإلكترونية إلى السحابة الإلكترونية في
المشاكل المعروفة
- قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
- بعد إعادة ضبط الجهاز المركزي على الإعدادات الأصلية، قد تظهر الأجهزة على أنّها غير متصلة بالإنترنت.
المشاكل المعروفة التي تم إصلاحها
- إذا تم استدعاء Discovery API قبل اكتمال عملية التهيئة أو قبل اكتمالها، سيتم عرض
HomeExceptionمعcode 14: UNKNOWNوالرسالة "لم يتم العثور على مسار". - في بيئة تحتوي على عدة بنى وعدة مستخدمين، قد يؤدي التبديل بين البنى والمستخدمين إلى عدم عرض أي أجهزة.
2025-03-14
الإصدار التجريبي العلني 1.2.0 من Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على Android.
الحد الأدنى للإصدارات
- الحد الأدنى لإصدار "خدمات 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) لواجهات برمجة التطبيقات الخاصة بمنصة Home على Android.
الحد الأدنى للإصدارات
- الحد الأدنى لإصدار "خدمات 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
تم تحديث الإرشادات الخاصة بتهيئة واجهات برمجة التطبيقات الرئيسية.
لقد أوضحنا بشكل أكبر أن مثيل الصفحة الرئيسية يجب تهيئةه كعنصر سياقي منفرد. يضمن هذا تجربة مستخدم أكثر سلاسة في تطبيقك ويتجنب الأخطاء المتعلقة بالجلسات غير الصالحة.
2025-01-07
إصدار تجريبي عام لواجهات برمجة التطبيقات الرئيسيةأثناء الإصدار التجريبي العام للمطورين، يمكن لجميع المطورين البدء في بناء تطبيقاتهم واختبارها.
يحتوي هذا الإصدار على إصلاحات للأخطاء ويعزز جودة الإصدار التجريبي لمجموعة أدوات تطوير البرامج الخاصة بـ Home APIs Android، بما في ذلك الدعم المحسّن لأجهزة Google Nest Audio وGoogle TV.
الحد الأدنى للإصدارات
- خدمات Google Play الإصدار الأدنى: 24.45.34
- الحد الأدنى لإصدارات البرامج الثابتة لـ Google Hub:
- إصدار Cast: 3.74.444798
- الحد الأدنى لإصدار Fuchsia: 22.20240805.103.161
- مجموعة أدوات تطوير برامج Android: home.android.sdk_202411_EAP_1_0_1_RC00
- الحد الأدنى لإصدار تطبيق Google Home (GHA): يعمل مع أي إصدار
- إصدار مكتبة
androidx.coreالأدنى: 1.10.0 - إصدار Matter:
1.3.0.0
- ملاحظة: لا يتم دعم أنواع الأجهزة والمجموعات المؤقتة.
المشاكل المعروفة
- قد تفشل عملية تبديل حساب Google المسجل الدخول إليه مما يؤدي إلى حدوث خطأ.
- الحل البديل: أعد تشغيل تدفق الأذونات أو أعد تشغيل التطبيق.
- قد لا تعمل أجهزة Google TV مع عمليات التشغيل الآلي التي تستخدم السمة
MediaPlayback. - في هيكل يحتوي فقط على مركز Google:
- قد تظهر أجهزة Matter على أنّها غير متصلة بالإنترنت في تطبيق Google Home.
- لا يمكن لـ "مساعد Google" التحكّم في أجهزة Matter.
- لا يمكن للشاشات الذكية التحكّم في أجهزة Matter أو عرض حالة أي جهاز متوافق مع Matter.
- في بعض الأجهزة، قد لا يعرض التطبيق الحالة بدقة دائمًا، وقد يعرض تطبيقك حالة مختلفة عن الحالة التي يعرضها تطبيق من Google، مثل تطبيق Google Home (GHA). ويحدث ذلك عادةً لأنّ الأجهزة لا تُبلغ Google بالحالة.
- الحلّ البديل: يؤدي التحقّق من الحالة باستخدام أحد تطبيقات Google إلى حلّ مشكلة عدم التطابق.
المشاكل المعروفة التي تم إصلاحها
- قد يتعذّر إعداد الجهاز إذا تم تصغير التطبيق أثناء العملية.
- الحل البديل: استخدِم واجهة برمجة التطبيقات
suppressHalfSheetNotification()لإيقاف الإشعارات التي تظهر في نصف الشاشة عند استخدام واجهة برمجة التطبيقات Commissioning API في تطبيقك.
- الحل البديل: استخدِم واجهة برمجة التطبيقات
- قد تمنع مشكلة من جهة الخادم عبارات بدء التشغيل "Ok Google" من العمل في عمليات التشغيل الآلي.
- عند استخدام محور يعمل بنظام Fuchsia ولا يحتوي على أي أجهزة Matter في الهيكل، فإذا تم ترك المحور خاملاً لأكثر من 3 ساعات، فإن تشغيل جهاز Matter الأول يؤدي إلى عدم اتصال جهاز Matter بالإنترنت.
- بعد إعادة ضبط بيانات أحد الأجهزة المحورية على الإعدادات الأصلية، قد يتعذّر إرسال الأوامر إلى الأجهزة التي تم إعدادها حديثًا، على الرغم من الإبلاغ عن أنّ الجهاز متصل بالإنترنت.