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

حزمة تطوير البرامج (SDK) للأجهزة

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

إضافة Google Home لـ VS Code

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

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

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

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

العبارات المجمّعة

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

Cloud Logging

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

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

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

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

لتثبيت Google Home Extension، اتّبِع الخطوات التالية من داخل IDE VS Code:

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

    Google Home Extension Marketplace

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

التنزيل Google Home Extension

إعداد إضافة Google Home لـ VS Code

بعد تثبيت Google Home Extension وإعادة تحميل VS Code، عليك تسجيل الدخول واختيار مشروع قبل أن تتمكّن من استخدام Assistant Simulator وعرض "تسجيلات Cloud".

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

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

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

    رمز إضافة Google Home
  2. انقر على تسجيل الدخول باستخدام حساب Google لفتح طريقة عرض تسجيل الدخول في المتصفّح.

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

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

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

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

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

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

استخدام إضافة Google Home لـ VS Code

عرض "مراجع المطوّرين"

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

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

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

لفتح Assistant Simulator في VS Code، انقر على محاكي Assistant Simulator مساعد Google في الشريط الجانبي. في مربّع الرسالة، اكتب طلب البحث ثم اضغط على Enter.

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

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

تشغيل مجموعة من الطلبات

مرِّر مؤشر الماوس فوق شريط قائمة محاكي "مساعد Google"، واختَر من بين الخيارات التالية لإعداد النصوص البرمجية:

  • انقر على لفتح نصوص الطلبات الحالية.

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

    رموز قائمة العبارات المجمّعة

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

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

    رمز تشغيل الجمل دفعةً واحدة

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

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

استخدام Cloud Logging

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

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

تقتصر السجلات تلقائيًا على 50 صفًا. إذا أراد المستخدم الاطّلاع على المزيد من السجلّات، عليه الانتقال إلى أسفل الصفحة والنقر على المزيد لعرض المزيد من السجلّات.

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

عرض Home Graph وإجراء الاختبارات

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

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

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

مجموعة اختبارات Google Home

يمكنك الاطّلاع على تفاصيل الاختبار وعرض السجلّات بعد اكتمال جميع الاختبارات.

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

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

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

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