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

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

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

  • تفعيل أجهزة Matter المادية والافتراضية Matter في شبكة Local 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.

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 إلى شبكة Local Android، بالإضافة إلى شبكة تطوير محلية للتطبيق التجريبي فقط.

ما هي شبكات Matter؟

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

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

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

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

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

    إضافة جهاز

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

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

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

جهازك الآن متصل بشبكة Local 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. انقر على هذا النموذج من تطبيق العينة لمشاركة جهازك.

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

الإعدادات

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

الإعدادات

إشعار ورقة نصفية

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

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

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

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

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

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

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

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

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

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

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

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

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

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