ملعب Google Home

السحابة الإلكترونية إلى السحابة الإلكترونية    حزمة تطوير البرامج (SDK) المحلية للمنزل    حزمة SDK للأجهزة

Google Home Playground هو تطبيق ويب يحاكي مشروعًا منزليًا ذكيًا باستخدام أنواع الأجهزة والسمات القابلة للضبط. يمكنك إنشاء أجهزة افتراضية، وتعديل سمات الأجهزة وحالاتها، وعرض هذه الأجهزة في Google Home Graph، واستيراد إعدادات الأجهزة أو تصديرها.

إكمال عملية ربط الحساب

لاستخدام Google Home Playground، ننصحك أولاً بربط الأداة بحسابك. افتح Google Home app (GHA) على هاتفك واتّبِع عملية ربط الحساب:

1. انقر على رمز علامة الجمع (+) في أعلى يمين الصفحة.
2. اختَر إعداد الجهاز > يعمل مع Google.
3. ابحث عن المهمّة بعنوان Google Home Playground.
4. اختَر الإجراء، وسيوجهك GHA إلى صفحة تسجيل الدخول. انقر على تسجيل الدخول باستخدام حساب Google واختَر حسابك لتسجيل الدخول.
5. انقر على الزر تفويض للسماح بربط الحساب.

بعد إكمال عملية ربط الحساب، ستظهر مجموعة من الأجهزة الافتراضية التلقائية على GHA كي تتفاعل معها.

تسجيل الدخول

يمكنك فتح "Google Home Playground" من خلال النقر على الزر أدناه:

إطلاق "مساحة المرح"

انقر على تسجيل الدخول باستخدام حساب Google ‏(Sign in With 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. بعد الانتهاء من التعديل، اضغط على Enter وسيتم تطبيق تغييرات السمات على Home Graph.
3. يمكنك الاطّلاع على هذه السمات المعدَّلة في منطقة السجلّ.

تعديل حالات الأجهزة

1. اختَر علامة التبويب الولايات وعدِّل الولاية مباشرةً. سيتم تطبيق تغييرات الحالة على Home Graph.
2. يمكنك الاطّلاع على تعديلات الحالة هذه في منطقة السجلّ.

إضافة عملية ثانوية لإثبات هوية المستخدم إلى جهاز افتراضي

يمكنك إضافة سيارة رياضية متعددة الأغراض إلى الأجهزة الافتراضية وضبط نوع التحدي والسلوك المناسب على كل جهاز. يمكنك إضافة سيارة رياضية متعددة الأغراض إلى الأجهزة الافتراضية وضبط نوع التحدي والسلوك المناسب على كل جهاز.

ضبط سيارة الدفع الرباعي على الجهاز

1. في لوحة قائمة الأجهزة، اختَر الجهاز الافتراضي الذي تريد ضبطه.
2. في لوحة معلومات الجهاز، اختَر علامة التبويب SUV واضبط ما يلي:
   • مفعَّلة: ما إذا كانت السيارة SUV مفعَّلة أو غير مفعَّلة (بدون تحدي) على الجهاز.
   • نوع التحدي: ما إذا كانت سيارة SUV تتطلب إقرارًا صريحًا (ackNeeded) أو رقم تعريف شخصي (pinNeeded).
   • رقم التعريف الشخصي: رقم التعريف الشخصي الصالح.
   • التعامل مع رقم التعريف الشخصي غير الصحيح: عندما يكون رقم التعريف الشخصي غير صحيح، وما إذا كان سيطلب من المستخدم مرة أخرى أم لا، وإذا لم يكن كذلك، ستظهر رسالة خطأ للردّ.

التعرّف على الأجهزة التي تتيح استخدام ميزة SUV

في لوحة قائمة الأجهزة، يظهر مفتاح رمز المفتاح بجانب كل جهاز متوافق مع ميزة SUV.

تتطلّب القائمة التالية من السمات استخدام ميزة SUV:

• 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
}

الحقول	النوع	الوصف
uri	string	عنوان URL لطلب بيانات من واجهة برمجة التطبيقات Home Graph
request	object	نص الطلب الخاص بطلب بيانات من واجهة برمجة التطبيقات Home Graph اطّلِع على المستندات المرجعية والمستندات المرجعية الخاصة بتنسيق كل طريقة.
response	object	نص الاستجابة لطلب البيانات من واجهة برمجة التطبيقات Home Graph. اطّلِع على المستندات المرجعية والمستندات المرجعية الخاصة بتنسيق كل طريقة.

عرض السمات وأنواع الأجهزة المتوافقة

سيعرض رمز المساعدة علامة الاستفهام في أعلى اليسار نوع الجهاز الحالي وقائمة السمات المتوافقة مع Google Home Playground.

الإبلاغ عن المشكلات

تسرّنا معرفة رأيك. يمكنك الإبلاغ عن المشاكل التي حدثت باستخدام رمز علامة التعجب في الملاحظات في أعلى يسار الصفحة.