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

Google Home Sample App for 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 إلى Local Android fabric، بالإضافة إلى Local Android fabric خاص بالتطوير ومتاح للتطبيق النموذجي فقط.

ما هي أقمشة Matter؟

Google Home Sample App for Matter

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

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

لإعداد جهاز Matter، يُرجى إكمال الخطوات التالية:

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

    إضافة جهاز

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

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

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

أصبح جهازك الآن مرتبطًا بكل من Local Android وDevelopment.

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

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

الإعدادات

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

الإعدادات

Halfsheet notification

من شاشة "الإعدادات"، يمكنك اختيار إيقاف الإشعارات الاستباقية التي تتيح اكتشاف أجهزة 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: