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

أدوات المطوّرين

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

لمراجعة محتوى مستودعَي Device وUser Preferences DataStore في Logcat، يُرجى إكمال الخطوات التالية:

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

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

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

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

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

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

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

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

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