به Google Home Developer Center، مقصد جدیدی برای یادگیری نحوه توسعه اقدامات خانه هوشمند خوش آمدید. توجه: به ساخت کنش‌ها در کنسول Actions ادامه خواهید داد.

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. برای مجوز دادن به پیوند حساب روی دکمه مجوز کلیک کنید.
این شکل جریان پیوند حساب برنامه Google Home را برای اتصال Google Home Playground نشان می دهد.

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

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

ورود

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

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

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

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

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

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

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

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

دستگاه مجازی

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

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

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

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

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

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

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

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

  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 ) دارد.
    • پین: پین معتبر.
    • مدیریت پین نادرست: زمانی که پین ​​اشتباه است، آیا دوباره از کاربر سوال شود و اگر نه، خطا برای پاسخ دادن.
این شکل ابزار UX را برای فعال کردن ویژگی‌های تأیید ثانویه کاربر در یک دستگاه انتخابی در Google Home Playground نشان می‌دهد.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. برای وارد کردن دستگاه های مجازی از یک فایل، روی کلیک کنید.
  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
}
زمینه های تایپ کنید شرح
uri string URL تماس API Home Graph .
request object درخواست بدنه تماس API Home Graph . برای فرمت هر روش به مستندات مرجع مراجعه کنید.
response object بدنه پاسخ تماس API Home Graph . برای فرمت هر روش به مستندات مرجع مراجعه کنید.

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

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

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

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

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

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