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

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

يستخدم Google Home Sample App for Matter Google Home Mobile SDK لإنشاء تطبيق Android مشابه لـ Google Home app (GHA). يوفر نموذج التطبيق هذا الميزات التالية:

  • تفعيل الأجهزة المادية والافتراضية Matter في Local Android fabric
  • تفعيل الأجهزة المادية والافتراضية في development fabric
  • التحكّم في الأجهزة على development fabric، مثلاً تشغيل ضوء
  • تتيح لك ميزات المشرفين المتعدّدين مشاركة الأجهزة على development fabric مع تطبيقات أخرى، والعكس صحيح، أي يمكنك تضمين الأجهزة التي تمت مشاركتها من تطبيقات أخرى في development fabric
  • أدوات المطوّرين

يصف هذا الدليل كيفية تثبيت ملف 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. انتقِل إلى قسم Releases في مستودع GitHub .Sample App for Matter لأحدث إصدار، ابحث في قسم Assets عن ملف 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 إلى Local Android fabric، بالإضافة إلى development fabric محلية للتطبيق التجريبي فقط.

ما هي Matter fabrics؟

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

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

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

لتفعيل جهاز Matter، أكمل الخطوات التالية:

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

    إضافة جهاز

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

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

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

جهازك متصل الآن بكل من Local Android fabric وdevelopment fabric.

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

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

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

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

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

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

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

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

  1. انتقِل إلى قسم Releases في مستودع GitHub .Sample App for Matter لأحدث إصدار، ابحث في قسم Assets عن ملف 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. انقر على هذا المثيل من نموذج التطبيق لمشاركة جهازك.

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

الإعدادات

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

الإعدادات

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

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

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

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

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

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

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

  2. انقر على حسنًا في مربّع الحوار، ثم اطّلِع على Logcat.

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

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

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

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

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

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

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