Google Home Playground

Cloud-to-Cloud Local Home SDK Device SDK

Google Home Playground یک برنامه وب است که پروژه خانه هوشمند را با انواع و ویژگی های دستگاه قابل تنظیم شبیه سازی می کند. می‌توانید دستگاه‌های مجازی ایجاد کنید، ویژگی‌ها و وضعیت‌های دستگاه را تغییر دهید، این دستگاه‌ها را در Google Home Graph مشاهده کنید، و پیکربندی‌های دستگاه را وارد یا صادر کنید.

پیوند کامل حساب

برای استفاده از Google Home Playground ، توصیه می شود ابتدا ابزار را به حساب خود پیوند دهید. Google Home app (GHA) در تلفن خود باز کنید و مراحل پیوند حساب را طی کنید:

  1. روی نماد مثبت (+) در گوشه بالا سمت چپ کلیک کنید.
  2. راه‌اندازی دستگاه > با Google کار می‌کند را انتخاب کنید.
  3. اکشن با عنوان Google Home Playground را جستجو کنید.
  4. Action را انتخاب کنید و GHA شما را به صفحه ورود هدایت می کند. روی Sign in with Google کلیک کنید و حساب خود را برای ورود انتخاب کنید.
  5. برای مجوز دادن به پیوند حساب روی دکمه مجوز کلیک کنید.
این شکل جریان پیوند حساب برنامه Google Home را برای اتصال Google Home Playground نشان می دهد.

پس از تکمیل پیوند حساب، مجموعه‌ای از دستگاه‌های مجازی پیش‌فرض در GHA نمایش داده می‌شوند تا بتوانید با آن‌ها تعامل داشته باشید.

این شکل لیست دستگاه پیش‌فرض را نشان می‌دهد که وقتی کاربر با موفقیت Google Home Playground را به حساب خود پیوند می‌دهد، پر می‌شود.

ورود

Google Home Playground با کلیک کردن روی دکمه زیر راه اندازی کنید:

زمین بازی را راه اندازی کنید

روی Sign in with Google کلیک کنید. مطمئن شوید که با همان حسابی که در GHA استفاده می‌کردید وارد شوید تا پیوند حساب را تکمیل کنید.

این شکل وضعیت اولیه Google Home Playground را نشان می‌دهد و دکمه ورود به سیستم را در گوشه سمت راست بالا مشخص می‌کند.

پس از ورود به سیستم، Google Home Playground دستگاه های مجازی ذخیره شده در Home Graph را نشان می دهد.

این شکل فهرست دستگاه، اطلاعات دستگاه و منطقه گزارش نمای پیش‌فرض Google Home Playground را نشان می‌دهد.

رابط کاربری وب از سه پنل تشکیل شده است:

  • لیست دستگاه ها همه دستگاه های مجازی شما را نشان می دهد. شما می توانید یک دستگاه مجازی خاص را برای مشاهده اطلاعات آن انتخاب کنید و از طریق این پنل دستگاه های مجازی ایجاد کنید.
  • اطلاعات دستگاه اطلاعات دستگاه مجازی انتخاب شده را نشان می دهد. همچنین می توانید این اطلاعات را ویرایش کرده و دستگاه مجازی انتخاب شده را از طریق پنل حذف کنید.
  • منطقه گزارش، گزارش‌های تعامل بین Google Home Playground و Home Graph را نشان می‌دهد. می‌توانید گزارش‌ها را برای بازرسی بارهای درخواست و پاسخ برای عیب‌یابی گسترش دهید.

دستگاه مجازی

مشاهده اطلاعات دستگاه مجازی

در پانل لیست دستگاه ، دستگاه مجازی را که می خواهید مشاهده کنید انتخاب کنید. در پانل لیست دستگاه ، دستگاه مجازی را که می خواهید مشاهده کنید انتخاب کنید. پانل اطلاعات دستگاه اطلاعات خود را به صورت دسته بندی شده در پنج تب نشان می دهد:

  • اطلاعات اولیه: ویژگی های سطح بالای دستگاه، از جمله نوع دستگاه، شناسه و نام.
  • ویژگی ها: ویژگی های پشتیبانی شده دستگاه.
  • ویژگی‌ها: ویژگی‌های خاص دستگاه.
  • States: همه حالت های دستگاه.
  • SUV: پیکربندی تأیید کاربر ثانویه دستگاه.

