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

Matter ; Home APIs

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

إشعار الأمان

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

1. انقر على ملف، ثم على الإعدادات.
2. في Appearance & Behavior (المظهر والسلوك)، وسِّع System Settings (إعدادات النظام)، ثم انقر على Passwords (كلمات المرور).
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 Viewer

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

واجهة عرض سجلّات 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. في قسم المكوّنات الإضافية، انتقِل إلى 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. في حقل تسجيل الدخول باستخدام (Sign in with)، انقر على 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 في شريط الحالة إذا كان الاختبار ناجحًا.

عرض Cloud Logging

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

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

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

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

في ما يلي بعض الأمثلة على طلبات البحث بلغة 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 وإجراء الاختبارات

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

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

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

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

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

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

واجهة عرض سجلّات Android Debug Bridge (adb)

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

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

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

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

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

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

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

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

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