المكوّن الإضافي Google Home لـ Android Studio

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

إشعار أمان

لمنع Android Studio من تخزين الأسرار وكلمات المرور، أكمل الخطوات التالية:

1. انقر على ملف، ثم على الإعدادات....
2. في المظهر والسلوك، قم بتوسيع إعدادات النظام، ثم انقر على كلمات المرور.
3. انقر على عدم الحفظ، ونسيان كلمات المرور بعد إعادة التشغيل.

الميزات

مساعد المحاكاة

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

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

عرض تسجيل السحابة

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

يمكنك عرض سجلات الوقت الفعلي أو تحديد نطاق تاريخي.

عبارات الدفعة

Assistant Simulator ردود على عبارة واحدة ليست حتمية. على سبيل المثال، يمكن أن تكون الاستجابة أيًا من العبارات التالية:

• فهمت، تشغيل 2 ضوء.
• حسنًا، يتم الآن تشغيل مصباحَين.
• حصلت عليه، تشغيل 2 أضواء.
• حسنًا، سأقوم بتشغيل الضوءين.

لتنفيذ اختبارات مبرمَجة والتحقّق من طريقة عمل عمليات الدمج مع Google مع هذه الردود المختلفة، يمكنك إرسال عبارات مجمّعة إلى Assistant Simulator من خلال تنفيذ نصوص برمجية للعبارات. بمجرد حفظ البرنامج النصي، يمكنك جمع الاستجابات وتشغيل اختبارات متعددة على استعلاماتك.

Home Graph Viewer

يتيح لك Home Graph Viewer عرض حالة أجهزتك وتشغيل Google Home Test Suite في متصفحك.

عارض سجل جسر تصحيح أخطاء Android (adb)

أداة Adb Log Viewer هي أداة لعرض ملفات السجل وتحليلها، مثل ملفات سجلات الأجهزة وسجلات Google Home وسجلات Android.Matter

تثبيت

لتثبيت Google Home Plugin في Android Studio، اتّبِع الخطوات التالية:

1. نزِّل تطبيق Android Studio أو حدِّثه. تنزيل "استوديو Android"
2. انتقِل إلى ملف (File) > الإعدادات (Settings) (Android Studio > الإعدادات المفضّلة (Preferences) على نظام التشغيل MacOS).
3. في قسم المكونات الإضافية، انتقل إلى السوق وابحث عن google home.
4. ثبِّت الأداة وأعِد تشغيل Android Studio.

يمكنك أيضًا تنزيل المكوّن الإضافي مباشرةً من JetBrains Marketplace.

الإعداد

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

• تسجيل الدخول باستخدام حساب Google
• تحديد مشروع سحابي

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

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

1. انقر على علامة التبويب Google Home في عمود علامات التبويب الرأسية على الجانب الأيسر من نافذة Android Studio.

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

   

3. اختر الحساب المرتبط بأجهزة منزلك الذكية.

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

5. أغلق نافذة المتصفح، ثم ارجع إلى Android Studio.

يجب أن تكون قد سجّلت الدخول الآن، مع توفّر خيار تسجيل الخروج.

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

بعد تسجيل الدخول، اختَر مشروعًا من القائمة المنسدلة. لفلترة قائمة المشاريع، اكتب عبارة فلتر، مثل matter، ثم اضغط على Enter.

تقوم القائمة المنسدلة المشروع بتحميل أول 100 مشروع بناءً على الفلتر الخاص بك. سيتم الاحتفاظ باختياراتك عند الخروج من Android Studio.

للحصول على مساعدة بشأن فلاتر المشاريع، يُرجى الرجوع إلى مَعلمات طلب البحث في مرجع Google Cloud.

استخدم محاكي المساعد

لفتح Assistant Simulator في Android Studio، انقر على لوحة العبارات من لوحة Google Home Plugin.

تتوفّر عدة طرق لإرسال طلبات البحث إلى Assistant Simulator. بعد ذلك، سنتناول كل خيار.

اكتب الاستعلامات وجمع الاستجابات

للتفاعل مع Assistant Simulator، اكتب طلب البحث واضغط على مفتاح Enter.

