افزونه Google Home برای اندروید استودیو

Google Home Plugin for Android Studio برای توسعه دهندگان پلتفرم Google Home طراحی و ایجاد شده است. این افزونه به شما امکان دسترسی به Google Assistant Simulator ، Cloud Logging و سایر ابزارها را می دهد تا فرآیند توسعه خانه هوشمند خود را ساده کنید.

اطلاعیه امنیتی

برای جلوگیری از ذخیره اسرار و رمزهای عبور Android Studio ، مراحل زیر را انجام دهید:

1. روی File و سپس Settings... کلیک کنید.
2. در Appearance & Behavior ، System Settings را گسترش دهید، سپس روی Passwords کلیک کنید.
3. ذخیره نشود، پس از راه اندازی مجدد، پسوردها را فراموش کنید.

ویژگی ها

دستیار شبیه ساز

برای آزمایش اینکه آیا دستگاه‌های خانه هوشمند شما به درستی با اکوسیستم Google Home کار می‌کنند یا خیر، می‌توانید در هر زمانی بدون خروج از Android Studio با Assistant Simulator تعامل داشته باشید.

Assistant Simulator شما را قادر می سازد تا به راحتی دستگاه های خود را با تایپ عبارت های جستجوی خود کنترل کنید، به عنوان مثال، "چراغ را روشن کنید". در داخل Android Studio ، Assistant Simulator با پیام‌های متنی بر اساس دستورات شما پاسخ می‌دهد، به‌عنوان مثال، «بسیار خوب، چراغ را روشن می‌کنم».

مشاهده Cloud Logging

Google Cloud Logging اطلاعات اشکال‌زدایی و معیارهای کلیدی را ارائه می‌کند تا اطلاعاتی در مورد استفاده از Action به شما بدهد. برای ساده‌سازی توسعه، Google Home Plugin پیام‌های Cloud Logging را در زمان واقعی در کنار کد شما هنگام عیب‌یابی نشان می‌دهد.

می توانید گزارش های بلادرنگ را نمایش دهید یا محدوده تاریخ را انتخاب کنید.

گفته های دسته ای

پاسخ‌های Assistant Simulator به یک گفته قطعی نیستند. به عنوان مثال، یک پاسخ می تواند یکی از عبارات زیر باشد:

• فهمیدم، 2 چراغ روشن کردم.
• مطمئناً 2 چراغ را روشن کنید.
• فهمیدم، 2 چراغ روشن کردم.
• خوب، 2 چراغ را روشن کنید.

برای اجرای آزمایش‌های خودکار و تأیید اینکه چگونه ادغام‌های Google شما با این پاسخ‌های مختلف کار می‌کنند، می‌توانید با اجرای اسکریپت‌های گفته، گفته‌های دسته‌ای را به Assistant Simulator ارسال کنید. هنگامی که یک اسکریپت ذخیره می شود، می توانید پاسخ ها را جمع آوری کنید و آزمایش های متعددی را در برابر پرس و جوهای خود اجرا کنید.

نمایشگر نمودار خانه

Home Graph Viewer به شما امکان می دهد وضعیت دستگاه های خود را نمایش دهید و مجموعه تست Google Home را در مرورگر خود راه اندازی کنید.

نمایشگر Log Debug Bridge (adb) اندروید

Adb Log Viewer ابزاری برای مشاهده و تجزیه و تحلیل فایل‌های گزارش است، برای مثال فایل‌های گزارش دستگاه Matter ، گزارش‌های Google Home، و گزارش‌های Android.

نصب کنید

برای نصب Google Home Plugin در Android Studio مراحل زیر را دنبال کنید:

1. Android Studio دانلود یا به‌روزرسانی کنید. اندروید استودیو را دانلود کنید
2. به File > Settings ( Android Studio > Preferences در MacOS) بروید.
3. در بخش Plugins ، به Marketplace بروید و google home را جستجو کنید.
4. ابزار را نصب کنید و Android Studio مجددا راه اندازی کنید.

همچنین می‌توانید این افزونه را مستقیماً از JetBrains Marketplace دانلود کنید.

