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