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

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

إشعار الأمان

لمنع "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 عن طريق تشغيل النصوص البرمجية للنطق. بمجرد أن يتم يمكنك جمع الردود وإجراء اختبارات متعددة على طلبات البحث.

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

يتيح لك عارِض الرسم البياني المنزلي ستعرض حالة أجهزتك ثم شغِّل حزمة اختبار 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"

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

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

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

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

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

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

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

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