نموذج Google Home لتطبيق Matter

نموذج تطبيق Google Home المتوافق مع معيار Matter

يستخدم 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

المتطلبات الأساسية

لست بحاجة إلى موزّع، مثل Google Nest Hub (2nd gen)، لإعداد الأجهزة والتحكّم فيها باستخدام Sample App for Matter.

تثبيت

  1. انتقل إلى قسم الإصدارات في مستودع Sample App for Matter GitHub. للحصول على أحدث إصدار، ابحث في قسم "مواد العرض" عن حزمة APK المسماة GHSAFM-version-default-debug.apk. ولا تختَر targetcommissioner.

  2. تثبيت Android Debug Bridge (adb):

    تثبيت Adb

  3. وصِّل جهاز Android بكابل USB وفعِّل ميزة نقل الملفات، ثم ثبِّت حِزمة APK:

    $ adb unroot && adb install GHSAFM-version-default-debug.apk
    

الأجهزة التي تعمل بالعمولة

عند تشغيل نموذج التطبيق للمرة الأولى، سيظهر لك مربّع حوار يتضمّن رابطًا إلى الدرس التطبيقي حول الترميز في Sample App for Matter. إذا اخترت عدم عرض هذه الرسالة مجددًا، يمكنك إعادته في أي وقت من خلال تعديل إعداداتك المفضّلة في قسم "المشرف" في التطبيق.

في الخطوات التالية، عليك إضافة جهاز Matter إلى بنية Android المحلية، بالإضافة إلى بنية تطوير محليّة لنموذج التطبيق فقط.

ما هي أقمشة Matter؟

نموذج تطبيق Google Home المتوافق مع معيار Matter

قماش Matter هو مجال مشترك للثقة بين الأجهزة في الشبكة المنزلية يتيح لها التواصل مع بعضها البعض.

قد تحتوي الأجهزة على قماش واحد أو أكثر يتوافق مع نظام أساسي أو تطبيق أو مجموعة من الأجهزة تتفاعل معًا. ويكون للأقمشة معرّف فريد، وتتشارك الأجهزة مجموعة بيانات الاعتماد نفسها ومرجع التصديق (CA). يتم تعيين بيانات الاعتماد هذه أثناء تفويض Matter.

للحصول على جهاز Matter، عليك إكمال الخطوات التالية:

  1. انقر على زر "إضافة جهاز" لبدء عملية التفويض.

    إضافة جهاز

  2. بعد ذلك، يتم نقل عنصر التحكّم إلى Google Play services الذي تم إطلاقه من مكالمة إلى Mobile SDK. لإثبات الملكية، يمكنك مسح رمز الاستجابة السريعة ضوئيًا أو النقر على استخدام رمز الإقران.

    مسح رمز الاستجابة السريعة

  3. عند اكتمال العمولة، أدخِل اسم الجهاز، ثم انقر على تم.

جهازك متصل الآن بكل من بنية Android النسيجية المحلية والنسيج المتعلق بالتطوير.

يتولّى "Play services" مهمة تنفيذ جميع مهام التنفيذ والشاشات المرتبطة بها، وذلك عند تشغيل الأجهزة. يوفّر ذلك تجربة متّسقة للمستخدم ولا حاجة إلى التعامل مع الأذونات الحسّاسة، مثل بيانات اعتماد شبكات Wi-Fi وThread.

التحكّم في الأجهزة

تنشئ بنية التطوير بيانات الاعتماد للتحكّم في أجهزة "Matter" مباشرةً من نموذج التطبيق.

من الشاشة الرئيسية، يمكنك تفعيل أو إيقاف جهازك. انقر على الجهاز للوصول إلى تفاصيل الجهاز.

تمت إضافة الجهاز

مشاركة الأجهزة

يُشار إلى مشاركة الجهاز باسم تدفق المشرفين المتعددين في مواصفات Matter. بعد إدراج الجهاز في نموذج التطبيق، يمكنك مشاركته بسهولة مع الأنظمة البيئية الأخرى.

لمشاركة جهاز Matter مع المنظومات المتكاملة الأخرى، يجب تثبيت نظام أساسي آخر على جهاز Android. وتصبح هذه المنصة الخارجية المفوَّض المستهدَف. لقد أنشأنا مثيلاً آخر من نموذج التطبيق الذي يمكنك استخدامه كمفوَّض مستهدَف.

  1. انتقل إلى قسم الإصدارات في مستودع Sample App for Matter GitHub. للحصول على أحدث إصدار، ابحث في قسم "مواد العرض" عن حزمة APK المسماة GHSAFM-version-targetcommissioner-debug.apk. ولا تختَر default.

  2. تثبيت المفوَّض المستهدَف.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
    
  3. من الشاشة الرئيسية، انقر على الجهاز لعرض معلوماته. انقر على مشاركة.

    مشاركة الجهاز

يستدعي نموذج التطبيق واجهة برمجة التطبيقات Mobile SDK Share API ويتم نقل عنصر التحكّم إلى Play services مرة أخرى.

يتم عرض ورقة المشاركة، مما يسمح لك باختيار التطبيق أو النظام الأساسي الذي تريد إقران الجهاز به. توفر لك هذه الشاشة طريقتين لمشاركة الجهاز:

  1. يدويًا من خلال رمز إعداد لتتم مشاركته مع التطبيق المفوَّض
  2. من خلال تطبيق Android محلي تم تسجيله كمفوِّض في "Matter"

يحمل تطبيق المفوّضين المستهدَفين تصنيف GHSAFM-TC. انقر على هذا المثال من التطبيق لمشاركة جهازك.

بعد ذلك، يُكمل التطبيق الخارجي (المفوّض المستهدف) عملية تكليف الجهاز بالتصميم الخاص به.

الإعدادات

من الشاشة الرئيسية، انقر على رمز الإعدادات . هنا لديك خيارات لتحديث تفضيلات المستخدم والحصول على المساعدة ومعرفة المزيد حول التطبيق.

الإعدادات

إشعار نصف الورقة

من شاشة "الإعدادات"، يمكنك اختيار إيقاف إشعارات الاستكشاف الاستباقية التي يمكن فرض عمولة عليها لأجهزة Matter.

إذا كان تطبيقك يوفّر مسار استكشاف Matter أو تشغيله، يمكنك إيقاف هذه الإشعارات لمنع انقطاع الخدمة. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على المقالة إيقاف إشعارات الاكتشاف القابلة للتكليف.

برامج الخدمات للمطوّرين

من شاشة "الإعدادات"، يمكنك أيضًا الوصول إلى الأدوات المساعدة للمطوّرين.

لمراجعة محتوى مستودعات DataStore المتعلّقة بالأجهزة وإعدادات المستخدم المفضَّلة في Logcat، يُرجى إكمال الخطوات التالية:

  1. انقر على محتوى مستودعات السجلّ.

  2. انقر على حسنًا للوصول إلى مربّع الحوار، ثم ضَع علامة في المربّع Logcat.

التعليقات والمساعدة

لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربة التطوير في Sample App for Matter، يُرجى ملء نموذج الملاحظات.

إرسال ملاحظاتك إلينا

إذا كنت تواجه مشاكل في "Sample App for Matter"، يمكنك تجربة إكمال الخطوات اللازمة للتحقّق من بيئتك:

إذا كانت لديك أسئلة حول استخدام نموذج التطبيق أو اكتشاف خطأ في التعليمات البرمجية، يمكنك إرسال المشاكل إلى أداة تتبع المشاكل في مستودع جيت هب:

للحصول على إرشادات رسمية من Google بشأن الأسئلة الفنية، يمكنك استخدام منتدى مطوّري "المنزل المزوّد بأجهزة ذكية":

للحصول على دعم فني من المنتدى، استخدِم علامة google-smart-home على موقع Stack Overflow: