حزمة تطوير البرامج (SDK) للجهاز
تم تصميم Google Home Extension for Visual Studio Code وإنشاءه لمطوّري برامج Google Home. توفّر لك هذه الإضافة إمكانية الوصول إلى Google Assistant Simulator وGoogle Cloud Logging ومخطّط الرسم البياني للمنزل والأدوات الأخرى لتبسيط عملية تطوير أجهزة Matter والمنازل الذكية.
ميزات إضافة Google Home
محاكي مساعد Google
لاختبار ما إذا كانت أجهزتك المنزلية الذكية تعمل بشكلٍ سليم مع المنظومة المتكاملة Google Home، يمكنك التفاعل مع Assistant Simulator في أي وقت بدون مغادرة رمز VS.
وكما هو الحال مع المحاكي المتوفّر في "وحدة تحكّم المهام"، يتيح لك Assistant Simulator التحكّم بسهولة في أجهزتك من خلال كتابة طلبات البحث، على سبيل المثال، "إضاءة المصباح". داخل تطبيق VS Code، يردّ Assistant Simulator برسالة نصية استنادًا إلى أوامرك، على سبيل المثال، " حسنًا، تشغيل الإضاءة". اطّلِع على القسم استخدام "محاكي مساعد Google" للحصول على مزيد من التفاصيل.
الأوزان المجمّعة
لاختبار عملية دمج Google Home مثل الآلي، يمكنك إرسال المحادثات المجمّعة إلى محاكي "مساعد Google" من خلال تشغيل نص برمجي خارجي. يُرجى الاطّلاع على تشغيل التجميعات للحصول على مزيد من التفاصيل.
أدوات تسجيل Matter
يمكن أن تجمع أدوات تسجيل الدخول إلى Matter جميع السجلّات ذات الصلة بتصحيح أخطاء Matter، بما في ذلك سجلّات Google Home app (GHA) وسجلّات خدمات Google Play (GMS Core). يمكن عرض السجلات على رمز VS مع عمليات البحث عن الكلمات الرئيسية والفلاتر. يمكن تنزيل السجلّات مع معلومات تصحيح أخطاء إضافية، مثل Android وإصدار التطبيق، وإرسالها إلى Google للإبلاغ عن المشاكل.
Cloud Logging
Cloud Logging: توفّر معلومات تصحيح الأخطاء والمقاييس الرئيسية لتقديم إحصاءات عن استخدام الإجراء. لتبسيط عملية التطوير، تعرض خدمة Google Home Extension رسائل Google Cloud Logging في الوقت الفعلي إلى جانب الرمز أثناء تحديد المشاكل وحلّها. يمكنك الاطِّلاع على عرض Cloud Logging للحصول على مزيد من التفاصيل.
عارض الرسم البياني للمنزل
أصبحت عارِض الرسم البياني للصفحة الرئيسية متاحة الآن في Google Home Extension مباشرةً بحيث يمكنك التحقّق من حالة الجهاز في الرسم البياني للمنزل ضمن رمز VS. يُرجى الاطّلاع على عرض الرسم البياني الرئيسي وإجراء الاختبارات لمعرفة مزيد من التفاصيل.
تثبيت إضافة Google Home لرمز VS
لتثبيت Google Home Extension، يُرجى اتّباع هذه الخطوات من داخل رمز VS:
- انقر على رمز الإضافات في شريط الأنشطة.
ابحث عن
google home، ثم انقر على تثبيت.
يمكنك أيضًا تنزيل Google Home Extension مباشرةً من VS Code Marketplace.
إعداد إضافة Google Home لرمز VS
بعد تثبيت Google Home Extension وإعادة تحميل رمز VS، عليك تسجيل الدخول واختيار مشروع قبل أن تتمكّن من استخدام Assistant Simulator وعرض Cloud Logging.
تسجيل الدخول باستخدام حساب Google واختيار مشروع على السحابة الإلكترونية
يمكنك تسجيل الدخول إلى حساب المطوّر الخاص بك من Google Home Extension، مع تفويض رمز VS للتواصل مع خدمات Google بالنيابة عنك.
انقر على رمز Google Home في شريط الأنشطة لفتح الملف Google Home Extension.
انقر على تسجيل الدخول باستخدام حساب Google لتشغيل عرض تسجيل الدخول في المتصفّح.
اختَر الحساب المرتبط بأجهزتك المنزلية الذكية.
في صفحة تفويض تسجيل الدخول باستخدام حساب Google، انقر على السماح.
سيتم فتح علامة تبويب في المتصفح ويتم عرض مربع حوار Open Code Visual Studio Code (فتح رمز الصورة المرئية في الاستوديو). انقر على فتح رمز Visual Studio للمتابعة.
ستتم إعادة توجيهك إلى رمز VS، حيث يجب الحصول على إذنك للسماح لإضافة Google Home بفتح معرّف الموارد المنتظم (URI). انقر على فتح لإنهاء عملية تسجيل الدخول.
بعد تسجيل الدخول، سيُحمِّل Google Home Extension مشاريعك. بعد الانتهاء، انقر على اختيار مشروع.
في القائمة المنسدلة البحث عن مشروع واختياره التي تظهر، اختَر مشروع المنزل الذكي.
تثبيت أداة Android Debug Bridge (ADB)
لعرض سجلّات Matter على هاتف Android، ستحتاج إلى تثبيت أداة ADB:
- ثبِّت أداة ADB على جهاز الكمبيوتر.
- فعِّل خيارات المطوّرين وتصحيح الأخطاء عبر USB على هاتفك الذي يعمل بنظام التشغيل Android.
تثبيت أدوات منظومة على رقاقة (SoC) لجهاز Matter
للاطّلاع على سجلّات تصحيح الأخطاء من Matter جهاز:
- ستُصدِّر معظم المنظومة على الرقاقة (SoC) للأجهزة ذات المنافذ التسلسلية، مثل
/dev/ttyUSBxعلى نظام التشغيل Linux أو/dev/tty.SLAB_USBtoUARTأو/dev/tty.usbserialعلى أجهزة MacOS. يمكن لـ LogViewer قراءة السجلّ من الجهاز مباشرةً. - وقد تتطلب بعض أنواع المنظومة على الرقاقة (SoC) مثل N XP أو Silicon Labs أدوات خارجية (مثل JLink). يمكنك الاطّلاع على الأجهزة المتوافقة للحصول على مزيد من المعلومات.
استخدام إضافة Google Home لرمز VS
عرض موارد المطوّر
ضمن المساعدة والملاحظات، انقر على البدء والموارد لفتح صفحة المراجع حيث يمكنك العثور على معلومات مفيدة حول تطويرك باستخدام منظومة Google Home المتكاملة.
استخدام "محاكي مساعد Google"
لفتح Assistant Simulator في رمز VS، انقر على GOOGLE ASSISTANT
SIMULATOR في الشريط الجانبي. في مربع الرسالة، اكتب طلب البحث واضغط على Enter.
يمكنك عرض ردود Assistant Simulator والنقر على الزر بعد طلب البحث لإعادة إرساله.
تشغيل الأوّل بشكل مجمّع
مرِّر مؤشر الماوس فوق شريط القوائم GOOGLE ASSISTANT SIMULATOR، واختَر من بين الخيارات التالية لإعداد النصوص البرمجية:
انقر على لفتح نصوص النصوص البرمجية الحالية.
انقر على لحفظ السجلّ في نص برمجي بتنسيق
*.utterance.
لبدء إرسال دفعات مجمّعة، حدِّد أحد الخيارات التالية:
- انقر على لاختيار نص برمجي لللفظ من النافذة المنسدلة.
افتح ملف
*.utteranceمباشرةً وانقر على .
عرض تسجيل في السحابة الإلكترونية
ضمن الوصول السريع، انقر على سجلات Cloud لفتح صفحة سجلات Cloud، حيث يمكنك العثور على السجلات التي تخص مشروعك المحدّد.
يمكن للمستخدمين فلترة السجلّات بناءً على درجة الخطورة والنطاق الزمني.
تقتصر السجلات على 50 صفًا تلقائيًا. إذا أراد المستخدم الاطّلاع على المزيد من السجلات، انتقِل للأسفل وصولاً إلى الأسفل وانقر على المزيد لعرض المزيد من السجلّات.
عرض الرسم البياني الرئيسي وإجراء الاختبارات
ضمن الوصول السريع، انقر على عارِض الرسم البياني للصفحة الرئيسية لفتح لوحة عارِض الرسم البياني للصفحة الرئيسية، حيث يمكنك العثور على الأجهزة التي تنتمي إلى المشروع المحدَّد. يمكنك أيضًا النقر على إجراء الفحص لإجراء اختبارات على الجهاز.
سيؤدي هذا إلى إطلاق مجموعة الاختبارات في متصفّحك مع اختيار جهازك والاستعداد للاختبار. انقر على البدء وانتظر نتائج الاختبار.
يمكنك الاطّلاع على تفاصيل الاختبار وعرض السجلّات بعد اكتمال جميع الاختبارات.
استخدام إضافة Google Home لتصحيح الأخطاء وفقًا لمعيار Matter
تسجيل Android
ضمن أدوات تسجيل الدخول إلى جهاز Meet، انقر على سجلات Android لفتح صفحة Android السجلّات، واختَر هاتف Android الذي تريد الاتصال به وابدأ في عرض السجلّات.
بعد ربط هاتف Android، ستتمكن من رؤية السجلات سطرًا تلو الآخر. يُرجى العِلم أنه تتم فلترة السجلّات، ما يعني أنّه يتم عرض السجلّات ذات الصلة بالوحدة GHA و وحدة Matter Google Play services. يمكنك أيضًا ضبط درجة الخطورة لفلترة السجلات أو البحث عن الكلمة الرئيسية في السجلات.
تسجيل جهاز Matter
ضمن أدوات تسجيل الدخول إلى جهاز Meet، انقر على سجلات الجهاز لفتح صفحة الموارد، اختَر نوع المنظومة على الرقاقة (SoC) أولاً:
بعد ذلك، اختَر جهاز Matter:
وبعد ذلك، يمكنك الحصول على جميع سجلات الجهاز من الجهاز واستخدام الفلاتر مثل الدرجة والبحث للعثور على المعلومات التي تهتم بها.
تنزيل جميع سجلات Matter
ضمن الوصول السريع، انقر على تنزيل السجلات لفتح مربع حوار تنزيل السجلات، واختَر السجلات التي سيتم تنزيلها واضغط على حسنًا.
اختَر المجلد لتنزيل السجلات وانقر على حفظ:
بعد ذلك، سيتم حفظ السجلّات في مجلد الوجهة:
استخرِج ملف ZIP المحفوظ، وسيعرض معلومات الجهاز وملفات السجلّ.
سيتضمن ملف معلومات الجهاز جميع معلومات الإصدار اللازمة لتصحيح الأخطاء.
إرسال ملاحظات
لإرسال آرائك وملاحظاتك حول كيفية تحسين تجربة التطوير لدى Google Home Extension، يمكنك الاختيار من بين الخيارات التالية:
- في لوحة المساعدة والملاحظات، انقر على تقديم ملاحظات لتقديم اقتراحات لنا.
- في لوحة المساعدة والملاحظات، انقر على الإبلاغ عن مشكلة للإبلاغ عن أي مشكلة واجهتها في Google Home Extension.
- وأضفنا أيضًا رمز الملاحظات في صفحة المراجع.