Google Home Extension for Visual Studio Code برای توسعه‌دهندگان Google Home Platform طراحی و ایجاد شده است. این افزونه به شما امکان می‌دهد به Google Assistant Simulator، Google Cloud Logging، Home Graph Viewer، و ابزارهای دیگر دسترسی داشته باشید تا فرایند توسعه 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) را جمع‌آوری کند. گزارش‌ها را می‌توان در VS Code با فیلتر و جستجوی کلیدواژه مشاهده کرد. گزارش‌ها را می‌توان با اطلاعات اشکال‌زدایی اضافی مانند Android و نسخه برنامه بارگیری کرد و برای گزارش کردن مشکلات به Google ارسال کرد.
Cloud Logging
Cloud Logging اطلاعات اشکال‌زدایی و سنجه‌های کلیدی را ارائه می‌دهد تا به شما بینشی درباره استفاده از «کنش» شما بدهد. برای ساده کردن توسعه، Google Home Extension پیام‌های Google Cloud Logging هم‌زمان را درست در کنار کدتان درطول عیب‌یابی نشان می‌دهد. برای جزئیات بیشتر، به مشاهده Cloud Logging مراجعه کنید.
Home Graph Viewer
Home Graph Viewer اکنون مستقیماً در Google Home Extension دردسترس است تا بتوانید وضعیت دستگاه را در Home Graph خود در VS Code درستی‌سنجی کنید. برای جزئیات بیشتر، مشاهده Home Graph و اجرای آزمایش‌ها را ببینید.
نصب کردن افزونه 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 Logging را مشاهده کنید.
با Google به سیستم وارد شوید و پروژه ابری را انتخاب کنید
می‌توانید از Google Home Extension به سیستم حساب توسعه‌دهنده خود وارد شوید، و به VS Code اجازه دهید ازطرف شما با سرویس‌های Google ارتباط برقرار کند.
روی نماد Google Home در نوار فعالیت کلیک کنید تا Google Home Extension باز شود.
روی ورود به سیستم با Google کلیک کنید تا نمای ورود به سیستم در مرورگرتان راه‌اندازی شود.
حسابی را که به دستگاه‌های خانه هوشمندتان پیوند شده است انتخاب کنید.
در صفحه مجوز ورود به سیستم با Google، روی اجازه دادن کلیک کنید.
زبانه مرورگر باز می‌شود و کادر گفتگوی باز کردن Visual Studio Code نمایش داده می‌شود. برای ادامه دادن، روی Open Visual Studio Code (باز کردن Visual Studio Code) کلیک کنید.
به VS Code هدایت خواهید شد، جایی که برای اجازه دادن به «افزونه Google Home» برای باز کردن URI به اجازه شما نیاز است. برای تکمیل فرایند ورود به سیستم، روی باز کردن کلیک کنید.
پس‌از ورود به سیستم، Google Home Extension پروژه‌هایتان را بار خواهد کرد. پس‌از اتمام، روی انتخاب پروژه کلیک کنید.
در پنجره کرکره‌ای جستجو و انتخاب پروژه که ظاهر می‌شود، پروژه خانه هوشمندتان را انتخاب کنید.
نصب ابزار Android Debug Bridge (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 و اجرای آزمایش‌ها
در بخش دسترسی سریع، روی نمایشگر نمودار Home کلیک کنید تا پانل نمایشگر نمودار Home باز شود. در این پانل می‌توانید دستگاه‌های متعلق به پروژه انتخاب‌شده را پیدا کنید. همچنین می‌توانید روی اجرای آزمایش کلیک کنید تا آزمایش‌ها برای دستگاه اجرا شود.
با این کار، مجموعه آزمون در مرورگرتان راه‌اندازی می‌شود و دستگاهتان انتخاب می‌شود و برای آزمایش آماده است. روی شروع کلیک کنید و منتظر نتایج آزمایش بمانید.
پس‌از تکمیل همه آزمایش‌ها، می‌توانید جزئیات آزمایش را بررسی کنید و گزارش‌ها را مشاهده کنید.
استفاده از افزونه 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 پیدا کرده‌اید گزارش کنید
- همچنین نماد بازخورد را در صفحه منابع ارائه کرده‌ایم.