افزایه Google Home برای «استودیو Android»

Matter ؛ Home APIs

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

اعلان امنیتی

برای جلوگیری از ذخیره شدن اطلاعات محرمانه و گذرواژه‌ها توسط Android Studio، مراحل زیر را تکمیل کنید:

1. روی فایل، سپس تنظیمات... کلیک کنید.
2. در ظاهر و رفتار، تنظیمات سیستم را ازهم باز کنید، سپس روی گذرواژه‌ها کلیک کنید.
3. ذخیره نشود، گذرواژه‌ها پس‌از بازراه‌اندازی فراموش شود را انتخاب کنید.

ویژگی‌ها

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

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

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 (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. برای ورود به سیستم با، روی Google کلیک کنید تا مرورگرتان راه‌اندازی شود.

   

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

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

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

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

انتخاب پروژه Cloud

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

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

برای دریافت راهنمایی درباره فیلترهای پروژه، به پارامترهای پُرسمان در «مرجع Google Cloud» مراجعه کنید.

استفاده از «شبیه‌ساز دستیار»

برای باز کردن 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 را برای استفاده از زبان پُرسمان ثبت گزارش انتخاب کنید.

در اینجا چند نمونه از پُرسمان‌های 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 (adb)

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

از فیلد انتخاب برای انتخاب مؤلفه ثبت گزارش خاصی برای مشاهده و از منو کرکره‌ای شدت برای نمایش ورودی‌های دارای شدت گزارش منطبق استفاده کنید.

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

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

• بااستفاده از فیلد یافتن و فرمان‌های یافتن بعدی (نماد arrow_downward) و یافتن قبلی (نماد arrow_upward)، ورودی‌های خاصی را پیدا کنید.
• از اصلاح‌کننده‌های اختیاری حروف‌حساس یا عبارت باقاعده استفاده کنید.
• پرش به خط برای پرش به خط مشخص‌شده (با شماره) در گزارش.

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

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

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

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