إضافة Google Home لرمز VS

حزمة SDK للجهاز

تم تصميم تطبيق Google Home Extension for Visual Studio Code وتصميمه لمطوّري Google Home Platform. تتيح لك هذه الإضافة الوصول إلى أدوات Google Assistant Simulator وGoogle Cloud Logging وعارض الرسم البياني المنزلي وغيرها من الأدوات لتبسيط عملية تطوير المنزل المزوّد بأجهزة ذكية والمسائل القانونية.

إضافة Google Home لـ VS Code

ميزات إضافة Google Home

مُحاكي "مساعد Google"

لاختبار ما إذا كانت الأجهزة المنزلية الذكية تعمل بشكل صحيح مع منظومة Google Home البيئية، يمكنك التفاعل مع Assistant Simulator في أي وقت بدون مغادرة رمز VS Code.

على غرار المحاكي المتوفّر حاليًا في "وحدة تحكّم المهام"، تتيح لك خدمة Assistant Simulator التحكّم بأجهزتك بسهولة من خلال كتابة طلبات البحث، على سبيل المثال "تشغيل الإضاءة". داخل رمز VS، يستجيب Assistant Simulator برسائل نصية بناءً على الأوامر، مثلاً "حسنًا، جارٍ تشغيل المصباح. يُرجى الاطّلاع على مقالة استخدام "محاكي مساعد Google" للحصول على مزيد من التفاصيل.

أقوال مجمّعة

لاختبار عملية دمج Google Home مع جهاز آلي، يمكنك إرسال أصوات مجمَّعة إلى محاكي مساعد Google من خلال تشغيل نص برمجي للأصوات. لمزيد من التفاصيل، يُرجى الاطّلاع على تشغيل العبارات المجمّعة.

أدوات تسجيل المسألة القانونية

يمكن لـ "أدوات تسجيل المسألة" جمع جميع السجلات المتعلقة بتصحيح أخطاء Matter، بما في ذلك سجلات Google Home app (GHA) وسجلات خدمات Google Play (GMS Core). يمكن عرض السجلات على VS Code باستخدام عامل التصفية والبحث عن الكلمات الرئيسية. يمكن تنزيل السجلات مع معلومات تصحيح الأخطاء الإضافية مثل Android وإصدار التطبيق وإرسالها إلى Google للإبلاغ عن المشاكل.

تسجيل المسألة القانونية في إضافة Google Home

Cloud Logging

توفّر حزمة Cloud Logging معلومات حول تصحيح الأخطاء ومقاييس رئيسية لمنحك إحصاءات حول استخدام الإجراء على موقعك الإلكتروني. لتبسيط عملية التطوير، يعرض Google Home Extension رسائل "تسجيل الدخول إلى Google Cloud" في الوقت الفعلي بجانب الرمز الخاص بك مباشرةً أثناء تحديد المشاكل وحلّها. يُرجى الاطِّلاع على عرض تسجيل الدخول إلى السحابة الإلكترونية لمزيد من التفاصيل.

عارض الرسم البياني المنزلي

أصبح Home Graph Viewer متاحًا الآن مباشرةً في Google Home Extension بحيث يمكنك التحقق من حالة الجهاز في قاعدة البيانات الرئيسية داخل رمز VS. اطّلع على عرض الرسم البياني المنزلي وإجراء الاختبارات لمزيد من التفاصيل.

تثبيت إضافة Google Home لـ VS Code

لتثبيت Google Home Extension، يُرجى اتّباع الخطوات التالية من داخل رمز VS:

  1. انقر على رمز الإضافات في شريط الأنشطة.
  2. ابحث عن google home، ثم انقر على تثبيت.

    سوق إضافات Google Home

يمكنك أيضًا تنزيل Google Home Extension مباشرةً من VS Code Marketplace.

تنزيل Google Home Extension

إعداد إضافة Google Home لرمز VS

بعد تثبيت Google Home Extension وإعادة تحميل رمز VS، عليك تسجيل الدخول واختيار مشروع حتى تتمكّن من استخدام Assistant Simulator والاطّلاع على تسجيل الدخول إلى السحابة الإلكترونية.

تسجيل الدخول باستخدام حساب Google واختيار مشروع على السحابة الإلكترونية

يمكنك تسجيل الدخول إلى حساب المطوّر الخاص بك من Google Home Extension، مع تفويض رمز VS للتواصل مع خدمات Google نيابةً عنك.

  1. النقر على رمز Google Home في شريط الأنشطة لفتح Google Home Extension

    رمز إضافة Google Home
  2. انقر على Sign in with Google (تسجيل الدخول باستخدام حساب Google) لبدء عرض تسجيل الدخول في المتصفِّح.

    تسجيل الدخول بحساب Google في VS Code
  3. اختَر الحساب المرتبط بالأجهزة المنزلية الذكية.

  4. في صفحة تفويض تسجيل الدخول باستخدام حساب Google، انقر على السماح.

  5. سيتم فتح علامة تبويب متصفّح وسيظهر مربع حوار فتح رمز Visual Studio. انقر على فتح Visual Studio Code للمتابعة.

    فتح مربع الحوار VS Code
  6. ستتم إعادة توجيهك إلى VS Code، حيث يُطلب منك إذنك للسماح لإضافة Google Home بفتح معرّف الموارد المنتظم (URI). انقر على فتح لإنهاء عملية تسجيل الدخول.

    السماح لإضافة Google Home بفتح معرّف الموارد المنتظم (URI)
  7. بعد تسجيل الدخول، سيحمِّل تطبيق "Google Home Extension" مشاريعك. بعد الانتهاء، انقر على اختيار مشروع.

    اختيار مشروع
  8. في النافذة المنسدلة البحث عن مشروع واختياره التي تظهر، اختَر مشروع منزلك المزوّد بأجهزة ذكية.

تثبيت أداة Android Debug Bridge (ADB)

لعرض سجلات Matter على هاتف Android، ستحتاج إلى تثبيت ADB:

  1. تثبيت ADB على جهاز الكمبيوتر.
  2. فعِّل خيارات المطوّرين وتصحيح أخطاء USB على هاتف Android.

تثبيت أدوات المنظومة على الرقاقة (SoC) لجهاز Matter

للاطّلاع على سجلات تصحيح الأخطاء من أجهزة Matter:

  1. ستصدّر المنظومة على الرقاقة (SoC) في معظم الأجهزة منافذ تسلسلية مثل /dev/ttyUSBx على نظام التشغيل Linux أو /dev/tty.SLAB_USBtoUART أو /dev/tty.usbserial على نظام التشغيل MacOS. يمكن لأداة LogViewer قراءة السجلّ من الجهاز مباشرةً.
  2. قد تتطلّب بعض أنواع المنظومة على الرقاقة (SoC)، مثل NXP أو Silicon Labs، تثبيت أدوات خارجية (مثل JLink). يمكنك الاطّلاع على الأجهزة المتوافقة للحصول على مزيد من المعلومات.

استخدام إضافة Google Home في رمز VS

عرض موارد المطوّرين

ضمن المساعدة والملاحظات، انقر على البدء والمراجع لفتح صفحة الموارد حيث يمكنك العثور على معلومات مفيدة حول تطوير البرامج باستخدام منظومة Google Home المتكاملة.

مراجع حول منظومة Google Home المتكاملة

استخدام محاكي "مساعد Google"

لفتح Assistant Simulator في رمز VS، انقر على GOOGLE ASSISTANT SIMULATOR في الشريط الجانبي. في المربع رسالة، اكتب طلب البحث واضغط على Enter.

يمكنك عرض ردود Assistant Simulator والنقر على الزر بعد الطلب لإعادة إرساله.

استخدام محاكي "مساعد Google"

تشغيل الألحان المجمّعة

ضع مؤشر الماوس فوق شريط قوائم مساعد Google، واختر من بين الخيارات التالية لإعداد النصوص البرمجية:

  • انقر على لفتح النصوص البرمجية الحالية المستخدمة في اللفظ.

  • انقر على لحفظ السجلّ في نص برمجي *.utterance.

    رموز قائمة لفظات مُجمَّعة

لبدء إرسال أصوات مجمَّعة، اختر من بين الخيارات التالية:

  • انقر على لتحديد نص نص برمجي من النافذة المنسدلة.
  • افتح ملف *.utterance مباشرةً وانقر على .

    رمز تشغيل لفظات مجمّعة

عرض التسجيل في السحابة الإلكترونية

