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

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

إشعار أمان

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

1. انقر على ملف، ثم على الإعدادات....
2. في قسم المظهر السلوك، وسِّع إعدادات النظام (System Settings)، ثم انقر على كلمات المرور:
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 عن طريق تشغيل النصوص البرمجية للنطق. بعد حفظ نص برمجي، يمكنك جمع الردود وإجراء اختبارات متعددة على طلبات البحث.

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

يتيح لك عارض Home Graph عرض حالة أجهزتك وبدء استخدام مجموعة اختبارات 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. في قسم Plugins (المكوّنات الإضافية)، انتقِل إلى Marketplace (السوق) وابحث عن google home
4. ثبِّت الأداة وأعِد تشغيل Android Studio.

يمكنك أيضًا تنزيل المكون الإضافي مباشرة من سوق JetBrains

ضبط إعدادات الجهاز

بعد تثبيت المكوّن الإضافي، عليك يُرجى إكمال الخطوات التالية قبل أن تتمكّن من استخدام 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 Reference.

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

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

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

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

للتفاعل مع Assistant Simulator، اكتب طلب بحثك واضغط على أدخِل.

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

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

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

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

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

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

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

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

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

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

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