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

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

2025-04-09

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

يحتوي هذا الإصدار على إصلاحات للأخطاء ويُحسِّن من جودة مدى التوفّر العام (GA) ل حزمة تطوير البرامج (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  

يحتوي هذا الإصدار على إصلاحات للأخطاء ويُحسِّن من جودة مدى التوفّر العام (GA) ل حزمة تطوير البرامج (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 الحد الأدنى لإصدار مكتبة 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  

يحتوي هذا الإصدار على إصلاحات للأخطاء ويُحسِّن من جودة مدى التوفّر العام (GA) ل حزمة تطوير البرامج (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 الحد الأدنى لإصدار مكتبة 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 الحد الأدنى لإصدار مكتبة 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 إلى إيقاف هذا الجهاز عن الاتصال بالإنترنت.
• بعد إجراء إعادة الضبط على الإعدادات الأصلية لمركز، قد يتعذّر تنفيذ الأوامر المرسَلة إلى الأجهزة التي تم تفعيلها حديثًا على الرغم من أنّ الجهاز يظهر على أنّه متصل بالإنترنت.