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

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

إشعار الأمان

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

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

الميزات

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

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

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

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

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

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

الأوزان المجمّعة

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

• حَسَنًا، يَتِمُّ الْآنْ تَشْغِيلْ مِصْبَاحَيْنْ.
• حَاضِرْ، يَتِمُّ الْآنْ تَشْغِيلْ مِصْبَاحَيْنْ.
• حَسَنًا، يَتِمُّ الْآنْ تَشْغِيلْ مِصْبَاحَيْنْ.
• تَمَامْ، بِيْتِمّْ تَشْغِيلْ لَمْبِتِينْ.

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

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

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

عارض سجلّ Android Debug Bridge (adb)

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

تثبيت

لتثبيت Google Home Plugin في Android Studio، يُرجى اتّباع هذه الخطوات:

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

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

الإعداد

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

• تسجيل الدخول باستخدام حساب 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.

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

لفتح 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، انقر على ملف Utterances File لفتح ملفات 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 Logs (سجلّات السحابة الإلكترونية)، انقر على Cloud Logs (سجلات Cloud) من لوحة Google Home Plugin. يمكنك فتح علامات تبويب منفصلة في سجلّ Cloud لكل من مشاريعك.

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

بالنسبة إلى المشروع الذي اختَرته، يمكنك أيضًا فلترة السجلّات باستخدام حقل طلب البحث. على سبيل المثال، لفلترة السجلّات لكلمة رئيسية 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 لإزالة الفلتر والعودة إلى نتائج الجلب الأصلية.

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

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

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

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

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

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

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

عارض سجلّ Android Debug Bridge (adb)

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

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

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

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

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

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

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

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

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