يمكنك إعادة إرسال طلب بحث من خلال النقر على رمز إعادة الإرسال cached في نهاية طلب البحث.

بعد إرسال طلب بحث واحد أو أكثر، انقر على cached إعادة التشغيل لإعادة تنفيذ طلبات البحث والتحقّق من الردود. تتتبّع لوحة العبارات طلبات البحث والردود في ذاكرة تخزين مؤقت محفوظة. تضيف ميزة إعادة التشغيل الردود الجديدة فقط إلى ذاكرة التخزين المؤقت الداخلية هذه، ولن تكرّر طلبات البحث في كل مرة تنقر فيها على الزر.

انقر على save حفظ لحفظ طلبات البحث والردود التي أدخلتها في لوحة العبارات. سيتم تحويل تفاعلاتك إلى JSON بالتنسيق التالي:

• ask: استفسارك.
• answers: مجموعة من الاستجابات المحتملة لـ Assistant Simulator.

يمكنك تعديل ملف JSON هذا في Android Studio.

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

جمع استجابات الدفعة

من لوحة Google Home Plugin، انقر على ملف العبارات لفتح ملفات JSON المحفوظة في علامة تبويب جديدة. بالنسبة إلى اختيار المسار، يمكنك اختيار ملف أو مجلد. إذا اخترت مجلدًا، سيعمل الخياران جمع واختبار على جميع ملفات .json في هذا المجلد.

يمكنك فتح علامات تبويب متعددة للملف نفسه أو لملفات مختلفة، مثل lights وlights(1) وplug.

يعرض شريط الحالة نتيجة آخر اختبار أجريته (إذا كان ذلك منطبقًا)، ونقطة صفراء أو خضراء للإشارة إلى ما إذا تم جمع الملف، ومسار ملف .json الخاص بالجملة. بعد النقر فوقtocيجمع ، الAssistant Simulator يقوم بتشغيل استعلاماتك. سيتم إعلامك عند جمع ردّ جديد، وسيعرض شريط الحالة عدّادًا أثناء معالجة طلبات البحث.

عند اكتمال عملية الجمع، يتم تعديل شريط الحالة بعلامة اختيار خضراء أمام مسار .json، ويتم ملء ملفات العبارات بردود محتملة.

