يستخدم "Google Home Sample App for Matter" Google Home Mobile SDK لإنشاء تطبيق Android مشابه لـ Google Home app (GHA). يوفّر نموذج التطبيق هذا الميزات التالية:
- توفير أجهزة Matter المادية والافتراضية لشبكة Android المحلية
- توفير الأجهزة المادية والافتراضية لشبكة تطوير
- التحكّم في الأجهزة على شبكة التطوير، مثل تشغيل مصباح
- تتيح لك ميزات "المشرفين المتعددين" مشاركة الأجهزة على شبكة التطوير مع تطبيقات أخرى، والعكس صحيح، إذ يمكنك تضمين الأجهزة التي تمت مشاركتها من تطبيقات أخرى في شبكة التطوير
- أدوات مساعدة للمطوّرين
يوضّح هذا الدليل كيفية تثبيت حزمة APK لـ "Sample App for Matter" واستخدامها لتشغيل أجهزة Matter والتحكّم فيها ومشاركتها.
لتنزيل الرمز المصدر، والتعرّف على كيفية دمج Mobile SDK، وتخصيص الشاشات في "استوديو Android"، يمكنك تجربة الدرس التطبيقي حول الترميز Sample App for Matter.
الانتقال إلى الدرس التطبيقي حول الترميز Sample App for Matter
المتطلبات الأساسية
- جهاز يعمل بنظام التشغيل Android O (الإصدار 8.1، المستوى 27 لواجهة برمجة التطبيقات) أو إصدار أحدث متاح للاختبار للتأكّد من أنّ جهازك يتضمّن أحدث إصدار من Matter، يُرجى مراجعة دليل التحقّق من وحدات وخدمات Matter.
- إنشاء جهاز Matter مزوّد بإمكانات التشغيل/الإيقاف يعمل نموذج التطبيق هذا مع جهاز افتراضي وشريحة ESP32.
- جهاز Matter افتراضي (MVD): للحدّ من المشاكل المتعلّقة بالبيئة، ننصحك بشدة باستخدام MVD في البداية. إذا واجهت أي مشاكل، سيكون من الأسهل بكثير التحقيق فيها إذا تم استخدام نموذج التطبيق مع MVD.
- أنشئ جهازًا افتراضيًا من نوع Matter
باستخدام تطبيق
rootnode_dimmablelight_bCwGYSDpoe. عند إنشاء عملية دمج من نوع Matter في Google Home Developer Console، استخدِم0xFFF1كمعرّف المورّد و0x8000كمعرّف المنتج. - إنشاء جهاز Espressif
باستخدام
all-clusters-appعند إنشاء عملية دمج مع Matter في Developer Console، يُرجى استخدام0xFFF1كمعرّف المورّد و0x8001كمعرّف المنتج.
لا تحتاج إلى مركز تحكّم، مثل Google Nest Hub (2nd gen)، لتشغيل الأجهزة والتحكّم فيها باستخدام Sample App for Matter.
تثبيت
انتقِل إلى قسم الإصدارات في مستودع GitHub الخاص بـ Sample App for Matter. للاطّلاع على أحدث إصدار، ابحث في قسم "مواد العرض" (Assets) عن حزمة APK باسم
GHSAFM-version-default-debug.apk. لا تختَرtargetcommissioner.ثبِّت أداة Android Debug Bridge (adb):
وصِّل جهاز Android باستخدام كابل USB وفعِّل ميزة نقل الملفات، ثم ثبِّت حزمة APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
تشغيل الأجهزة
عند تشغيل نموذج التطبيق لأول مرة، سيظهر لك مربّع حوار يتضمّن رابطًا إلى الدرس التطبيقي حول الترميز في Sample App for Matter. إذا اخترت عدم عرض هذه الرسالة مرة أخرى، يمكنك إعادة عرض مربّع الحوار في أي وقت من خلال تعديل الإعدادات المفضّلة في قسم "المشرف" في التطبيق.
في الخطوات التالية، ستضيف جهاز Matter إلى شبكة Android المحلية، بالإضافة إلى شبكة تطوير محلية لنموذج التطبيق فقط.
ما هي شبكات Matter؟
شبكة Matter هي نطاق ثقة مشترك بين الأجهزة في شبكة منزلية يتيح لها التواصل مع بعضها.
قد تحتوي الأجهزة على شبكة واحدة أو أكثر تتوافق مع نظام أساسي أو تطبيق أو مجموعة من الأجهزة التي تتفاعل معًا. تحتوي الشبكات على معرّف فريد، وتشارك الأجهزة مجموعة بيانات الاعتماد نفسها وهيئة إصدار الشهادات (CA). يتم تعيين بيانات الاعتماد هذه أثناء تشغيل Matter.
لتشغيل جهاز Matter، يُرجى اتّباع الخطوات التالية:
انقر على زر "إضافة جهاز" لبدء عملية التشغيل.
بعد ذلك، يتم نقل التحكّم إلى Google Play services، الذي يتم تشغيله من خلال طلب إلى Mobile SDK. لإثبات حيازة الجهاز، امسح رمز الاستجابة السريعة ضوئيًا أو انقر على استخدام رمز الإقران.
عند اكتمال عملية التشغيل، أدخِل اسم الجهاز، ثم انقر على تم.
أصبح جهازك الآن متصلاً بكل من شبكة Android المحلية وشبكة التطوير.
تتم معالجة جميع أعمال التشغيل والشاشات المرتبطة بها من خلال Play services عند تشغيل الأجهزة. يوفّر ذلك تجربة مستخدم متّسقة ويزيل الحاجة إلى التعامل مع أذونات الوصول إلى المعلومات الحساسة، مثل بيانات اعتماد Wi-Fi وThread.
التحكُّم في الأجهزة
تنشئ بنية التطوير بيانات الاعتماد للتحكّم في أجهزة Matter مباشرةً من نموذج التطبيق.
من الشاشة الرئيسية، يمكنك تفعيل جهازك أو إيقافه. انقر على الجهاز للوصول إلى تفاصيله.
مشاركة الأجهزة
تُعرف مشاركة الجهاز باسم مسار المشرفين المتعددين في مواصفات Matter. بعد إعداد الجهاز في نموذج التطبيق، يمكنك مشاركته بسهولة مع منظومات متكاملة أخرى.
لمشاركة جهاز "Matter" مع منظومات متكاملة أخرى، يجب تثبيت نظام أساسي آخر على جهاز Android. وتصبح هذه المنصة الخارجية المفوَّض المستهدَف. لقد أنشأنا نسخة أخرى من نموذج التطبيق يمكنك استخدامها كجهاز تفويض مستهدَف.
انتقِل إلى قسم الإصدارات في مستودع GitHub الخاص بـ Sample App for Matter. للاطّلاع على أحدث إصدار، ابحث في قسم "مواد العرض" (Assets) عن حزمة APK باسم
GHSAFM-version-targetcommissioner-debug.apk. لا تختَرdefault.ثبِّت تطبيق المفوِّض المستهدَف.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkمن الشاشة الرئيسية، انقر على الجهاز لعرض معلوماته. انقر على مشاركة.
يطلب نموذج التطبيق واجهة برمجة التطبيقات Mobile SDK Share API، ويتم نقل التحكّم مرة أخرى إلى Play services.
تظهر صفحة مشاركة تتيح لك اختيار التطبيق أو المنصة التي تريد إقران الجهاز بها. توفر هذه الشاشة طريقتين لمشاركة الجهاز:
- يدويًا من خلال رمز إعداد تتم مشاركته مع تطبيق المفوّض المستهدَف
- باستخدام تطبيق Android محلي تم تسجيله كجهة تفويض Matter
يحمل تطبيق المفوِّض المستهدَف التصنيف GHSAFM-TC. انقر على هذا النموذج من نموذج التطبيق لمشاركة جهازك.
بعد ذلك، يكمل التطبيق الخارجي (المفوَّض المستهدَف) عملية تشغيل الجهاز في شبكته الخاصة.
الإعدادات
من الشاشة الرئيسية، انقر على رمز الإعدادات . هنا لديك خيارات لتحديث تفضيلات المستخدم والحصول على المساعدة ومعرفة المزيد عن التطبيق.
إشعار في نصف الشاشة
من شاشة "الإعدادات"، يمكنك اختيار إيقاف إشعارات الاكتشاف الاستباقية للأجهزة القابلة للتشغيل على Matter.
إذا كان تطبيقك يوفّر عملية اكتشاف أو تشغيل Matter خاصة به، قد تحتاج إلى إيقاف هذه الإشعارات لمنع المقاطعات. لمزيد من المعلومات، يُرجى الاطّلاع على إيقاف إشعارات الاكتشاف التي تتيح الحصول على عمولة.
أدوات مساعدة للمطوّرين
من شاشة "الإعدادات"، يمكنك أيضًا الوصول إلى أدوات المطوّرين المساعدة.
لمراجعة محتوى مستودعات Device and User Preferences DataStore في Logcat، يُرجى إكمال الخطوات التالية:
انقر على تسجيل محتوى المستودعات.
انقر على حسنًا في مربّع الحوار، ثم اطّلِع على Logcat.
التعليقات والمساعدة
لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربة التطوير باستخدام "Sample App for Matter"، يُرجى ملء نموذج استطلاع الآراء والتقييم.
إذا كنت تواجه مشاكل في Sample App for Matter، جرِّب إكمال خطوات التحقّق من بيئتك:
إذا كانت لديك أسئلة حول استخدام نموذج التطبيق أو اكتشفت خطأً في الرمز البرمجي، يمكنك إرسال المشاكل إلى Issue Tracker في مستودع GitHub:
للحصول على إرشادات رسمية من Google بشأن الأسئلة الفنية، يمكنك استخدام منتدى مطوّري الأجهزة المنزلية الذكية:
للحصول على دعم فني من المنتدى، استخدِم علامة google-smart-home على Stack Overflow: