نموذج 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 codelab. إذا اخترت عدم إظهار هذه الرسالة مرة أخرى، يمكنك إعادة عرض مربّع الحوار في أي وقت من خلال تعديل إعداداتك المفضّلة في قسم "المشرف" في التطبيق.

في الخطوات التالية، ستضيف جهاز 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. انتقِل إلى قسم الإصدارات في مستودع GitHub في Sample App for Matter. وبالنسبة إلى أحدث إصدار، حدِّد في قسم "مواد العرض" ملف 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، جرِّب إكمال الخطوات التالية لإثبات صحة معلومات بيئتك:

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

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

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