برنامه افزودنی Google Home برای VS Code

SDK دستگاه

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

برنامه افزودنی Google Home برای VS Code

ویژگی های برنامه افزودنی Google Home

شبیه ساز دستیار گوگل

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

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

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

برای آزمایش ادغام Google Home خود مانند خودکار، می‌توانید با اجرای یک اسکریپت گفته، گفته‌های دسته‌ای را به شبیه‌ساز دستیار Google ارسال کنید. برای جزئیات بیشتر به Run Batch Outterances مراجعه کنید.

ابزارهای ثبت موضوع

Matter Logging Tools می‌تواند همه گزارش‌های مربوط به اشکال‌زدایی Matter را جمع‌آوری کند، از جمله گزارش‌های Google Home app (GHA) و گزارش‌های خدمات Google Play (GMS Core). سیاهههای مربوط را می توان در VS Code با جستجوهای فیلتر و کلمات کلیدی مشاهده کرد. گزارش‌ها را می‌توان با اطلاعات رفع اشکال اضافی مانند نسخه Android و برنامه دانلود کرد و برای گزارش مشکلات به Google ارسال کرد.

Google Home Extension Matter Logging

ثبت ابر

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

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

Home Graph Viewer اکنون مستقیماً در Google Home Extension در دسترس است تا بتوانید وضعیت دستگاه را در Home Graph خود در VS Code تأیید کنید. برای جزئیات بیشتر به مشاهده نمودار صفحه اصلی و اجرای تست ها مراجعه کنید.

افزونه Google Home را برای VS Code نصب کنید

برای نصب Google Home Extension ، این مراحل را از داخل VS Code دنبال کنید:

  1. روی نماد Extensions در نوار فعالیت کلیک کنید.
  2. google home را جستجو کنید، سپس روی Install کلیک کنید.

    Google Home Extension Marketplace

همچنین می‌توانید Google Home Extension مستقیماً از VS Code Marketplace دانلود کنید.

Google Home Extension دانلود کنید

Google Home Extension را برای VS Code تنظیم کنید

پس از نصب Google Home Extension و بارگیری مجدد کد VS، قبل از استفاده از Assistant Simulator و مشاهده Cloud Logging، باید وارد سیستم شوید و پروژه ای را انتخاب کنید.

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

می‌توانید از Google Home Extension وارد حساب توسعه‌دهنده خود شوید و به VS Code اجازه می‌دهید از طرف شما با سرویس‌های Google ارتباط برقرار کند.

  1. روی نماد Google Home در نوار فعالیت کلیک کنید تا Google Home Extension باز شود.

    نماد برنامه افزودنی Google Home
  2. روی Sign in with Google کلیک کنید تا نمای ورود به سیستم در مرورگر شما اجرا شود.

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

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

  5. یک تب مرورگر باز می شود و یک کادر گفتگوی Open Visual Studio Code نمایش داده می شود. برای ادامه روی Open Visual Studio Code کلیک کنید.

    کادر گفتگوی VS Code را باز کنید
  6. شما به VS Code هدایت خواهید شد، جایی که اجازه شما برای اجازه دادن به Google Home Extension برای باز کردن یک URI لازم است. روی Open کلیک کنید تا فرآیند ورود به سیستم به پایان برسد.

    به Google Home Extension اجازه دهید یک URI را باز کند
  7. پس از ورود به سیستم، Google Home Extension پروژه های شما را بارگیری می کند. پس از انجام، روی Select a project کلیک کنید.

    یک پروژه را انتخاب کنید
  8. در پنجره کشویی جستجو و انتخاب پروژه که ظاهر می شود، پروژه خانه هوشمند خود را انتخاب کنید.

ابزار Android Debug Bridge (ADB) را نصب کنید

برای مشاهده گزارش‌های Matter در تلفن Android ، باید ADB را نصب کنید:

  1. ADB را روی رایانه خود نصب کنید.
  2. Developer Options و USB Debugging را در گوشی اندروید خود روشن کنید .

Matter Device SoC Tools را نصب کنید

برای مشاهده گزارش‌های اشکال‌زدایی از دستگاه‌های Matter :

  1. اکثر SoC دستگاه ها پورت های سریالی مانند /dev/ttyUSBx را در لینوکس یا /dev/tty.SLAB_USBtoUART یا /dev/tty.usbserial در MacOS صادر می کنند. LogViewer می تواند گزارش را مستقیماً از دستگاه بخواند.
  2. برخی از انواع SoC مانند NXP یا Silicon Labs ممکن است نیاز به ابزارهای خارجی (به عنوان مثال، JLink) برای نصب داشته باشند. برای اطلاعات بیشتر به دستگاه های پشتیبانی شده مراجعه کنید.

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

مشاهده منابع توسعه دهنده

در بخش HELP AND FEEDBACK ، روی شروع و منابع کلیک کنید تا صفحه منابع باز شود، جایی که می توانید اطلاعات مفیدی برای توسعه خود با اکوسیستم Google Home پیدا کنید.

منابع برای اکوسیستم خانه Google

از شبیه ساز دستیار گوگل استفاده کنید

