Google Home Extension for Visual Studio Code برای توسعه‌دهندگان «پلاتفرم Google Home» طراحی و ایجاد شده است. این افزونه به شما امکان دسترسی به Google Assistant Simulator، Google Cloud Logging، «بیننده نمودار خانه»، و ابزارهای دیگری را می‌دهد تا Matter و فرایند توسعه خانه هوشمند را ساده‌تر کنید.
ویژگی‌های افزونه Google Home
شبیه‌ساز «دستیار Google»
برای آزمایش اینکه دستگاه‌های خانه هوشمند شما با بوم‌سازگان Google Home به‌درستی کار می‌کند یا نه، می‌توانید در هر زمانی بدون خارج شدن از VS Code با Assistant Simulator تعامل داشته باشید.
Assistant Simulator به شما امکان می‌دهد با تایپ کردن پُرسمان‌هایتان، برای مثال، «چراغ را روشن کن»، به‌راحتی دستگاه‌هایتان را کنترل کنید. در VS Code، Assistant Simulator براساس فرمان‌هایتان با پیام‌های نوشتاری پاسخ می‌دهد، برای مثال، «بسیارخوب، چراغ را روشن می‌کنم.» برای جزئیات بیشتر، استفاده از شبیه‌ساز «دستیار Google» را ببینید.
گفته‌های دسته‌ای
برای آزمایش یکپارچگی Google Home خود مانند یک روبات، می‌توانید با اجرای دستورگان گفتار، گفتارهای دسته‌ای به شبیه‌ساز «دستیار Google» ارسال کنید. برای جزئیات بیشتر، اجرای دسته‌ای گفته‌ها را ببینید.
ابزارهای ثبت گزارش Matter
«ابزارهای ثبت گزارش Matter» می‌توانند همه گزارش‌های مربوط به Matter عیب‌یابی، ازجمله گزارش‌های Google Home app (GHA) و گزارش‌های خدمات Google Play (GMS Core) را جمع‌آوری کنند. گزارش‌های فعالیت را می‌توان در VS Code با جستجوی فیلتر و کلیدواژه مشاهده کرد. گزارش‌های ورود به سیستم را می‌توان با اطلاعات اشکال‌زدایی اضافی مثل Android و نسخه برنامه بارگیری کرد و برای گزارش کردن مشکلات به Google ارسال کرد.
Cloud Logging
Cloud Logging اطلاعات اشکال‌زدایی و سنجه‌های کلیدی را ارائه می‌دهد تا درباره استفاده از «کنش» خود بینش کسب کنید. برای ساده کردن توسعه، Google Home Extension درطول عیب‌یابی پیام‌های «ثبت گزارش Google Cloud» را در زمان واقعی درست در کنار کد شما نشان می‌دهد. برای جزئیات بیشتر، مشاهده گزارش‌گیری ابری را ببینید.
نمایشگر Home Graph
اکنون Home Graph Viewer مستقیماً در Google Home Extension دردسترس است تا بتوانید وضعیت دستگاه را در Home Graph خودتان در VS Code درستی‌سنجی کنید. برای جزئیات بیشتر، مشاهده «نمودار خانه» و اجرای آزمایش‌ها را ببینید.
نصب «افزونه Google Home برای VS Code»
برای نصب Google Home Extension، این مراحل را از داخل VS Code دنبال کنید:
- روی نماد افزونه‌ها در نوار فعالیت کلیک کنید.
google homeرا جستجو کنید، سپس روی نصب کلیک کنید.
همچنین می‌توانید Google Home Extension را مستقیماً از VS Code Marketplace بارگیری کنید.
راه‌اندازی «افزونه Google Home برای VS Code»
پس‌از نصب Google Home Extension و بار کردن مجدد VS Code، باید به سیستم وارد شوید و پروژه‌ای را انتخاب کنید تا بتوانید از Assistant Simulator استفاده کنید و «گزارش‌گیری Cloud» را مشاهده کنید.
با Google به سیستم وارد شوید و پروژه ابری را انتخاب کنید
می‌توانید از Google Home Extension به سیستم حساب توسعه‌دهنده‌تان وارد شوید و به VS Code اجازه دهید ازطرف شما با سرویس‌های Google ارتباط برقرار کند.
برای باز کردن، روی نماد Google Home در نوار فعالیت کلیک کنید Google Home Extension.
برای راه‌اندازی نمای ورود به سیستم در مرورگر، روی ورود به سیستم با Google کلیک کنید.
حسابی را که به دستگاه‌های خانه هوشمندتان پیوند شده است انتخاب کنید.
در صفحه مجوز ورود به سیستم با Google، روی اجازه دادن کلیک کنید.
زبانه مرورگر باز می‌شود و کادر گفتگوی Open Visual Studio Code (باز کردن کد Visual Studio) نمایش داده می‌شود. برای ادامه دادن، روی باز کردن Visual Studio Code کلیک کنید.
به VS Code هدایت خواهید شد، جایی که برای اجازه دادن به «افزونه Google Home» برای باز کردن نشانی وب، به اجازه شما نیاز است. برای تکمیل فرایند ورود به سیستم، روی باز کردن کلیک کنید.
پس‌از ورود به سیستم، Google Home Extension پروژه‌هایتان را بار می‌کند. پس‌از اتمام، روی انتخاب پروژه کلیک کنید.
در پنجره کرکره‌ای جستجو و انتخاب پروژه که ظاهر می‌شود، پروژه خانه هوشمند خود را انتخاب کنید.
نصب ابزار «پل اشکال‌زدایی Android» (ADB)
برای مشاهده گزارش‌های Matter در تلفن Android ، باید ADB را نصب کنید:
- ADB را روی رایانه‌تان نصب کنید.
- «گزینه‌های توسعه‌دهنده» و «اشکال‌زدایی USB» را در تلفن Android روشن کنید.
نصب ابزارهای SoC دستگاه Matter
برای مشاهده گزارش‌های اشکال‌زدایی از Matter دستگاه:
- بیشتر SoC دستگاه درگاه‌های سریال را مثل
/dev/ttyUSBxدر Linux یا/dev/tty.SLAB_USBtoUARTیا/dev/tty.usbserialدر MacOS صادر می‌کنند. LogViewer می‌تواند گزارش را مستقیماً از دستگاه بخواند. - برخی‌از انواع SoC مانند NXP یا Silicon Labs ممکن است نیاز داشته باشند ابزارهای خارجی (برای مثال، JLink) نصب شوند. برای اطلاعات بیشتر، دستگاه‌های پشتیبانی‌شده را ببینید.
استفاده از «افزونه Google Home برای VS Code»
مشاهده منابع توسعه‌دهندگان
در بخش راهنما و بازخورد، روی شروع به کار و منابع کلیک کنید تا صفحه منابع باز شود. در این صفحه می‌توانید اطلاعات مفیدی برای توسعه با اکوسیستم Google Home پیدا کنید.
استفاده از «شبیه‌ساز دستیار Google»
برای باز کردن Assistant Simulator در VS Code، روی شبیه‌ساز
دستیار Google در نوار کناری کلیک کنید. در چارگوش پیام، پُرسمان خود را تایپ کنید و
Enter را فشار دهید.
می‌توانید Assistant Simulator پاسخ را مشاهده کنید و پس‌از پُرسمان خود روی دکمه کلیک کنید تا آن را مجدداً ارسال کنید.
اجرای دسته‌ای گفته‌ها
موشواره را روی نوار منو شبیه‌ساز «دستیار Google» ببرید و از گزینه‌های زیر برای راه‌اندازی دستورگان انتخاب کنید:
برای باز کردن نوشته‌های گفتاری موجود، روی کلیک کنید.
برای ذخیره کردن سابقه در نوشتار
*.utterance، روی کلیک کنید.
برای شروع ارسال دسته‌های گفتار، از بین گزینه‌های زیر انتخاب کنید:
- برای انتخاب کردن دستور گفتاری از پنجره کرکره‌ای، روی کلیک کنید.
فایل
*.utteranceرا مستقیماً باز کنید و روی کلیک کنید.
مشاهده Cloud Logging
در بخش دسترسی سریع، روی گزارش‌های Cloud کلیک کنید تا صفحه گزارش‌های Cloud باز شود، جایی که می‌توانید گزارش‌های مربوط به پروژه انتخابی‌تان را پیدا کنید.
کاربران می‌توانند گزارش‌های رویداد را براساس شدت و محدوده زمانی فیلتر کنند.
به‌طور پیش‌فرض، گزارش‌ها به ۵۰ ردیف محدود می‌شوند. اگر کاربر بخواهد گزارش‌های بیشتری را مشاهده کند، به پایین پیمایش کند و روی بیشتر کلیک کند تا گزارش‌های بیشتری را مشاهده کند.
مشاهده Home Graph و اجرای آزمایش‌ها
در بخش دسترسی سریع، روی بیننده گراف خانه کلیک کنید تا پانل بیننده گراف خانه باز شود. در این پانل می‌توانید دستگاه‌های متعلق به پروژه انتخابی را پیدا کنید. همچنین می‌توانید روی اجرای آزمایش کلیک کنید تا آزمایش‌های دستگاه اجرا شود.
با این کار مجموعه آزمایش در مرورگرتان راه‌اندازی می‌شود و دستگاهتان انتخاب‌شده و برای آزمایش آماده است. روی شروع کلیک کنید و منتظر نتایج آزمایش بمانید.
پس‌از تکمیل همه آزمون‌ها می‌توانید جزئیات آزمون را بررسی کنید و گزارش‌ها را مشاهده کنید.
استفاده از «افزونه Google Home برای اشکال‌زدایی Matter»
ثبت گزارش Android
در بخش ابزارهای ثبت رویداد MATTER، روی Android گزارش‌ها کلیک کنید تا صفحه Android گزارش‌ها باز شود، Android تلفنی را که می‌خواهید به آن متصل شوید انتخاب کنید و نمایش گزارش‌ها را شروع کنید.
پس‌از اتصال تلفن Android، می‌توانید گزارش‌ها را خط به خط ببینید. توجه داشته باشید که گزارش‌ها فیلتر شده‌اند، یعنی فقط گزارش‌های مربوط به GHA و Google Play services Matter واحد نمایش داده می‌شوند. همچنین می‌توانید شدت را برای فیلتر کردن گزارش‌ها تنظیم کنید یا کلیدواژه را در گزارش‌ها جستجو کنید.
گزارش‌گیری دستگاه Matter
در بخش ابزارهای ثبت گزارش MATTER، روی گزارش‌های دستگاه کلیک کنید تا صفحه منابع باز شود، ابتدا نوع SoC را انتخاب کنید:
سپس، دستگاه Matter را انتخاب کنید:
سپس می‌توانید همه گزارش‌های دستگاه را از دستگاه دریافت کنید و از فیلترهایی مثل شدت و جستجو برای پیدا کردن اطلاعات موردنظرتان استفاده کنید.
بارگیری همه «گزارش‌های Matter»
در بخش دسترسی سریع، روی بارگیری گزارش‌ها کلیک کنید تا کادر گفتگوی بارگیری گزارش‌ها باز شود، گزارش‌های موردنظر برای بارگیری را انتخاب کنید، و تأیید را فشار دهید.
پوشه موردنظر را برای بارگیری گزارش‌ها انتخاب کنید و روی ذخیره کلیک کنید:
سپس گزارش‌ها در پوشه مقصد ذخیره خواهد شد:
فایل zip ذخیره‌شده را استخراج کنید، اطلاعات دستگاه و فایل‌های گزارش را نشان خواهد داد.
فایل اطلاعات دستگاه شامل همه اطلاعات نسخه موردنیاز برای اشکال‌زدایی مشکلات خواهد بود.
ارسال بازخورد
برای ارسال کردن نظرات یا بازخورد درباره اینکه چگونه می‌توانیم تجربه توسعه را با Google Home Extension بهبود دهیم، از گزینه‌های زیر انتخاب کنید:
- در پانل راهنما و بازخورد، روی ارائه بازخورد کلیک کنید تا پیشنهادهایتان را به ما بگویید.
- در پانل راهنما و بازخورد، روی گزارش مشکل کلیک کنید تا هر مشکلی را که در Google Home Extension پیدا کرده‌اید گزارش کنید.
- همچنین یک نماد بازخورد در صفحه منابع ارائه کرده‌ایم.