مهم: برای شروع توسعه دستگاه‌ها و برنامه‌های Matter در Google Home Developer Console، باید بخشی از برنامه Matter Private Beta باشید. اکنون درخواست دهید

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

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

برنامه افزودنی 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 مراجعه کنید.

ثبت ابر

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

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

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

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

VS Code را دانلود و نصب کنید:

VS Code را دانلود کنید

پس از نصب VS Code، افزونه Google Home Extension را با استفاده از یکی از گزینه های زیر نصب کنید:

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

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

  1. فایل VSIX Google Home Extension را دانلود کنید. فایل دانلود شده را از حالت فشرده خارج کنید تا فایل VSIX استخراج شود.

    دانلود فایل VSIX Google Home Extension

  2. VS Code را اجرا کنید.

  3. یکی از گزینه های نصب زیر را انتخاب کنید.

    • روی Extensions از نوار فعالیت کلیک کنید. در منوی EXTENSIONS ، روی more options و سپس Install from VSIX... را کلیک کنید.

      برنامه Google Home Extension را از منوی Extensions نصب کنید
    • از صفحه خوش آمدید روی Run a Command... کلیک کنید یا روی View و سپس Command Palette... کلیک کنید. در پالت فرمان ، Install from VSIX را تایپ کنید.

      افزونه Google Home را از Command Palette نصب کنید
  4. وقتی از شما خواسته شد، فایل VSIX را که دانلود و از حالت فشرده خارج کرده اید انتخاب کنید.

برای اطلاعات بیشتر، به اسناد Extension Marketplace مایکروسافت مراجعه کنید.

افزونه Google Home را از خط فرمان نصب کنید

برای نصب از خط فرمان، از --install-extension استفاده کنید:

code --install-extension google-home-extension.vsix

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

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

با گوگل وارد شوید

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

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

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

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

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

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

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

    به Google Home Extension اجازه دهید یک URI را باز کند

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مشاهده Cloud Logging

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

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

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

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

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

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

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

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

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

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

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

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

نتایج آزمون

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

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

  • در نوار کناری ، روی نماد بازخورد از GOOGLE SIGN IN کلیک کنید.

    نماد ارسال بازخورد
  • ما همچنین یک نماد بازخورد در صفحه منابع ارائه کرده ایم.