اطلاعات دستگاه مجازی را ویرایش کنید

علاوه بر مشاهده اطلاعات یک دستگاه مجازی، همچنین می توانید مستقیماً اطلاعات ذخیره شده آن در Home Graph را از طریق پانل اطلاعات دستگاه ویرایش کنید.

صفات پشتیبانی شده را اصلاح کنید

  1. برگه Traits را انتخاب کنید. روی دکمه Edit کلیک کنید.
  2. در پانل بازشو، می‌توانید ویژگی‌های پشتیبانی‌شده در حال حاضر دستگاه و ویژگی‌های موجود برای افزودن را ببینید. از دکمه های پیکان ( arrow_forward / arrow_back ) برای افزودن یا حذف ویژگی های پشتیبانی شده برای دستگاه استفاده کنید.
  3. پس از به‌روزرسانی ویژگی‌های پشتیبانی‌شده، روی «ذخیره» کلیک کنید و ویژگی‌های به‌روزرسانی‌شده در Home Graph اعمال می‌شوند.
  4. می‌توانید این به‌روزرسانی‌های ویژگی را در ناحیه Log مشاهده کنید.
این شکل ابزار UX را برای افزودن یا حذف ویژگی های پشتیبانی شده در یک دستگاه انتخاب شده در Google Home Playground نشان می دهد.

ویژگی های دستگاه را اصلاح کنید

  1. برگه Attributes را انتخاب کنید و ویژگی را برای ویژگی های پشتیبانی شده توسط دستگاه ویرایش کنید.
  2. پس از اتمام ویرایش، Enter را فشار دهید تا تغییرات ویژگی شما در Home Graph اعمال شود.
  3. می توانید این ویژگی های به روز شده را در قسمت Log مشاهده کنید.

حالت های دستگاه را تغییر دهید

  1. تب State را انتخاب کرده و حالت را مستقیماً ویرایش کنید. تغییرات وضعیت در Home Graph اعمال خواهد شد.
  2. شما می توانید این تغییرات حالت را در ناحیه Log مشاهده کنید.

یک تأیید کاربر ثانویه به دستگاه مجازی اضافه کنید

می توانید یک SUV را به دستگاه های مجازی اضافه کنید و نوع چالش و رفتار مربوطه آن را در هر دستگاه پیکربندی کنید. می توانید یک SUV را به دستگاه های مجازی اضافه کنید و نوع چالش و رفتار مربوطه آن را در هر دستگاه پیکربندی کنید.

SUV را روی دستگاه پیکربندی کنید

  1. در پانل لیست دستگاه ، دستگاه مجازی را که می خواهید پیکربندی کنید انتخاب کنید.
  2. در پانل اطلاعات دستگاه ، برگه SUV را انتخاب کنید و موارد زیر را پیکربندی کنید:
    • فعال: فعال یا غیرفعال بودن SUV ( بدون چالش ) در دستگاه.
    • نوع چالش: آیا SUV نیاز به تأیید صریح ( ackNeeded ) یا شماره شناسایی شخصی ( pinNeeded ) دارد.
    • پین: پین معتبر.
    • مدیریت پین نادرست: زمانی که پین ​​اشتباه است، آیا دوباره از کاربر سوال شود و اگر نه، خطا برای پاسخ دادن.
این شکل ابزار UX را برای فعال کردن ویژگی‌های تأیید ثانویه کاربر در یک دستگاه انتخاب شده در Google Home Playground نشان می‌دهد.

دستگاه هایی را که SUV را فعال می کنند، شناسایی کنید

در پانل لیست دستگاه ، یک کلید نماد کلید در کنار هر دستگاه دارای SUV نمایش داده می شود.

این شکل دستگاه هایی را نشان می دهد که برای فعال کردن تأیید کاربر ثانویه توصیه می شود.

لیست ویژگی های زیر به SUV نیاز دارد:

یک دستگاه مجازی جدید ایجاد کنید

  1. در پانل لیست دستگاه ، روی افزودن دستگاه کلیک کنید.
  2. در پانل پاپ آپ، نوع دستگاه را انتخاب کنید و نام دستگاه را برای دستگاه جدید خود وارد کنید. همچنین، می‌توانید مجموعه‌ای از دستگاه‌های از پیش تعریف‌شده را برای افزودن انتخاب کنید.
  3. پس از تکمیل تمام مراحل، دستگاه جدید به Home Graph اضافه خواهد شد.
