نموذج 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 المادية والافتراضية في Local Android 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. انتقِل إلى قسم الإصدارات في مستودع 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 الدرس العملي. إذا اخترت عدم إظهار هذه الرسالة مجددًا، يمكنك إعادة ظهور مربّع الحوار في أي وقت من خلال تعديل إعداداتك المفضّلة في قسم "المشرف" بالتطبيق.

في الخطوات التالية، ستضيف جهاز 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، جرِّب إكمال الخطوات التالية لتأكيد بيئتك:

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

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

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