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

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

مكوّن Google Home الإضافي لـ "استوديو Android"

إشعار الأمان

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

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

الميزات

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

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

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

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

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

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

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

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

أقوال مجمّعة

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

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

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

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

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

عارض سجلات 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 وعرض "تسجيل الدخول إلى السحابة الإلكترونية":

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

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

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

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

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

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

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

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

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

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

تُحمِّل القائمة المنسدلة المشروع أول 100 مشروع استنادًا إلى الفلتر الذي تستخدمه. وسيتم الاحتفاظ باختياراتك عند مغادرة Android Studio.

اختيار مشروع

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

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

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

فتح لوحة التعبيرات الاصطلاحية

هناك عدة طرق لإرسال الطلبات إلى Assistant Simulator. بعد ذلك، سنستعرض كل خيار.

كتابة الطلبات وجمع الردود

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

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

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

إعادة تشغيل الأقوال باستخدام محاكي "مساعد Google"

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

اجمَع جُمل الأفعال باستخدام محاكي "مساعد Google"

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

اجمَع جُمل الأفعال باستخدام محاكي "مساعد Google"
{
  "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 تشير إلى أنّه تم جمعها.

اختبار الألفاظ المجمّعة

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

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

استخدام الأفعال الناقصة مع "محاكي مساعد Google"

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

استخدام الأفعال الناقصة مع "محاكي مساعد Google"

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

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

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

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

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

طلب تسجيل الدخول إلى السحابة الإلكترونية

اختَر Use QL (استخدام 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، أو يمكنك استخدام أدوات اختيار التاريخ لاختيار التاريخ، ثم إدخال الوقت في حقل النص.

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

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

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

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

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

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

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

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

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

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

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

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

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

حمولة JSON للرسم البياني المنزلي

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

توسيع وتصغير ملف JSON للرسم البياني المنزلي

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

اختبارات تنفيذ الرسم البياني المنزلي

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

الاختبارات المكتملة في الرسم البياني المنزلي

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

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

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

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

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

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

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

عارض سجلّ Adb

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

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

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

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