ضمن الوصول السريع، انقر على سجلات السحابة الإلكترونية لفتح صفحة سجلات السحابة الإلكترونية حيث يمكنك العثور على السجلات التابعة لمشروعك المحدّد.

استخدام التسجيل في السحابة الإلكترونية

ويمكن للمستخدمين فلترة السجلّات استنادًا إلى درجة الخطورة والنطاق الزمني.

فلترة السجلّات حسب درجة الخطورة والوقت

بشكل تلقائي، تقتصر السجلات على 50 صفًا. إذا كان المستخدم يريد عرض المزيد من السجلات، فانتقل إلى الأسفل وانقر على المزيد لعرض المزيد من السجلات.

عرض المزيد من السجلات

عرض الرسم البياني المنزلي وإجراء الاختبارات

ضمن الوصول السريع، انقر على عارض الرسم البياني المنزلي لفتح لوحة Home Graph Viewer حيث يمكنك العثور على الأجهزة التي تنتمي إلى المشروع المحدد. يمكنك أيضًا النقر على إجراء اختبار لإجراء اختبارات على الجهاز.

عارض الرسم البياني المنزلي

سيؤدي ذلك إلى تشغيل حزمة الاختبار في متصفحك مع اختيار الجهاز وأصبح جاهزًا للاختبار. انقر على بدء وانتظِر ظهور نتائج الاختبار.

حزمة اختبار Google Home

يمكنك مراجعة تفاصيل الاختبار وعرض السجلات بعد اكتمالها.

نتائج الاختبار

استخدام إضافة Google Home لتصحيح الأخطاء في المسألة القانونية

التسجيل في Android

ضمن أدوات تسجيل الشهادة، انقر على Android السجلات لفتح صفحة Android السجلات، ثم حدد هاتف Android الذي تريد الاتصال به وابدأ في عرض السجلات.

التسجيل في Android

بعد توصيل هاتف Android، ستتمكن من الاطّلاع على السجلات سطرًا تلو الآخر. يُرجى العِلم أنّه تتم فلترة السجلات، ما يعني أنّه لا يتم عرض سوى السجلّات ذات الصلة بـ GHA و وحدة Matter Google Play services. يمكنك أيضًا ضبط درجة الخطورة لفلترة السجلات أو البحث عن الكلمة الرئيسية في السجلات.

تسجيل الدخول على Android الذي تمت فلترته

تسجيل جهاز Matter

ضمن أدوات تسجيل الطالب، انقر على سجلات الجهاز لفتح صفحة الموارد، واختر نوع المنظومة على الرقاقة أولاً:

تسجيل جهاز Matter

بعد ذلك، اختَر جهاز المسائل القانونية:

جهاز اختيار تسجيل جهاز Matter

بعد ذلك، يمكنك الحصول على جميع سجلّات الجهاز من الجهاز واستخدام فلاتر مثل درجة الخطورة والبحث للعثور على معلوماتك التي تهمّك.

التسجيل المفلتر لجهاز Matter

تنزيل جميع سجلات المسألة القانونية

ضمن الوصول السريع، انقر على تنزيل السجلات لفتح مربّع الحوار تنزيل السجلات واختَر السجلات التي سيتم تنزيلها، ثم اضغط على حسنًا.

تنزيل سجلّات المسألة القانونية

اختَر المجلد لتنزيل السجلات وانقر على حفظ:

حفظ سجلّ المسألة القانونية

بعد ذلك، سيتم حفظ السجلّات في مجلد الوجهة:

مجلد وجهة سجلّ Matter

استخرِج ملف ZIP المحفوظ، الذي سيعرض معلومات الجهاز وملفات السجلّ.

ملف ZIP لسجل المسألة القانونية

سيتضمن ملف معلومات الجهاز جميع معلومات الإصدار اللازمة لتصحيح الأخطاء.

تصحيح أخطاء سجلّ المسألة القانونية

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

لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربة التطوير باستخدام Google Home Extension، يُرجى اختيار أحد الخيارات التالية:

  • في لوحة المساعدة والملاحظات، انقر على تقديم ملاحظات لتقديم اقتراحات إلينا.
  • في لوحة المساعدة والملاحظات، انقر على الإبلاغ عن مشكلة للإبلاغ عن أي مشكلة عثرت عليها في Google Home Extension.
رمز إرسال الملاحظات
  • لقد قدّمنا أيضًا رمز ملاحظات على صفحة الموارد.