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

Matter ; واجهات برمجة تطبيقات Google Home

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

إشعار أمان

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

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

الميزات

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

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

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

عرض Cloud Logging

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

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

العبارات المجمّعة

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

• تمّ ذلك، جارٍ تشغيل مصباحَين.
• بالتأكيد، جارٍ تشغيل مصباحَين.
• تمّ ذلك، جارٍ تشغيل مصباحَين.
• حسنًا، جارٍ تشغيل مصباحَين.

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

عارض Home Graph

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

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

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

تثبيت

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

1. نزِّل Android Studio أو حدِّثه. تنزيل "استوديو Android"
2. انتقِل إلى ملف > الإعدادات (Android Studio > الإعدادات المفضّلة على نظام التشغيل MacOS).
3. في قسم المكوّنات الإضافية ، انتقِل إلى Marketplace وابحث عن 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، انقر على ملف العبارات لفتح ملفات 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 check في الـ Status Bar إذا كان الاختبار ناجحًا.

عرض Cloud Logging

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

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

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

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

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

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 وتشغيل الاختبارات

لسرد أجهزتك، انقر على Home Graph من Google Home Plugin اللوحة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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