راه اندازی

پس از نصب افزونه، قبل از استفاده از Assistant Simulator و مشاهده Cloud Logging، باید مراحل زیر را انجام دهید:

• با گوگل وارد شوید
• یک پروژه ابری را انتخاب کنید

با گوگل وارد شوید

می‌توانید از پانل Google Home وارد حساب توسعه‌دهنده خود شوید و به Android Studio اجازه می‌دهید از طرف شما با سرویس‌های Google ارتباط برقرار کند.

1. روی برگه Google Home در ستون برگه عمودی در سمت چپ پنجره Android Studio کلیک کنید.

2. برای ورود به سیستم ، روی Google کلیک کنید تا مرورگر شما راه اندازی شود.

   

3. حسابی را انتخاب کنید که با دستگاه های خانه هوشمند شما مرتبط است.

4. در صفحه مجوز ورود به سیستم با Google ، روی Allow کلیک کنید.

5. پنجره مرورگر را ببندید و به Android Studio بازگردید.

اکنون باید با گزینه خروج از سیستم وارد شوید.

یک پروژه Cloud را انتخاب کنید

پس از ورود به سیستم، یک پروژه را از منوی کشویی انتخاب کنید. برای فیلتر کردن لیست پروژه خود، عبارت Filter را تایپ کنید، به عنوان مثال matter ، سپس Enter فشار دهید.

کشویی Project 100 پروژه اول را بر اساس فیلتر شما بارگیری می کند. وقتی از Android Studio خارج می‌شوید، انتخاب‌های شما حفظ می‌شوند.

برای راهنمایی در مورد فیلترهای پروژه، به پارامترهای Query در Google Cloud Reference مراجعه کنید.

از Assistant Simulator استفاده کنید

برای باز کردن Assistant Simulator در Android Studio ، روی پانل گفته‌ها از پانل Google Home Plugin کلیک کنید.

راه های مختلفی برای ارسال پرس و جو به Assistant Simulator وجود دارد. در مرحله بعد، به هر گزینه می پردازیم.

پرس و جوها را تایپ کنید و پاسخ ها را جمع آوری کنید

برای تعامل با Assistant Simulator ، درخواست خود را تایپ کرده و Enter را فشار دهید.

می‌توانید با کلیک کردن روی نماد ارسال مجدد cached در انتهای درخواست خود، یک پرس و جو را دوباره ارسال کنید.

پس از ارسال یک یا چند پرس و جو، روی Replay cached کلیک کنید تا درخواست های خود را مجددا اجرا کنید و پاسخ های خود را بررسی کنید. پانل گفته ها پرس و جوها و پاسخ های شما را در یک کش ذخیره شده پیگیری می کند. Replay فقط پاسخ‌های جدیدی را به این حافظه پنهان داخلی اضافه می‌کند و هر بار که روی دکمه کلیک می‌کنید، درخواست‌های شما تکراری نمی‌شود.

برای ذخیره پرس و جوها و پاسخ هایی که در پانل گفته ها وارد کرده اید، روی save 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 ، روی Utterances File کلیک کنید تا فایل های JSON ذخیره شده خود را در یک برگه جدید باز کنید. برای انتخاب مسیر ، می توانید یک فایل یا یک پوشه را انتخاب کنید. اگر پوشه‌ای را انتخاب کنید، Collect and Test روی تمام گفته‌های فایل‌های .json . در آن پوشه کار می‌کند.

می‌توانید چندین برگه را برای یک فایل یا فایل‌های مختلف باز کنید، برای مثال lights ، lights(1) و plug .

نوار وضعیت نتیجه آخرین آزمایش شما (در صورت وجود)، یک نقطه زرد یا سبز برای نشان دادن اینکه آیا فایل جمع آوری شده است و مسیر فایل .json را نشان می دهد. پس از اینکه روی toc Collect کلیک کردید، Assistant Simulator پرس و جوهای شما را اجرا می کند. هنگامی که یک پاسخ جدید جمع آوری می شود، به شما اطلاع داده می شود و نوار وضعیت یک شمارنده را در حالی که درخواست های شما در حال پردازش است نمایش می دهد.

