Google Home Playground

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

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

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

1. ادغام با عنوان Google Home Playground را جستجو کنید.
2. یکپارچه‌سازی را انتخاب کنید و GHA شما را به صفحه ورود به سیستم هدایت می‌کند. روی ورود به سیستم با Google کلیک کنید و حسابتان را برای ورود به سیستم انتخاب کنید.
3. روی دکمه مجاز کردن کلیک کنید تا پیوند دادن حساب مجاز شود.

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

ورود به سیستم

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

راه‌اندازی Playground

روی ورود به سیستم با Google کلیک کنید. حتماً با همان حسابی به سیستم وارد شوید که در GHA برای تکمیل پیوند دادن حساب استفاده کردید.

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

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

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

دستگاه مجازی

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

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

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

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

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

اصلاح ویژگی‌های پشتیبانی‌شده

1. برگه ویژگی‌ها را انتخاب کنید؛ روی دکمه ویرایش کلیک کنید.
2. در پانل بالاپر، می‌توانید ویژگی‌های فعلی پشتیبانی‌شده دستگاه و ویژگی‌های دردسترس برای افزودن را ببینید. از دکمه‌های جهت‌نما (arrow_forward/arrow_back) برای افزودن یا برداشتن ویژگی‌های پشتیبانی‌شده برای دستگاه استفاده کنید.
3. وقتی به‌روزرسانی ویژگی‌های پشتیبانی‌شده تمام شد، روی ذخیره کلیک کنید تا ویژگی‌های به‌روزشده در Home Graph اعمال شود.
4. می‌توانید این به‌روزرسانی‌های ویژگی را در بخش گزارش مشاهده کنید.

اصلاح مشخصه‌های دستگاه

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

تغییر دادن وضعیت دستگاه

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

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

می‌توانید «درستی‌سنجی ثانویه کاربر» را به دستگاه‌های مجازی اضافه کنید و نوع چالش و رفتار متناظر آن را در هر دستگاه پیکربندی کنید. می‌توانید «درستی‌سنجی ثانویه کاربر» را به دستگاه‌های مجازی اضافه کنید و نوع چالش و رفتار متناظر آن را در هر دستگاه پیکربندی کنید.

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

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

شناسایی دستگاه‌هایی که «درستی‌سنجی ثانویه کاربر» را فعال می‌کنند

در پانل فهرست دستگاه، نماد کلید کلید در کنار هر دستگاهی که «درستی‌سنجی ثانویه کاربر» در آن فعال است نمایش داده می‌شود.

فهرست ویژگی‌های زیر به «درستی‌سنجی ثانویه کاربر» نیاز دارد:

• ArmDisarm
• LockUnlock
• OpenClose
• راه‌اندازی مجدد
• SoftwareUpdate

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

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

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

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

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

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

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

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

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

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

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

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

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

بررسی گزارش‌های تعامل

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

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

{
  "uri": string,
  "request": object,
  "response": object
}

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

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

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

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