ملاحظة مهمّة: يجب أن تكون مشتركًا في "برنامج الإصدار التجريبي من Matter Private" لبدء تطوير أجهزة وتطبيقات Matter من خلال وحدة تحكّم مطوّري البرامج في Google Home. تقديم طلب الآن

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

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

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

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

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

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

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

استخدامات مُجمّعة

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

Cloud Logging

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

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

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

تثبيت إضافة Google Home لرمز VS

تنزيل رمز VS وتثبيته:

تنزيل رمز VS

بعد تثبيت رمز VS، يمكنك تثبيت Google Home Extension باستخدام أحد الخيارات التالية:

تثبيت إضافة Google Home من رمز VS

إذا كنت تريد تثبيت Google Home Extension من رمز VS، أكمِل الخطوات التالية:

  1. تنزيل ملف VSIX لـ Google Home Extension. يُرجى فك ضغط الملف الذي تم تنزيله لاستخراج ملف VSIX.

    تنزيل ملف VSIX من Google Home Extension

  2. إطلاق رمز VS.

  3. حدِّد أحد خيارات التثبيت التالية:

    • انقر على الإضافات من شريط الأنشطة. في القائمة الإضافات، انقر على خيار إضافي، ثم التثبيت من VSIX....

      تثبيت إضافة Google Home من قائمة "الإضافات"
    • انقر على تشغيل أمر... من صفحة الترحيب، أو انقر على عرض، ثم لوحة الأوامر.... في لوحة الأوامر، اكتب Install from VSIX.

      تثبيت إضافة Google Home من "لوحة الأوامر"
  4. اختَر ملف VSIX الذي نزّلته وألغِ ضغطه عندما يُطلَب منك ذلك.

لمزيد من المعلومات، يمكنك الرجوع إلى وثائق Extension Marketplace في Microsoft®#.

تثبيت إضافة Google Home من سطر الأوامر

للتثبيت من سطر الأوامر، استخدِم --install-extension:

code --install-extension google-home-extension.vsix

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

بعد الانتهاء من تثبيت Google Home Extension وإعادة تحميل رمز VS، عليك إكمال الخطوات التالية قبل أن تتمكّن من استخدام Assistant Simulator وعرض Cloud Logging:

تسجيل الدخول باستخدام حساب Google

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

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

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

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

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

  5. سيتم فتح علامة تبويب متصفّح وسيتم عرض مربع حوار فتح رمز الاستوديو المرئي. انقر على فتح رمز Visual Studio للمتابعة.

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

    السماح لإضافة Google Home بفتح معرّف موارد منتظم (URI)

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

  1. بعد تسجيل الدخول، سيُحمِّل Google Home Extension مشاريعك. بعد الانتهاء، انقر على Select a project (اختيار مشروع).

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

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

عرض موارد مطوّري البرامج

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

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

استخدام أداة "مساعد Google"

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

يمكنك عرض ردود Assistant Simulator، والنقر على الزر بعد طلب البحث من أجل إعادة الإرسال.

استخدام أداة "مساعد Google"

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

مرِّر مؤشر الماوس فوق شريط القوائم GOOGLE ASSISTANT SIMULATOR، وحدِّد أحد الخيارات التالية لإعداد النصوص البرمجية:

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

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

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

لبدء إرسال كلامات مجمّعة، حدّد أحد الخيارات التالية:

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

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

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

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

استخدام Cloud Logging

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

فلترة السجلّات حسب شدّتها ووقتها

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

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

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

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

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

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

حزمة اختبار للمنازل المزوّدة بأجهزة ذكية

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

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

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

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

  • في الشريط الجانبي، انقر على رمز الملاحظات من تسجيل الدخول إلى Google.

    رمز إرسال ملاحظات
  • لقد قدّمنا أيضًا رمز ملاحظات على صفحة المراجع.