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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

2025-06-05

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

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

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

• "خدمات Google Play": 25.19.32
• الحد الأدنى لإصدارات البرامج الثابتة لأجهزة Google Hub:
  • الإصدار 3.75.468222 من تطبيق Cast
  • Fuchsia: 26.20250116.103.2201
• حزمة تطوير البرامج (SDK) لنظام التشغيل 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. الاطّلاع على
  • ExtendedDoorLockTrait.LockStateChange.user_id
  • ExtendedDoorLockTrait.PrivacyModeActor.user_id

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

نموذج تطبيق Android

تمّت إضافة دوالّ لتسجيل حالة الهياكل والأجهزة والأنواع والسمات والإجراءات المبرمَجة لتسهيل تصحيح الأخطاء.

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

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

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

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

2025-05-12

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

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

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

• "خدمات Google Play": 25.16.33
• الحد الأدنى لإصدارات البرامج الثابتة لأجهزة Google Hub:
  • الإصدار 3.75.468222 من تطبيق Cast
  • Fuchsia: 26.20250116.103.2201
• حزمة تطوير البرامج (SDK) لنظام التشغيل 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 ويعرض رمز الخطأ FailedPreconditionException عند إنشاء عمليات التشغيل الآلي في حال عدم ضبط الموقع الجغرافي للمنزل في تطبيق Google Home (GHA) (اطّلِع على تغيير عنوان المنزل على Google لمعرفة كيفية إجراء ذلك).

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

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

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

2025-04-09

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

يتضمّن هذا الإصدار إصلاحات للأخطاء ويُحسِّن جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لـ Home APIs على Android.

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

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

^{1. نحن بصدد طرح هذا الإصدار حاليًا في قناة الإصدار العلني، وسيصبح متاحًا على جميع الأجهزة بحلول 22 نيسان (أبريل) 2025.}

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

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

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

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

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

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

2025-03-14

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

يتضمّن هذا الإصدار إصلاحات للأخطاء وتحسينات على الإصدار التجريبي من حزمة تطوير البرامج (SDK) لـ Home APIs على 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 APIs HomeManager.structures() بعد تشغيله، لا يتلقّى أيّ بنيات، حتى في حال توفّر بنية واحدة أو أكثر. يعطي ذلك انطباعًا خاطئًا بأنّه ما مِن هياكل مرتبطة بحساب Google.
• عند تحميل الإجراءات المبرمَجة وإنشائها وتعديلها، قد يواجه المستخدمون مدّة انتظار طويلة.
• على المستخدمين الذين يبدأون عملية الإعداد من تطبيق "الكاميرا" مسح رمز الاستجابة السريعة مرتين لإكمال عملية إعداد Matter.
• في بنية تحتوي على أكثر من 200 جهاز، قد لا تعرض Discovery API أي أجهزة مرشحة.

2025-01-29

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

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

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

• الحد الأدنى لإصدار "خدمات 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:
  • يوفّر مصادر أحداث تُرسِل إشعارات بشأن الهياكل والغرف والأجهزة التي تمت إضافتها وتغييرها وإزالتها.
  • اطّلِع على الاشتراك في أحداث صلة العناصر.
• Batching API (تجريبية):
  • السماح للمطوّر بإرسال أوامر متعددة في دفعات يتم تنفيذها في الوقت نفسه
  • يُرجى الاطّلاع على مقالة إرسال عدة أوامر في آنٍ واحد.

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

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

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

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

2025-01-14

إرشادات معدَّلة لإعداد Home APIs

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

2025-01-07

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

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

يتضمّن هذا الإصدار إصلاحات للأخطاء وتحسينات على جودة الإصدار التجريبي لحزمة تطوير البرامج (SDK) لـ Home APIs على 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
  • ملاحظة: لا تتوفّر أنواع أجهزة Matter المؤقتة ومجموعاتها.

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

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

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

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