2026-07-08
محتوى جديد
2026-07-07
تم تعديل تطبيق Home APIs Android Sample App ليتوافق مع الإصدار 1.9.1 من Home APIs.
نموذج التطبيق
2026-06-26
الإصدار التجريبي العلني الأول من Home APIs 1.9.1يحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- خدمات Google Play: 26.24.22
- البرامج الثابتة لجهاز Google Hub وCast وNest WiFi Pro: 3.78.518349
- البرامج الثابتة لجهاز Google Hub وCast وجميع أجهزة Hub الأخرى المستندة إلى Cast: 3.78.538123
- برامج Google Hub الثابتة، Fuchsia: 30.20260121.103.1602904
- برنامج Google hub الثابت، وGoogle TV Streamer (4k): UTTK.250729.004 (14748786)
- حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_1_9_1.zip
- تطبيق Google Home: يعمل مع أي إصدار
-
مكتبة
androidx.core: تعمل مع أي إصدار - إصدار Matter: 1.4.1.0
- إصدار Matter: توافق تجريبي مع الإصدار 1.5.0
الميزات الجديدة
- الكاميرا وجرس الباب: حالة استبدال البطارية
- إتاحة استخدام لقطات صور من الكاميرا وجرس الباب كمعاينات أثناء إعداد "منطقة النشاط" و"العرض المباشر"
المشاكل المعروفة التي تم حلّها
- لا تتوافق عملية الإعداد السريع باستخدام Fast Pair مع طُرز الأجهزة Google Nest Cam Outdoor (سلكية، الجيل الثاني) وGoogle Nest Cam Indoor (سلكية، الجيل الثالث) وDoorbell (سلكي، الجيل الثالث).
2026-06-09
تم تعديل تطبيق Home APIs Android Sample App ليتوافق مع الإصدار 1.9.0 من Home APIs.
نموذج التطبيق
2026-05-29
الإصدار 1.9 من الإصدار التجريبي العلني لواجهات Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- الإصدار 26.20.31 من "خدمات Google Play"
- البرامج الثابتة لجهاز Google Hub وCast وNest WiFi Pro: 3.78.518349
- البرامج الثابتة لجهاز Google Hub وCast وجميع أجهزة Hub الأخرى المستندة إلى Cast: 3.78.526062
- برامج Google Hub الثابتة، Fuchsia: 30.20260121.103.1602904
- برنامج Google hub الثابت، وGoogle TV Streamer (4k): UTTK.250729.004 (14748786)
- حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_GHP_1_9
- تطبيق Google Home: يعمل مع أي إصدار
-
مكتبة
androidx.core: تعمل مع أي إصدار - إصدار Matter: 1.4.1.0
- إصدار Matter: توافق تجريبي مع الإصدار 1.5.0
الميزات الجديدة
- إعدادات الكاميرا وجرس الباب: نوع قاعدة الكاميرا
- إعدادات الكاميرا وجرس الباب: الإبلاغ بقدوم زوّار
- إعدادات الكاميرا وجرس الباب: الإعدادات المفضّلة لجودة البث المباشر
- الردود السريعة لجرس الباب
- اقتراحات بشأن البنية للسماح للشركاء بالاختيار المُسبَق للبِنى في مسار طلب الأذونات
- التوافق مع الأجهزة المتعدّدة الأجزاء في عمليات التشغيل الآلي
-
تعديلات على سمات Google المخصّصة التالية:
ExtendedFanControlوExtendedThermostat -
تعديلات على سمات Matter التالية:
ArmDisarmوFanControlوThermostatوThermostatFanControlوThermostatUserInterfaceConfiguration
المشاكل المعروفة
- لا تتوافق عملية الإعداد السريع باستخدام Fast Pair مع طُرز الأجهزة Google Nest Cam Outdoor (سلكية، الجيل الثاني) وGoogle Nest Cam Indoor (سلكية، الجيل الثالث) وDoorbell (سلكي، الجيل الثالث).
2026-05-26
تم تعديل تطبيق Home APIs Android Sample App ليتوافق مع الإصدار 1.8.1 من Home APIs.
نموذج التطبيق
2026-05-01
الإصدار 1.8.1 من الإصدار التجريبي العلني لواجهات Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- الإصدار 26.16.31 من "خدمات Google Play"
- البرامج الثابتة لجهاز Google Hub وCast وNest WiFi Pro: 3.78.518349
- البرامج الثابتة لجهاز Google Hub وCast وجميع أجهزة Hub الأخرى المستندة إلى Cast: 3.78.526062
- برامج Google Hub الثابتة، Fuchsia: 30.20260121.103.1602802
- برنامج Google hub الثابت وGoogle TV Streamer و4K: UTTK.250729.004
- حزمة تطوير البرامج (SDK) لنظام التشغيل Android: home.android.sdk_GHP_1_8_1
- تطبيق Google Home: الإصدار 4.8 أو إصدار أحدث
-
مكتبة
androidx.core: تعمل مع أي إصدار - إصدار Matter: 1.4.1.0
- إصدار Matter: توافق تجريبي مع الإصدار 1.5.0
الميزات الجديدة
- تتيح سمة الترموستات الآن إمكانات القراءة/التعديل والتشغيل/الإيقاف والمؤقت
المشاكل المعروفة التي تم حلّها
- قد يتعذّر إعداد جهاز 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.
الحد الأدنى للإصدارات
- الإصدار 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
الميزات الجديدة
- عمليات التشغيل الآلي المقترَحة في Automations API
- إتاحة الأجهزة المتعددة الأجزاء في Device API
- إعداد منطقة النشاط في الكاميرا وجرس الباب باستخدام Device API
- إعداد ميزة "رصد الصوت" في الكاميرا وجرس الباب من خلال Device API
- وضع التسجيل من الكاميرا وجرس الباب (CVR/EVR/No History) في Device API:
المشاكل المعروفة التي تم حلّها
- لا يمكن تغيير وحدات درجة الحرارة (مئوية/فهرنهايت) في ترموستات Google Nest Learning Thermostat (الجيل الرابع).
- في نسخة الويب من تطبيق Google Home على الأجهزة الجوّالة، يتم حجب الرمز العلوي وزر الرجوع بواسطة عنوان الصفحة. قد يتعذّر على المستخدمين الرجوع إلى الخلف أو رؤية عناصر واجهة المستخدم الرئيسية.
- قد يُبلغ مركز Android TV عن أجهزة Matter على أنّها "غير متصلة بالإنترنت" بشكل غير صحيح.
المشاكل المعروفة
- قد يتعذّر إعداد جهاز Matter.
2026-03-13
الإصدار التجريبي العلني 1.7.1 من Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- خدمات 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
الميزات الجديدة
- الموافقة على مشاركة بيانات "إحصاءات الكاميرا وجرس الباب" في Device API
- وقت آخر اتصال بالكاميرا وجرس الباب في Device API
- حالة اتصال الكاميرا وجرس الباب في Device API
- طلبات الترموستات الذكية في Device API
تغييرات أخرى جديرة بالذكر
- تمت إزالة وضع "بدون محور".
نموذج التطبيق
المشاكل المعروفة التي تم حلّها
- بالنسبة إلى Nest Cam Indoor/Outdoor (بطارية أو سلكية) وNest Doorbell (بطارية، الجيل الثاني)، لا يتوفّر الخيار "الوقت المتبقي للبطارية" في إعدادات البطارية.
- يتم تجاهل إعداد مدة الرنين.
- يظهر مصباح Philips BLE بشكل غير صحيح على أنّه "متصل بالإنترنت" حتى عندما يكون الجهاز غير متصل بالإنترنت.
المشاكل المعروفة
- لا يمكن تغيير وحدات درجة الحرارة (مئوية/فهرنهايت) في ترموستات Google Nest Learning Thermostat (الجيل الرابع).
- قد تحدث تأخيرات في ثبات الاتصال بالشبكة واستجابة الجهاز.
- في إصدار Google Home For Web على الأجهزة الجوّالة، يتم حجب الرمز العلوي وزر الرجوع بواسطة عنوان الصفحة. قد يتعذّر على المستخدمين الرجوع إلى الخلف أو رؤية عناصر واجهة المستخدم الرئيسية.
- قد يتعذّر على الجهاز المحور الخروج من حالة "جارٍ الاتصال..." بعد تجربة التشغيل لأول مرة في "الوضع الموحّد".
- قد يتعذّر إعداد جهاز 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.
الحد الأدنى للإصدارات
- الإصدار 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
- Android SDK: home.android.sdk_GHP_1_7
- تطبيق Google Home: الإصدار 1.7
-
مكتبة
androidx.core: تعمل مع أي إصدار - إصدار Matter: 1.4.1.0
- إصدار Matter: توافق تجريبي مع الإصدار 1.5.0
الميزات الجديدة
- عمليات التشغيل الآلي المحلية: استنادًا إلى شروط مثل الاتصال وأنواع الأجهزة والسمات، يمكن الآن تنفيذ بعض عمليات التشغيل الآلي محليًا في Automations API.
- تفعيل تجربة الإعداد خارج الصندوق (OOBE) للكاميرا في التطبيقات ضمن Device API
- نغمات جرس الباب والكاميرا في Device API
- ميزة "توفير شحن البطارية تلقائيًا" في الكاميرا وجرس الباب ضمن Device API
- إعدادات استخدام البطارية المفضّلة في الكاميرات وأجراس الأبواب ضمن Device API
- حالة شحن بطارية الكاميرا وجرس الباب في Device API
- مستويات شحن البطارية في الكاميرات وأجراس الأبواب ضمن Device API
- الرقم التسلسلي للكاميرا وجرس الباب في Device API
- طراز الكاميرا وجرس الباب في Device API
- إصدار برنامج الكاميرا وجرس الباب في Device API
- واجهة برمجة تطبيقات مخصّصة للمفتاح والقيمة في Device API
- يتيح طلب الأذونات لأحد التطبيقات تحديد أنواع الأجهزة التي منحها المستخدم إذن الوصول في Permissions API.
تغييرات أخرى جديرة بالذكر
-
تم استبدال
HomeException.unsupportedبالرمزHomeException.unimplementedليتوافق مع رموز الخطأ المعيارية. - تم تغيير أداة إنشاء الرموز المجمّعة للسمات المخصّصة في الإصدار 1.7. على المطوّرين الذين لديهم سمات مخصّصة إعادة تجميع سماتهم بعد دمج حزمة تطوير البرامج (SDK) الإصدار 1.7.
المشاكل المعروفة التي تم حلّها
-
تعرض واجهة برمجة التطبيقات 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.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.47.30
- البرامج الثابتة لجهاز Google Hub وCast وNest WiFi Pro: 3.75.479819
- البرامج الثابتة لمركز تحكّم Google وCast وجميع مراكز التحكّم الأخرى المستندة إلى 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
الميزات الجديدة
- إتاحة سمة "الطقس" في Automation API تمت إضافة إمكانية استخدام سمة "الطقس" في إجراءات تفعيل عمليات التشغيل الآلي وشروطها.
- إتاحة المزيد من إمكانات أجهزة الكاميرا وجرس الباب: إعدادات جديدة (الإضاءة الليلية، ومؤشر LED للحالة، ونافذة العرض، والاتجاه، والحساسية، ومدة الحدث، والرنين).
- تسجيل الدخول إلى Google من خلال التطبيق لتبسيط مسار تجربة المستخدم وإلغاء عمليات التحقّق من المستخدمين النشطين:
- يتيح "وضع التشغيل بلا مركز تحكّم" للمستخدمين إعداد أجهزة Matter معيّنة والتحكّم فيها بدون مركز تحكّم مستقل.
- واجهة برمجة تطبيقات تفعيل المحور لاكتشاف المحاور وتفعيلها:
تغييرات أخرى جديرة بالذكر
- يضيف تطبيق Android التجريبي إعدادات الكاميرا وعمليات التشغيل الآلي المحدّدة مسبقًا وإمكانية استخدام المروحة ومكبر الصوت.
المشاكل المعروفة
- تتوقف أدوات التحكّم بالجهاز عن العمل بعد فترات استخدام طويلة. الحل البديل: أعِد تشغيل الموزّع.
- قد يتعذّر إعداد جهاز Matter.
- يظهر الخطأ "ألغى المستخدم مسار الأذونات" عند محاولة إضافة حساب جديد في "التطبيق التجريبي على Android". الحلّ البديل: إضافة حسابات Google من خلال إعدادات جهاز Android
- لا يمكن بث فيديو مباشر من "كاميرا أمان سلكية" من Walmart onn تم إعدادها باستخدام حزمة تطوير البرامج (SDK) لواجهات برمجة تطبيقات Home على Android من خلال تطبيق Google Home.
- لا يمكن بدء جلسات البث المباشر من تطبيق Google Home للكاميرات التي تم إعدادها في تطبيقات Home APIs.
2025-10-23
الإصدار 1.5.1 من الإصدار التجريبي العلني لواجهات Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.41.30
- برامج Google Hub الثابتة، Cast: 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 التجريبي إمكانية استخدام نوع جهاز Doorbell (تشغيل/إيقاف، بث مباشر، محادثة ثنائية الاتجاه) وتنفيذ واجهة برمجة التطبيقات Hub Activation API.
المشاكل المعروفة التي تم حلّها
- لا يعرض "التطبيق التجريبي" حالة الجهاز بشكل صحيح في "عرض الجهاز".
2025-09-26
الإصدار 1.5.0 من الإصدار التجريبي العلني لواجهات برمجة التطبيقات Home APIsيتيح هذا الإصدار استخدام أجهزة الكاميرا، ويتضمّن إصلاحات للأخطاء، ويحسّن جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لواجهات برمجة التطبيقات الخاصة بمنصة Home على Android.
الحد الأدنى للإصدارات
- خدمات 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
الميزات الجديدة
- تقبل الآن إجراءات التفعيل والشروط والإجراءات بنى Matter كمعلَمات في Automation API.
- تمت إضافة نوع جهاز الكاميرا إلى Device API (البث المباشر، والتواصل في اتجاهين، وبدء التسجيل وإيقافه).
تغييرات أخرى جديرة بالذكر
-
يضيف تطبيق Android التجريبي إمكانية استخدام الكاميرا، وإعداد الأجهزة من قِبل عدة مشرفين، وعملية التشغيل الآلي
OnOffالمحدّدة مسبقًا.
المشاكل المعروفة التي تم حلّها
- عندما تتم إزالة الجهاز المركزي النشط حاليًا بشكل إجباري، ستكون هناك فترة خمس دقائق يتعذّر خلالها التحكّم في بعض الأجهزة. بعد خمس دقائق، ستتم استعادة إمكانية التحكّم في الأجهزة.
- بعد أن يختار المستخدم لونًا من إعداد مسبق أو من أداة اختيار درجة حرارة اللون، يتعذّر على مصباح Extended Color Light تعديل اللون.
المشاكل المعروفة
- قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
- قد لا يعمل التحكّم في أنواع أجهزة المراوح المتوافقة مع Cloud-to-cloud في التطبيق التجريبي.
2025-08-29
الإصدار 1.4.1 من الإصدار التجريبي العام لواجهات برمجة تطبيقات Homeيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بواجهات برمجة التطبيقات Home.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.33.32
- برامج Google Hub الثابتة، Cast: 3.76.495998
- برامج Google Hub الثابتة، Fuchsia: 27.20250422.103.3600
- Android SDK: 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.
الحد الأدنى للإصدارات
- خدمات Google Play: الإصدار 25.28.34
- برامج Google Hub الثابتة، Cast: 3.76.486931
- برامج Google Hub الثابتة، 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 آليًا في Device API
-
تمت إزالة أعضاء
HomeDeviceالمتوقّفين نهائيًا (trait()وisInRoomوisInStructure). -
يتضمّن
Home.hasPermissions()الآن إمكانية الوصول إلى بنية OAuth وعمليات منح أذونات التطبيق.
تغييرات أخرى جديرة بالذكر
- يحذف تطبيق 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
الميزات الجديدة
-
تتضمّن هذه الإصدارات السمة
SyntheticSwitchالتي تسهّل التعامل مع الأحداث التي تنشئها أجهزة Matter Switch وتسمح لمفاتيح التبديل بتشغيل أدوات بدء التشغيل التلقائي. -
تتضمّن السمة
ExtendedDoorLockتغييرًا غير متوافق: تم تغيير نوع بيانات الحقلuser_idمنStringإلىLong. يجب إعادة تجميع التطبيقات التي تستخدم هذه السمة.
تغييرات أخرى جديرة بالذكر
- يضيف تطبيق Android Sample App وظائف لتسجيل حالة البِنى والأجهزة والأنواع والسمات وعمليات التشغيل الآلي لتسهيل عملية تصحيح الأخطاء.
المشاكل المعروفة التي تم حلّها
-
يتعطّل تطبيق Google Home مع ظهور الرمز
FailedPreconditionExceptionعند إنشاء عمليات تشغيل آلي إذا لم يتم ضبط الموقع الجغرافي للمنزل في تطبيق Google Home. -
في تطبيق Android التجريبي، كان الجهاز الذي يحمل
connectivityStatePARTIALLY_ONLINEيظهر سابقًا على أنّه غير متصل بالإنترنت. يتم تمثيل هذه الحالة الآن على أنّها "متصل".
المشاكل المعروفة
- في تطبيق 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
الميزات الجديدة
-
تمت إضافة إمكانية تشغيل الأحداث المجدوَلة المتكررة في Automation API، ما يتيح للمطوّرين إنشاء عمليات تشغيل آلي تعمل بشكل دوري استنادًا إلى الوقت الفعلي والوقت الشمسي والشروط المستندة إلى التقويم، وذلك باستخدام تعبيرات
cron. - تمت إضافة إمكانية إعادة تسمية الأجهزة في Device API.
- تمت إضافة إمكانية إعادة تسمية الغرف في Structure API.
المشاكل المعروفة التي تم حلّها
- قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة 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
الميزات الجديدة
- تحسين الأداء عند تحميل العناصر من قاعدة بيانات Home Graph
- Automation API
- تمت إضافة إمكانية استخدام فلاتر الكيانات، ما يتيح لعمليات التشغيل الآلي اختيار الأجهزة ديناميكيًا استنادًا إلى المعايير المحدّدة في عملية التشغيل الآلي.
- واجهة برمجة التطبيقات الخاصة بالأجهزة
- تتوفّر الآن معلومات الأجهزة من السحابة الإلكترونية إلى السحابة الإلكترونية في
BasicInformationTrait.
- تتوفّر الآن معلومات الأجهزة من السحابة الإلكترونية إلى السحابة الإلكترونية في
المشاكل المعروفة
- قد يزداد وقت استجابة أدوات التحكم بالجهاز عند التبديل من شبكة Wi-Fi إلى شبكة جوّال.
- بعد إعادة ضبط الجهاز المركزي على الإعدادات الأصلية، قد تظهر الأجهزة على أنّها غير متصلة بالإنترنت.
المشاكل المعروفة التي تم حلّها
- إذا تم استدعاء Discovery API قبل اكتمال عملية التهيئة أو قبل اكتمالها، سيتم عرض الخطأ
HomeExceptionمعcode 14: UNKNOWNوالرسالة "لم يتم العثور على مسار". - في بيئة تحتوي على عدة مبانٍ وعدة مستخدمين، قد يؤدي التبديل بين المباني والمستخدمين إلى عدم عرض أي أجهزة.
2025-03-14
الإصدار التجريبي العلني 1.2.0 من Home APIsيحتوي هذا الإصدار على إصلاحات للأخطاء وتحسينات في جودة الإصدار التجريبي من حزمة تطوير البرامج (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
- Android SDK: 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 إلى حلّ مشكلة عدم التطابق.
المشاكل المعروفة التي تم حلّها
- قد يتعذّر إعداد الجهاز إذا تم تصغير التطبيق أثناء العملية.
- الحلّ البديل: استخدِم
واجهة برمجة التطبيقات
suppressHalfSheetNotification()لإيقاف الإشعارات التي تظهر في نصف الشاشة عند استخدام واجهة برمجة التطبيقات Commissioning API في تطبيقك.
- الحلّ البديل: استخدِم
واجهة برمجة التطبيقات
- قد تمنع مشكلة من جهة الخادم عمل عبارات بدء التشغيل "Ok Google" في عمليات التشغيل الآلي.
- عند استخدام مركز يعمل بنظام التشغيل Fuchsia ولا يتضمّن أي أجهزة متوافقة مع معيار Matter في البنية، إذا ظل المركز غير نشط لأكثر من 3 ساعات، سيؤدي إعداد أول جهاز متوافق مع معيار Matter إلى عدم توفّر الجهاز.
- بعد إعادة ضبط بيانات أحد الأجهزة المحورية على الإعدادات الأصلية، قد يتعذّر إرسال الأوامر إلى الأجهزة التي تم إعدادها حديثًا، على الرغم من الإبلاغ عن أنّ الجهاز متصل بالإنترنت.