Google Home Plugin for Android Studio برای توسعه‌دهندگان «پلاتفرم خانه هوشمند Google» طراحی و ایجاد شده است. این افزایه به شما امکان می‌دهد به Google Assistant Simulator، «گزارش‌گیری Cloud»، و ابزارهای دیگر دسترسی داشته باشید تا فرایند توسعه خانه هوشمند را ساده‌تر کنید.
اعلان امنیتی
برای جلوگیری از ذخیره کردن رمزها و گذرواژه‌ها توسط Android Studio، مراحل زیر را تکمیل کنید:
- روی فایل و سپس تنظیمات… کلیک کنید.
- در ظاهر و رفتار، تنظیمات سیستم را ازهم باز کنید، سپس روی گذرواژه‌ها کلیک کنید.
- ذخیره نشود، گذرواژه‌ها پس‌از بازراه‌اندازی فراموش شود را انتخاب کنید.
ویژگی‌ها
شبیه‌ساز «دستیار»
برای آزمایش اینکه دستگاه‌های خانه هوشمندتان با بوم‌سازگان 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
نمایشگر Home Graph به شما امکان می‌دهد وضعیت دستگاه‌هایتان را نمایش دهید و مجموعه آزمایشی Google Home را در مرورگرتان راه‌اندازی کنید.
نمایشگر گزارش «پل اشکال‌زدایی Android» (adb)
«نمایشگر گزارش adb» ابزاری برای مشاهده و تجزیه‌وتحلیل فایل‌های گزارش است، برای مثال Matter فایل‌های گزارش دستگاه، گزارش‌های Google Home، و گزارش‌های Android.
نصب
برای نصب Google Home Plugin در Android Studio، این مراحل را دنبال کنید:
- Android Studio را بارگیری یا به‌روزرسانی کنید. بارگیری «استودیو Android» مراجعه کنید
- به فایل > تنظیمات (Android Studio > تنظیمات برگزیده در MacOS) بروید.
- در بخش افزایه‌ها، به Marketplace بروید و
google homeرا جستجو کنید. - ابزار را نصب کنید و Android Studio را بازراه‌اندازی کنید.
همچنین می‌توانید افزایه را مستقیماً از بازارگاه JetBrains بارگیری کنید.
راه‌اندازی
پس‌از نصب افزایه، باید مراحل زیر را تکمیل کنید تا بتوانید از Assistant Simulator استفاده کنید و «گزارش‌گیری Cloud» را مشاهده کنید:
ورود به سیستم با Google
می‌توانید از پنل Google Home به سیستم حساب توسعه‌دهنده‌تان وارد شوید و به Android Studio اجازه دهید ازطرف شما با خدمات Google ارتباط برقرار کند.
در ستون برگه عمودی در سمت راست پنجره Android Studio، روی برگه Google Home کلیک کنید.
برای ورود به سیستم با، روی Google کلیک کنید تا مرورگرتان راه‌اندازی شود.
حسابی را که به دستگاه‌های خانه هوشمندتان پیوند شده است انتخاب کنید.
در صفحه مجوز ورود به سیستم با Google، روی اجازه دادن کلیک کنید.
پنجره مرورگر را ببندید و به Android Studio برگردید.
اکنون باید به سیستم وارد شده باشید و گزینه خروج از سیستم را داشته باشید.
انتخاب پروژه Cloud
پس‌از ورود به سیستم، یک پروژه را از منو کرکره‌ای انتخاب کنید. برای فیلتر کردن فهرست
پروژه، عبارت فیلتر را تایپ کنید، برای مثال matter، سپس
Enter را فشار دهید.
منو کرکره‌ای پروژه براساس فیلتر شما، ۱۰۰ پروژه اول را بار می‌کند. وقتی از Android Studio خارج می‌شوید، انتخاب‌هایتان حفظ می‌شود.
برای دریافت راهنمایی درباره فیلترهای پروژه، به پارامترهای پُرسمان در «مرجع Google Cloud» مراجعه کنید.
استفاده از «شبیه‌ساز دستیار»
برای باز کردن Assistant Simulator در Android Studio، از پانل Google Home Plugin، روی پانل گفته‌ها کلیک کنید.
چندین روش برای ارسال پُرسمان به Assistant Simulator وجود دارد. در ادامه، هر گزینه را بررسی خواهیم کرد.
تایپ کردن پُرسمان‌ها و جمع‌آوری پاسخ‌ها
برای تعامل با Assistant Simulator، پُرسمان خود را تایپ کنید و کلید Enter را فشار دهید.
با کلیک کردن روی نماد ارسال مجدد در انتهای پُرسمان می‌توانید پُرسمان را دوباره ارسال کنید.
پس‌از ارسال یک یا چند پُرسمان، روی پخش مجدد کلیک کنید تا پُرسمان‌هایتان را دوباره اجرا کنید و پاسخ‌هایتان را بررسی کنید. پانل بیان‌ها پرسش‌ها و پاسخ‌های شما را در حافظه نهان ذخیره‌شده پیگیری می‌کند. پخش مجدد فقط پاسخ‌های جدید را به این حافظه نهان داخلی اضافه می‌کند و هربار که روی دکمه کلیک می‌کنید، پُرسمان‌هایتان را تکرار نمی‌کند.
برای ذخیره کردن پُرسمان‌ها و پاسخ‌هایی که در پانل گفته‌ها وارد کرده‌اید، روی ذخیره کلیک کنید. تعامل‌های شما به قالب زیر به 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 را نمایش می‌دهد. پس‌از کلیک کردن روی
جمع‌آوری،
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 شما به‌عنوان جمع‌آوری‌شده علامت‌گذاری نخواهد شد.
آزمایش کردن دسته‌ای گفته‌ها
پس‌از جمع‌آوری پاسخ‌ها، روی آزمایش کلیک کنید تا پُرسمان‌هایتان را بازپخش کنید و پاسخ‌ها و گزارش‌هایتان را بررسی کنید. وقتی دسته‌های گفته‌ها را آزمایش می‌کنید، Assistant Simulator انتظار دارد پاسخ‌هایی را که در فایل JSON ذخیره شده است دریافت کند. اگر آزمایش شما پاسخی برگرداند که جمع‌آوری نشده است، اعلانی مشابه پاسخ زیر دریافت خواهید کرد:
Expected one of: "Got it, turning on
2 lights."
این سناریو نشان‌دهنده آزمایش ناموفق است. درغیراین‌صورت، Assistant Simulator هریک از پُرسمان‌های شما را اجرا می‌کند و پاسخی برمی‌گرداند. اگر آزمایش موفقیت‌آمیز باشد، علامت در نوار وضعیت نمایش داده می‌شود.
مشاهده Cloud Logging
برای باز کردن برگه پروژه در پنجره ابزار «گزارش‌های Cloud»، روی گزارش‌های Cloud از پانل Google Home Plugin کلیک کنید. می‌توانید زبانه‌های جداگانه «گزارمان Cloud» برای هریک از پروژه‌هایتان باز کنید.
عبارت‌های پُرسمان
برای پروژه انتخابی‌تان، می‌توانید گزارش‌ها را بااستفاده از فیلد پُرسمان نیز فیلتر کنید.
برای مثال، برای فیلتر کردن گزارش‌های مربوط به کلیدواژه 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، یا می‌توانید از گزینشگرهای تاریخ برای انتخاب تاریخ استفاده کنید، سپس زمان را در فیلد نوشتاری وارد کنید.
- برای انتخاب تاریخ بعداز
5/1/22، بعداز را انتخاب کنید و روی نماد تاریخ کلیک کنید. - برای انتخاب تاریخی قبل‌از
5/1/22، قبل‌از را انتخاب کنید و روی نماد تاریخ کلیک کنید. - برای انتخاب تاریخ بین
5/1/22و6/30/22، قبل‌از و بعداز را انتخاب کنید و تاریخ‌هایتان را از نماد تاریخ انتخاب کنید.
برای واکشی گزارش‌های زنده پروژه، Real time (بی‌درنگ) را انتخاب کنید. برای پایان دادن به فید بلادرنگ، روی توقف کلیک کنید.
سطح شدت
همچنین می‌توانید حداقل شدت را از منو کرکره‌ای انتخاب کنید.
نتایج پُرسمان
برای ارسال پارامترهای پُرسمان، روی واکشی کلیک کنید.
پس‌از بار شدن گزارش‌ها، روی هریک از گزارش‌ها کلیک کنید تا کل بار JSON ازهم باز شود. برای نمایش پیام کامل، دوباره کلیک کنید.
درصورت تمایل، می‌توانید کلیدواژه‌ای را در چارگوش فیلتر تایپ کنید تا نتایج گزارش
را محدود کنید. برای برداشتن فیلتر و برگشتن به نتایج واکشی اصلی، روی x کلیک کنید.
مشاهده Home Graph و اجرای آزمایش‌ها
برای فهرست کردن دستگاه‌هایتان، Home Graph را از پانل Google Home Plugin انتخاب کنید.
برای نمایش نام دستگاه، شناسه دستگاه، و نوع دستگاه برای دستگاه‌هایتان که با پروژه انتخاب‌شده مرتبط هستند، روی بازآوری کلیک کنید. می‌توانید چندین پانل Google Home Graph برای پروژه‌های جداگانه باز کنید.
پس‌از بار شدن دستگاه‌هایتان، روی هریک از گزارش‌ها کلیک کنید تا کل بار JSON ازهم باز شود.
همچنین می‌توانید از ازهم بازکردن و ازهم جمع کردن برای نمایش و پنهان کردن بار JSON برای دستگاه‌هایتان استفاده کنید.
برای راه‌اندازی مجموعه آزمایش برای دستگاهی خاص، روی آزمایش کلیک کنید. با این کار، «مجموعه آزمایش» در مرورگرتان با دستگاه انتخابی شما راه‌اندازی می‌شود و برای آزمایش آماده است. روی شروع کلیک کنید و منتظر نتایج آزمایش بمانید.
پس‌از تکمیل آزمون‌ها می‌توانید جزئیات آزمون را بررسی کنید و گزارش‌ها را مشاهده کنید.
نمایشگر گزارش «پل اشکال‌زدایی Android» (adb)
برای باز کردن برگه پروژه در پنجره ابزار «گزارمان Adb»، روی فرمان گزارمان Adb در نوارابزار افزایه Google Home (در سمت راست) کلیک کنید. می‌توانید برگه‌های جداگانه‌ای برای هریک از فایل‌های گزارش خود باز کنید. برای حذف زبانه، روی نماد کلیک کنید.
از فیلد انتخاب برای انتخاب یک عنصر گزارش‌گیری خاص برای مشاهده و از منو کرکره‌ای شدت برای نمایش فقط ورودی‌های دارای شدت گزارش مطابقت‌دار استفاده کنید.
برای گزارش adb انتخابی‌تان، می‌توانید ورودی‌های گزارش را بااستفاده از فیلد فیلتر با اصلاح‌کننده‌های اختیاری حروف‌حساس یا Regex فیلتر کنید.
علاوه‌براین، می‌توانید:
- بااستفاده از فیلد یافتن و فرمان‌های یافتن بعدی (نماد ) و یافتن قبلی (نماد )، ورودی‌های خاص را پیدا کنید.
- از اصلاح‌گرهای اختیاری حروف‌حساس یا عبارت باقاعده استفاده کنید.
- برای رفتن به خط مشخصی (براساس شماره) در گزارش، از رفتن به خط استفاده کنید.
برای مشاهده خطوط گزارش با شماره خط اضافه شده، شماره‌دار را انتخاب کنید. برای مشاهده ورودی‌های گزارش خام، خام را انتخاب کنید.
منابع و بازخورد
برای مشاهده فهرست ابزارها و منابع توسعه‌دهندگان، روی منابع کلیک کنید.
برای ارسال کردن نظرات یا بازخوردتان درباره اینکه چگونه می‌توانیم تجربه توسعه را با Google Home Plugin بهبود دهیم، روی بازخورد کلیک کنید.
