2025-10-23
الإصدار 1.5.1 من الإصدار التجريبي العلني لواجهات Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- خدمات 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.
- تتيح لك واجهة برمجة التطبيقات الخاصة بتفعيل الجهاز المركزي إمكانية العثور على جهاز Google Home المركزي وتفعيله بشكل آلي. اطّلِع على واجهة برمجة التطبيقات لتفعيل Hub على Android.
- تطبيق Android التجريبي
- إتاحة أنواع أجهزة جرس الباب التالية:
- OnOff
- بث مباشر
- التحدّث والاستماع
- Hub Activation API: تفعيل المراكز
- إتاحة أنواع أجهزة جرس الباب التالية:
المشاكل المعروفة التي تم حلّها
- لا يعرض "التطبيق التجريبي" حالة الجهاز بشكل صحيح في طريقة العرض الجهاز.
2025-09-26
الإصدار 1.5.0 من الإصدار التجريبي العلني لواجهات برمجة التطبيقات Home APIsيتيح هذا الإصدار استخدام أجهزة الكاميرا، ويتضمّن إصلاحات للأخطاء، ويحسّن جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- الإصدار 25.37.31 من "خدمات Google Play"
- الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
- Cast: 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 كمعلَمات.
- واجهة برمجة التطبيقات الخاصة بالأجهزة
- تمت إضافة نوع جهاز الكاميرا. تتوفّر أيضًا ميزات "الكاميرا" التالية لنوع جهاز "الجرس الذكي":
- البث المباشر للكاميرا
- التحدّث والاستماع من خلال الكاميرا
- بدء التسجيل بالكاميرا وإيقافه
- تطبيق 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.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.33.32
- الحد الأدنى لإصدارات البرامج الثابتة في Google Hub:
- Cast: 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
- يمكن حصر عمليات التشغيل الآلي في عدد محدود من المرات. يُرجى الاطّلاع على الحدّ من عدد عمليات التنفيذ.
- واجهة برمجة التطبيقات الخاصة بالأجهزة
- إمكانية إزالة جهاز 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
- البث:
- Android SDK: 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:
- 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 التجريبي، كان يتم عرض جهاز يتضمّن
connectivityStatePARTIALLY_ONLINEللمستخدم على أنّه غير متصل بالإنترنت. ويتم تمثيل هذه الحالة الآن على أنّها متصل.
2025-05-12
الإصدار التجريبي العلني 1.3 من واجهات Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على نظام التشغيل Android.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.16.33
- الحد الأدنى لإصدارات البرامج الثابتة في 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) لواجهات برمجة التطبيقات الخاصة بمنصة Home على نظام التشغيل Android.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.09.33
- الحد الأدنى لإصدارات البرامج الثابتة في 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
الميزات الجديدة
- تحسين الأداء عند تحميل العناصر من قاعدة بيانات 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يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (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
تم تعديل الإرشادات المتعلّقة بتهيئة واجهات برمجة التطبيقات في 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 إلى حلّ مشكلة عدم التطابق.
المشاكل المعروفة التي تم حلّها
- قد يتعذّر إعداد الجهاز إذا تم تصغير التطبيق أثناء العملية.
- الحلّ البديل: استخدِم
واجهة برمجة التطبيقات
suppressHalfSheetNotification()لإيقاف الإشعارات التي تظهر في نصف الشاشة عند استخدام واجهة برمجة التطبيقات Commissioning API في تطبيقك.
- الحلّ البديل: استخدِم
واجهة برمجة التطبيقات
- قد تمنع مشكلة من جهة الخادم عمل عبارات بدء التشغيل "Ok Google" في عمليات التشغيل الآلي.
- عند استخدام مركز يعمل بنظام التشغيل Fuchsia ولا يتضمّن أي أجهزة متوافقة مع معيار Matter في البنية، إذا ظل المركز غير نشط لمدة تزيد عن 3 ساعات، سيؤدي إعداد أول جهاز متوافق مع معيار Matter إلى عدم اتصال الجهاز بالإنترنت.
- بعد إعادة ضبط بيانات أحد المحاور على الإعدادات الأصلية، قد يتعذّر إرسال الأوامر إلى الأجهزة التي تم إعدادها حديثًا، على الرغم من الإبلاغ عن أنّ الجهاز متصل بالإنترنت.