المسألة القانونية Cloud-to-cloud حزمة SDK للمنزل المحلي حزمة تطوير البرامج (SDK) للجهاز
تم تصميم خدمة Google Home Extension for Visual Studio Code وإنشاؤها لمطوّري برامج Google Home Platform. تتيح لك هذه الإضافة الوصول إلى "Google Assistant Simulator" و"Google Cloud Logging" و"عارِض الرسم البياني المنزلي" وأدوات أخرى لتبسيط عملية تطوير المنزل المزوّد بأجهزة ذكية آليًا.
ميزات إضافة Google Home
مُحاكي "مساعد Google"
لاختبار ما إذا كانت أجهزتك المنزلية الذكية تعمل بشكل سليم مع منظومة Google Home المتكاملة، يمكنك التفاعل مع Assistant Simulator في أي وقت بدون مغادرة رمز VS.
على غرار المحاكي الحالي في "وحدة تحكّم الإجراءات"، يتيح لك Assistant Simulator التحكّم بسهولة في الأجهزة من خلال كتابة طلبات البحث، على سبيل المثال "إضاءة المصباح". داخل رمز VS، يستجيب Assistant Simulator بإرسال رسائل نصية بناءً على الطلبات، على سبيل المثال "حسنا، أريد إضاءة المصباح". يُرجى الاطّلاع على قسم استخدام "محاكي مساعد Google" للحصول على مزيد من التفاصيل.
الخطابات المجمّعة
لاختبار دمج Google Home مع نظام آلي، يمكنك إرسال أصوات مجمّعة إلى محاكي مساعد Google عن طريق تشغيل نص لفظي. راجِع تشغيل التصريحات المجمّعة للحصول على مزيد من التفاصيل.
أدوات تسجيل المسألة القانونية
يمكن لأدوات تسجيل معيار Matter جمع جميع السجلّات ذات الصلة بتصحيح أخطاء Matter، بما في ذلك سجلّات Google Home app (GHA) وسجلّات "خدمات Google Play" (GMS Core). يمكن عرض السجلات على VS Code باستخدام عوامل التصفية والبحث عن الكلمات الرئيسية. يمكن تنزيل السجلات مع معلومات تصحيح أخطاء إضافية مثل Android وإصدار التطبيق وإرسالها إلى Google للإبلاغ عن المشاكل.
Cloud Logging
توفِّر Cloud Logging معلومات عن تصحيح الأخطاء ومقاييس رئيسية لمنحك إحصاءات حول استخدام "الإجراء". لتبسيط التطوير، يعرض Google Home Extension رسائل "تسجيل الدخول إلى Google Cloud" في الوقت الفعلي بجانب الرمز الخاص بك مباشرةً أثناء تحديد المشاكل وحلّها. يُرجى الاطِّلاع على عرض تسجيل الدخول إلى السحابة الإلكترونية لمزيد من التفاصيل.
عارض الرسم البياني المنزلي
يتوفر Home Graph Viewer الآن مباشرةً في Google Home Extension بحيث يمكنك التحقق من حالة الجهاز في الرسم البياني Home داخل رمز VS. يمكنك الاطّلاع على عرض "الرسم البياني المنزلي" وإجراء الاختبارات لمزيد من التفاصيل.
تثبيت إضافة Google Home لرمز VS
لتثبيت Google Home Extension، يُرجى اتّباع الخطوات التالية من داخل رمز VS:
- انقر على رمز الإضافات في شريط الأنشطة.
ابحث عن
google home
، ثم انقر على تثبيت.
يمكنك أيضًا تنزيل Google Home Extension مباشرة من VS Code Marketplace.
إعداد إضافة Google Home لرمز VS
بعد تثبيت Google Home Extension وإعادة تحميل VS Code، عليك تسجيل الدخول واختيار مشروع حتى تتمكّن من استخدام Assistant Simulator والاطّلاع على Cloud Logging.
تسجيل الدخول باستخدام حساب Google واختيار مشروع على السحابة الإلكترونية
يمكنك تسجيل الدخول إلى حساب المطوّر الخاص بك من Google Home Extension، وتفويض VS Code للتواصل مع خدمات Google نيابةً عنك.
النقر على رمز Google Home في شريط الأنشطة لفتح Google Home Extension
انقر على تسجيل الدخول باستخدام حساب Google لتشغيل عرض تسجيل الدخول في المتصفّح.
اختَر الحساب المرتبط بأجهزتك المنزلية الذكية.
في صفحة تفويض تسجيل الدخول باستخدام حساب Google، انقر على السماح.
سيتم فتح علامة تبويب في متصفّح وسيظهر مربّع حوار Open Visual Studio Code (فتح Visual Studio Code). انقر على Open Visual Studio Code للمتابعة.
ستتم إعادة توجيهك إلى VS Code، حيث يكون إذنك مطلوبًا للسماح لإضافة Google Home بفتح معرّف الموارد المنتظم (URI). انقر على Open (فتح) لإنهاء عملية تسجيل الدخول.
بعد تسجيل الدخول، سيتم تحميل مشاريعك من خلال تطبيق "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)، مثل NXP أو Silicon Labs أدوات خارجية (مثل JLink) ليتم تثبيتها. يمكنك الاطّلاع على الأجهزة المتوافقة للحصول على مزيد من المعلومات.
استخدام إضافة Google Home لرمز VS
عرض موارد المطوّرين
ضمن المساعدة والملاحظات، انقر على البدء والمراجع لفتح صفحة الموارد التي يمكنك من خلالها العثور على معلومات مفيدة حول عملية تطوير البرامج باستخدام منظومة Google Home المتكاملة.
استخدام مُحاكي مساعد Google
لفتح Assistant Simulator في VS Code، انقر على GOOGLE ASSISTANT
SIMULATOR على الشريط الجانبي. في مربع الرسالة، اكتب طلب البحث واضغط على Enter
.
يمكنك عرض ردود Assistant Simulator، والنقر على الزر بعد طلب البحث من أجل إعادة إرساله.
تشغيل الخطابات المجمّعة
مرر الماوس فوق شريط قوائم مساعد Google SIM، واختر من بين الخيارات التالية لإعداد النصوص البرمجية:
انقر على
لفتح نصوص النصوص البرمجية الحالية.انقر على
لحفظ السجلّ في نص برمجي*.utterance
لبدء إرسال أصوات مجمَّعة، اختر من بين الخيارات التالية:
- انقر على لتحديد نص نصي من نافذة القائمة المنسدلة.
افتح ملف
*.utterance
مباشرةً وانقر على .
عرض التسجيل في السحابة الإلكترونية
ضمن الوصول السريع، انقر على سجلّات السحابة الإلكترونية لفتح صفحة سجلّات السحابة الإلكترونية حيث يمكنك العثور على السجلّات التي تنتمي إلى المشروع المحدّد.
يمكن للمستخدمين فلترة السجلّات استنادًا إلى درجة الخطورة والنطاق الزمني.
تقتصر السجلات تلقائيًا على 50 صفًا. إذا أراد المستخدم عرض المزيد من السجلّات، انتقِل إلى أسفل الصفحة وانقر على المزيد لعرض المزيد من السجلّات.
عرض الرسم البياني المنزلي وإجراء الاختبارات
ضمن الوصول السريع، انقر على عارض الرسم البياني المنزلي لفتح لوحة عارِض الرسم البياني Home التي يمكنك من خلالها العثور على الأجهزة التابعة للمشروع المحدّد. يمكنك أيضًا النقر على إجراء اختبار لإجراء اختبارات للجهاز.
سيؤدي ذلك إلى تشغيل مجموعة البرامج التجريبية في متصفحك مع تحديد جهازك وجاهز للاختبار. انقر على بدء وانتظِر ظهور نتائج الاختبار.
يمكنك الاطّلاع على تفاصيل الاختبار وعرض السجلات بعد اكتمال جميع الاختبارات.
استخدام إضافة Google Home لتصحيح أخطاء المسألة القانونية
تسجيل الدخول إلى Android
ضمن أدوات تسجيل مادة العرض، انقر على Android السجلات لفتح صفحة Android السجلات، واختَر هاتف Android الذي تريد الاتصال به وابدأ في عرض السجلات.
بعد توصيل هاتف Android، ستتمكّن من الاطّلاع على السجلات سطرًا تلو الآخر. يُرجى العِلم أنّه تتم فلترة السجلّات، ما يعني أنّه لن يتم عرض سوى السجلّات ذات الصلة بـ GHA و وحدة Matter Google Play services. يمكنك أيضًا ضبط درجة الخطورة لفلترة السجلّات أو البحث عن الكلمة الرئيسية في السجلّات.
تسجيل جهاز Matter
ضمن أدوات تسجيل مادة العرض، انقر على سجلات الجهاز لفتح صفحة الموارد، ثم اختَر نوع المنظومة على الرقاقة (SoC) أولاً:
بعد ذلك، اختَر جهاز المسألة القانونية:
يمكنك بعد ذلك الحصول على جميع سجلّات الجهاز من الجهاز واستخدام الفلاتر مثل درجة الخطورة والبحث للعثور على المعلومات التي تهمّك.
تنزيل كل سجلات المسألة القانونية
ضمن الوصول السريع، انقر على تنزيل السجلات لفتح مربّع الحوار تنزيل السجلات، واختَر السجلات التي سيتم تنزيلها، ثم اضغط على حسنًا.
اختَر المجلد المطلوب تنزيل السجلات وانقر على حفظ:
بعد ذلك، سيتم حفظ السجلّات في مجلد الوجهة:
استخرِج ملف ZIP المحفوظ، سيعرض معلومات الجهاز وملفات السجلّ.
سيتضمن ملف معلومات الجهاز جميع معلومات الإصدار اللازمة لتصحيح الأخطاء.
إرسال الملاحظات
لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربة التطوير باستخدام Google Home Extension، يُرجى تحديد أحد الخيارات التالية:
- في لوحة المساعدة والملاحظات، انقر على تقديم ملاحظات لتقديم اقتراحات.
- في لوحة المساعدة والملاحظات، انقر على الإبلاغ عن مشكلة للإبلاغ عن أي مشكلة واجهتك في Google Home Extension.
- لقد قدّمنا أيضًا رمز ملاحظات في صفحة الموارد.