Google Home Playground

SDK دستگاه

Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph , and import or export device configurations.

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

برای استفاده از Home Playground ، توصیه می شود ابتدا ابزار را به حساب خود پیوند دهید. Google Home app (GHA) on your phone, and go through the account linking process:

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

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

ورود

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

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

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

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

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

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

دستگاه مجازی

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• خلع سلاح
• قفل باز کردن
• باز بسته
• راه اندازی مجدد
• به روز رسانی نرم افزار

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بازخورد و گزارش مشکلات

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