نموذج 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.

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

  • جهاز Android O (الإصدار 8.1، المستوى 27 لواجهة برمجة التطبيقات) أو إصدار أحدث متاح للاختبار إلى تأكَّد من أنّ جهازك يحتوي على أحدث إصدار من "Matter". والدعم، يُرجى مراجعة التحقق من Matter وحدة الخدمات الدليل.
  • يمكنك إنشاء جهاز Matter مزوّد بإمكانات التفعيل/الإيقاف. هذا النمط يعمل نموذج التطبيق مع جهاز افتراضي وESP32.

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

تثبيت

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

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

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

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