{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

في حال إيقاف عملية جمع البيانات قبل اكتمالها، لن يتم وضع علامة "تم جمع البيانات" على مسار .json.

اختبار مجموعة من العبارات

بعد جمع الردود، انقر على switch_left اختبار لإعادة تشغيل طلبات البحث والتحقّق من الردود والسجلات. عند اختبار مجموعة من العبارات، تتوقّع Assistant Simulator الردود المحفوظة في ملف JSON. إذا أظهر الاختبار ردًا لم يتم جمعه، ستتلقّى إشعارًا مشابهًا للرد التالي:

error Expected one of: "Got it, turning on 2 lights."

يشير هذا السيناريو إلى اختبار غير ناجح. بخلاف ذلك، ستنفّذ Assistant Simulator كل طلبات البحث وتعرض ردًا. تظهر علامة check في شريط الحالة إذا نجح الاختبار.

عرض Cloud Logging

لفتح علامة تبويب مشروع في نافذة أداة "سجلّات Cloud"، انقر على سجلّات Cloud من اللوحة Google Home Plugin. يمكنك فتح علامات تبويب منفصلة في "سجلّ السحابة الإلكترونية" لكل مشروع من مشاريعك.

عبارات طلب البحث

بالنسبة للمشروع المحدد، يمكنك أيضًا تصفية السجلات باستخدام حقل الاستعلام. على سبيل المثال، لفلترة السجلّات حسب الكلمة الرئيسية light، اتّبِع الخطوات التالية:

انقر على استخدام QL لاستخدام لغة طلبات البحث في التسجيل.

في ما يلي بعض الأمثلة على طلبات بحث QL لمساعدتك على البدء:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"

jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"

jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

طلبات البحث المتعلقة بالتاريخ والوقت

يُعدّ طلب البحث في السجلات حسب التاريخ اختياريًا أيضًا، ويمكن تفعيله من خلال النقر على بعد وقبل. يمكنك كتابة تنسيق التاريخ والوقت في حقل النص المقدم، على سبيل المثال 5/11/22, 12:37 PM، أو يمكنك استخدام أداة تحديد التاريخ calendar_month لتحديد التاريخ، ثم إدخال الوقت في حقل النص.

• لاختيار تاريخ بعد 5/1/22، انقر على بعد، ثم انقر على رمز التاريخ calendar_month.
• لتحديد تاريخ قبل 5/1/22، حدد قبل وانقر على أيقونة التاريخ calendar_month.
• لاختيار تاريخ بين 5/1/22 و6/30/22، انقر على قبل وبعد، ثم اختَر التاريخَين من رمز التاريخ calendar_month.

انقر على في الوقت الفعلي لجلب سجلّات المشاريع المباشرة. انقر على إيقاف لإنهاء خلاصة في الوقت الفعلي.

مستوى الخطورة

يمكنك أيضًا اختيار الحد الأدنى لدرجة الأهمية من القائمة المنسدلة.

نتائج طلب البحث

انقر على cached استرداد لإرسال مَعلمات طلب البحث.

بعد تحميل السجلّات، انقر على أي سجلّ chevron_right لتوسيع حمولة JSON الكاملة. انقر مرة أخرى chevron_left لعرض الرسالة الكاملة.

يمكنك اختياريًا كتابة كلمة رئيسية في مربّع الفلتر لتضييق نطاق نتائج السجلّ. انقر على x لإزالة الفلتر والرجوع إلى نتائج الاسترجاع الأصلية.

عرض قاعدة بيانات Home Graph وإجراء الاختبارات

لعرض قائمة بأجهزتك، اختَر مخطط المنزل من لوحة Google Home Plugin.

انقر على cached إعادة تحميل لعرض اسم الجهاز ورقم تعريف الجهاز ونوع الجهاز للأجهزة المرتبطة بالمشروع المحدّد. يمكنك فتح لوحات Google Home Graph متعددة لمشاريع منفصلة.

بمجرد تحميل أجهزتك، انقر فوق أي سجل chevron_right لتوسيع الحمولة الكاملة لـ JSON.

يمكنك أيضًا استخدام توسيع وتصغير لعرض حمولات JSON وإخفائها لأجهزتك.

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

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

عارض سجل جسر تصحيح أخطاء Android (adb)

لفتح علامة تبويب مشروع في نافذة أداة "سجلّ Adb"، انقر على الأمر سجلّ Adb في شريط أدوات المكوّن الإضافي Google Home (على اليمين). بإمكانك فتح علامات تبويب سجل Adb منفصلة لكل ملفات السجل الخاصة بك. لحذف علامة تبويب، انقر على الرمز clear.

استخدِم حقل اختيار لاختيار مكوّن تسجيل محدّد لعرضه، واستخدِم القائمة المنسدلة الخطورة لعرض الإدخالات التي تتضمّن مستوى خطورة السجلّ المطابق فقط.

بالنسبة إلى سجلّ adb الذي اخترته، يمكنك فلترة إدخالات السجلّ باستخدام حقل فلتر مع المعدِّلَين الاختياريَين مطابقة حالة الأحرف أو التعبير العادي.

بالإضافة إلى ذلك، يمكنك:

• ابحث عن إدخالات معيّنة باستخدام الحقل بحث والأمرَين البحث عن التالي (رمز arrow_downward) والبحث عن السابق (رمز arrow_upward).
• استخدِم المعدِّلَين الاختياريَين حساس لحالة الأحرف أو تعبير عادي.
• الانتقال إلى السطر للانتقال إلى سطر محدد (حسب الرقم) في السجل.

حدد مرقمة لعرض أسطر السجل مع إضافة أرقام الأسطر. اختَر Raw لعرض إدخالات السجلّ الأولية.

المراجع والملاحظات

انقر على المراجع للاطّلاع على قائمة بأدوات ومراجع المطوّرين.

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