هنگامی که Collect کامل شد، نوار وضعیت با یک علامت سبز در جلوی مسیر .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 Test کلیک کنید تا پرسش های خود را مجدداً پخش کنید و پاسخ ها و گزارش های خود را بررسی کنید. هنگامی که عبارات دسته‌ای را آزمایش می‌کنید، 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 جداگانه را برای هر یک از پروژه های خود باز کنید.

شرایط استعلام

برای پروژه انتخابی خود، می‌توانید گزارش‌ها را با استفاده از قسمت Query فیلتر کنید. به عنوان مثال، برای فیلتر کردن گزارش‌ها برای کلمه کلیدی 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"

سوالات مربوط به تاریخ و زمان

جستجوی گزارش‌ها بر اساس تاریخ نیز اختیاری است و می‌توان آن را با کلیک کردن بر روی After and Before فعال کرد. می توانید قالب تاریخ و زمان خود را در فیلد نوشتاری ارائه شده تایپ کنید، برای مثال 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 را از پانل Google Home Plugin انتخاب کنید.

روی Refresh cached کلیک کنید تا نام دستگاه ، شناسه دستگاه و نوع دستگاه برای دستگاه های مرتبط با پروژه انتخابی شما نمایش داده شود. می‌توانید چندین پنل Google Home Graph را برای پروژه‌های جداگانه باز کنید.

پس از بارگیری دستگاه‌های شما، روی هر رکورد chevron_right کلیک کنید تا بار کامل JSON گسترش یابد.

همچنین می توانید از Expand and Collapse برای نمایش و پنهان کردن بارهای JSON برای دستگاه های خود استفاده کنید.

برای راه‌اندازی مجموعه تست برای یک دستگاه خاص، روی تست کلیک کنید. با این کار مجموعه تست در مرورگر شما راه اندازی می شود که دستگاه شما انتخاب شده و آماده آزمایش است. روی Start کلیک کنید و منتظر نتایج آزمایش باشید.

شما می توانید جزئیات آزمون را بررسی کنید و پس از اتمام تست ها، گزارش ها را مشاهده کنید.

نمایشگر Log Debug Bridge (adb) اندروید

برای باز کردن یک برگه پروژه در پنجره ابزار Adb Log، روی دستور Adb Log در نوار ابزار افزونه Google Home (در سمت چپ) کلیک کنید. شما می توانید برگه های Adb Log جداگانه را برای هر یک از فایل های گزارش خود باز کنید. برای حذف یک برگه، روی نماد clear کلیک کنید.

از فیلد Select برای انتخاب یک جزء گزارش‌گیری خاص برای مشاهده و از منوی کشویی Severity فقط برای نمایش ورودی‌هایی با شدت گزارش منطبق استفاده کنید.

برای لاگ adb انتخابی خود، می‌توانید ورودی‌های گزارش را با استفاده از فیلد فیلتر با اصلاح‌کننده‌های اختیاری حساس به حروف بزرگ یا Regex فیلتر کنید.

علاوه بر این، شما می توانید:

• ورودی های خاص را با استفاده از فیلد Find و دستورات Find Next (icon arrow_downward ) و Find Previous ( arrow_upward icon) پیدا کنید.
• از اصلاح کننده های اختیاری حساس به حروف بزرگ یا Regex استفاده کنید.
• پرش به خط برای پرش به یک خط مشخص (بر اساس شماره) در گزارش.

برای مشاهده خطوط گزارش با شماره خطوط اضافه شده، Numbered را انتخاب کنید. برای مشاهده ورودی‌های گزارش خام، خام را انتخاب کنید.

منابع و بازخورد

برای فهرستی از ابزارها و منابع توسعه دهنده، روی Resources کلیک کنید.

برای ارسال نظرات یا بازخورد خود در مورد اینکه چگونه می‌توانیم تجربه توسعه را با Google Home Plugin بهبود دهیم، روی بازخورد کلیک کنید.