برای باز کردن Assistant Simulator در VS Code، روی GOOGLE ASSISTANT SIMULATOR در نوار کناری کلیک کنید. در کادر پیام ، درخواست خود را تایپ کرده و Enter فشار دهید.

می‌توانید پاسخ‌های Assistant Simulator را مشاهده کنید و روی دکمه بعد از درخواست خود کلیک کنید تا دوباره آن را ارسال کنید .

از شبیه ساز دستیار گوگل استفاده کنید

Batch Outterances را اجرا کنید

ماوس را روی نوار منوی GOOGLE ASSISTANT SIMULATOR قرار دهید و از میان گزینه های زیر برای تنظیم اسکریپت ها انتخاب کنید:

  • روی کلیک کنید تا اسکریپت های گفته موجود باز شود.

  • روی کلیک کنید تا تاریخچه در اسکریپت *.utterance ذخیره شود.

    آیکون های منوی گفته های دسته ای

برای شروع ارسال عبارات دسته ای، از گزینه های زیر انتخاب کنید:

  • روی کلیک کنید تا یک اسکریپت گفته از پنجره کشویی انتخاب شود.
  • مستقیماً یک فایل *.utterance را باز کنید و روی کلیک کنید.

    آیکون اجرای عبارات دسته ای

مشاهده Cloud Logging

در زیر دسترسی سریع ، روی Cloud Logs کلیک کنید تا صفحه Cloud Logs باز شود، جایی که می توانید گزارش های متعلق به پروژه انتخابی خود را پیدا کنید.

از Cloud Logging استفاده کنید

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

سیاهههای مربوط را بر اساس شدت و زمان فیلتر کنید

به طور پیش فرض، لاگ ها به 50 ردیف محدود می شوند. اگر کاربر می‌خواهد گزارش‌های بیشتری را مشاهده کند، به پایین بروید و برای مشاهده گزارش‌های بیشتر روی More کلیک کنید.

مشاهده گزارش های بیشتر

مشاهده نمودار خانه و اجرای تست ها

در زیر دسترسی سریع، روی Home Graph Viewer کلیک کنید تا پانل Home Graph Viewer باز شود، جایی که می توانید دستگاه هایی را پیدا کنید که به پروژه انتخاب شده تعلق دارند. همچنین می‌توانید روی Run Test کلیک کنید تا تست‌های دستگاه اجرا شود.

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

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

مجموعه تست Google Home

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

نتایج آزمون

از افزونه Google Home برای اشکال زدایی موضوع استفاده کنید

ورود به سیستم اندروید

در بخش MATTER LOGGING TOOLS ، روی Android Logs کلیک کنید تا صفحه Android Logs باز شود، تلفن Android را که می‌خواهید به آن متصل شوید انتخاب کنید و شروع به نمایش گزارش‌ها کنید.

ورود به سیستم اندروید

پس از اتصال تلفن Android ، می‌توانید لاگ‌ها را خط به خط مشاهده کنید. توجه داشته باشید که گزارش‌ها فیلتر هستند، به این معنی که فقط گزارش‌های مربوط به GHA و ماژول Google Play services Matter نمایش داده می‌شوند. همچنین می‌توانید Severity را برای فیلتر کردن گزارش‌ها یا جستجوی کلمه کلیدی در گزارش‌ها تنظیم کنید.

Android Logging فیلتر شد

گزارش دستگاه موضوع

در بخش MATTER LOGGING TOOLS ، روی Device Logs کلیک کنید تا صفحه منابع باز شود، ابتدا نوع SoC را انتخاب کنید:

گزارش دستگاه مهم است

بعد، Matter Device را انتخاب کنید:

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

سپس می توانید تمام گزارش های دستگاه را از دستگاه دریافت کنید و از فیلترهایی مانند Severity و Search برای یافتن اطلاعات مورد علاقه خود استفاده کنید.

موضوع ورود به سیستم فیلتر شده دستگاه

دانلود همه گزارش های موضوع

در زیر دسترسی سریع ، روی Download Logs کلیک کنید تا کادر گفتگوی Download Logs باز شود، گزارش‌هایی را که باید دانلود شوند انتخاب کنید و OK را فشار دهید.

لاگ ماده را دانلود کنید

پوشه ای را برای دانلود گزارش ها انتخاب کنید و روی ذخیره کلیک کنید:

ذخیره گزارش ماده

سپس گزارش‌ها در پوشه مقصد ذخیره می‌شوند:

پوشه مقصد گزارش موضوع

فایل فشرده ذخیره شده را استخراج کنید، اطلاعات دستگاه و فایل های گزارش را نشان می دهد.

Matter Log Zipfile

فایل اطلاعات دستگاه شامل تمام اطلاعات نسخه مورد نیاز برای رفع اشکال می شود.

Debug Log Matter

ارسال بازخورد

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

  • در پانل HELP AND FEEDBACK ، روی ارائه بازخورد کلیک کنید تا به ما پیشنهاداتی بدهید.
  • در پانل HELP AND FEEDBACK ، روی گزارش مشکل کلیک کنید تا هر مشکلی را که با Google Home Extension پیدا کرده اید گزارش کنید.
نماد ارسال بازخورد
  • ما همچنین یک نماد بازخورد در صفحه منابع ارائه کرده ایم.