این شکل ابزار UX برای افزودن نوع دستگاه جدید در Google Home Playground را نشان می دهد.

یک دستگاه مجازی را حذف کنید

  1. در پانل لیست دستگاه ، دستگاهی را که می خواهید حذف کنید انتخاب کنید. سپس در پنل اطلاعات دستگاه ، تب Basic Information و سپس در پنل اطلاعات دستگاه ، تب Basic Information را انتخاب کرده و کلیک کنید.نماد سطل زباله دستگاه را از پایین خارج کنید .
  2. حذف دستگاه را در هشدار پاپ آپ تأیید کنید.
  3. پس از تأیید حذف دستگاه، دستگاه از Home Graph حذف خواهد شد.
این شکل ابزار UX برای حذف نوع دستگاه مجازی در Google Home Playground را نشان می دهد.

ویرایشگر پاسخ همگام سازی

می‌توانید پاسخ همگام‌سازی خود را در Google Home Playground تأیید یا به‌روزرسانی کنید. روی Sync Response Editor کلیک کنید تا یک IDE تعبیه شده باز شود.

این شکل دکمه باز کردن ویرایشگر پاسخ همگام سازی را نشان می دهد.

پاسخ همگام‌سازی خود را ویرایش یا کپی و جای‌گذاری کنید و روی ذخیره کلیک کنید تا تغییرات اعمال شود تا ببینید در اکوسیستم Google Home چگونه کار می‌کند.

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

واردات و صادرات دستگاه های مجازی

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

این شکل ابزار UX برای وارد کردن و صادرات دستگاه های مجازی در Google Home Playground را نشان می دهد.

دستگاه های مجازی را به یک فایل صادر کنید

  1. برای صادر کردن دستگاه های مجازی به یک فایل، روی کلیک کنید.
  2. نام فایلی را که می خواهید صادر کنید وارد کنید و روی OK کلیک کنید.
  3. هنگامی که نام فایل را وارد کردید، مرورگر فایل دستگاه های مجازی صادر شده را دانلود می کند.

دستگاه های مجازی را از یک فایل وارد کنید

  1. برای وارد کردن دستگاه های مجازی از یک فایل، روی کلیک کنید.
  2. فایلی را که می خواهید وارد کنید انتخاب کنید و روی OK کلیک کنید.
  3. هنگامی که فایل را برای وارد کردن تأیید کردید، Google Home Playground دستگاه‌های مجازی را با حالت‌ها از فایل وارد می‌کند و اطلاعات و وضعیت‌های دستگاه‌های وارد شده را در Home Graph به‌روزرسانی می‌کند.

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

وقتی با دستگاه‌های مجازی تعامل دارید، Google Home Playground به‌طور خودکار تغییر شما را در Home Graph اعمال می‌کند. تعاملات با Home Graph در پانل Log area ثبت می‌شود، جایی که می‌توانید هر ورودی را گسترش دهید تا درخواست Home Graph API و بارهای پاسخ را بررسی کنید.

هر ورودی گزارش یک آرایه JSON است که حاوی عناصر ساختار زیر است:

{
  "uri": string,
  "request": object,
  "response": object
}
زمینه های تایپ کنید شرح
uri string URL تماس API Home Graph .
request object درخواست بدنه تماس API Home Graph . برای فرمت هر روش به مستندات مرجع مستندات مرجع مراجعه کنید.
response object بدنه پاسخ تماس API Home Graph . برای فرمت هر روش به مستندات مرجع مستندات مرجع مراجعه کنید.

انواع و ویژگی های دستگاه پشتیبانی شده را مشاهده کنید

نماد راهنمای علامت سوال در بالا سمت چپ، نوع دستگاه فعلی و لیست ویژگی‌های پشتیبانی شده توسط Google Home Playground را نشان می‌دهد.

این شکل ابزار UX برای افزودن نوع دستگاه جدید در Google Home Playground را نشان می دهد.

مشکلات را گزارش کنید

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

این شکل نمادهای ارائه بازخورد و گزارش مشکلات در Google Home Playground را نشان می دهد.