ملعب Google Home

الربط بين الخدمات السحابية    Local Home SDK    Home APIs

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 ‏(Sign in With Google). يُرجى التأكّد من تسجيل الدخول باستخدام الحساب نفسه الذي استخدمته في GHA لإكمال عملية ربط الحساب.

بعد تسجيل الدخول، سيعرض Google Home Playground الأجهزة الافتراضية المخزّنة في Home Graph.

تتألف واجهة المستخدم على الويب من ثلاث لوحات:

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

جهاز افتراضي

عرض معلومات الجهاز الافتراضي

في لوحة قائمة الأجهزة، اختَر الجهاز المحاكي الذي تريد عرضه. في لوحة قائمة الأجهزة، اختَر الجهاز المحاكي الذي تريد عرضه. ستعرض لوحة معلومات الجهاز معلوماتها مصنّفة في خمس علامات تبويب:

• المعلومات الأساسية: هي المواقع ذات المستوى الأعلى للجهاز، بما في ذلك نوع الجهاز ومعرّفه واسمه.
• السمات: هي السمات المتوافقة مع الجهاز.
• السمات: هي سمات خاصة بالجهاز.
• الحالات: جميع حالات الجهاز
• التحقّق الثانوي من المستخدِم: إعدادات التحقّق الثانوي من المستخدِم في الجهاز.

تعديل معلومات الجهاز الافتراضي

بالإضافة إلى عرض معلومات جهاز افتراضي، يمكنك أيضًا تعديل المعلومات المخزَّنة في Home Graph مباشرةً من خلال لوحة معلومات الجهاز.

تعديل السمات المتوافقة

1. انقر على علامة التبويب السمات، ثم على الزر تعديل.
2. في اللوحة المنبثقة، يمكنك الاطّلاع على سمات الجهاز المتوافقة حاليًا والسمات المتاحة للإضافة. استخدِم أزرار السهم (arrow_forward/arrow_back) لإضافة السمات المتوافقة مع الجهاز أو إزالتها.
3. عند الانتهاء من تعديل السمات المتوافقة، انقر على حفظ، وسيتم تطبيق السمات المعدَّلة على Home Graph.
4. يمكنك الاطّلاع على هذه التعديلات على السمات في منطقة السجلّ.

تعديل سمات الجهاز

1. انقر على علامة التبويب السمات، وعدِّل سمة السمات المتوافقة مع الجهاز.
2. بعد الانتهاء من التعديل، اضغط على Enter وسيتم تطبيق التغييرات التي أجريتها على سمات Home Graph.
3. يمكنك الاطّلاع على هذه السمات المعدَّلة في منطقة السجلّ.

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

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

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

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

ضبط ميزة التحقّق الثانوي من المستخدِم على الجهاز

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

تحديد الأجهزة التي تتيح ميزة التحقُّق الثانوي من المستخدِم

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

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

• ArmDisarm
• LockUnlock
• OpenClose
• إعادة التشغيل
• SoftwareUpdate

إنشاء جهاز افتراضي جديد

1. في لوحة قائمة الأجهزة، انقر على إضافة جهاز.
2. في اللوحة المنبثقة، اختَر نوع الجهاز وأدخِل اسم الجهاز الجديد. بدلاً من ذلك، يمكنك اختيار مجموعة محدّدة مسبقًا من الأجهزة لإضافتها.
3. بعد إكمال جميع الخطوات، ستتم إضافة الجهاز الجديد إلى Home Graph.

إزالة جهاز افتراضي

1. في لوحة قائمة الأجهزة، اختَر الجهاز الذي تريد إزالته. بعد ذلك، في لوحة معلومات الجهاز، انقر على علامة التبويب المعلومات الأساسية، ثم انقر على إزالة الجهاز في أسفل الصفحة.
2. أكِّد إزالة الجهاز في التنبيه المنبثق.
3. بعد تأكيد إزالة الجهاز، ستتم إزالته من Home Graph.

محرّر استجابة المزامنة

يمكنك التحقّق من صحة ردّك على سؤال المزامنة أو تعديله في Google Home Playground. انقر على محرِّر مزامنة الردود لفتح بيئة تطوير متكاملة مضمّنة.

عدِّل رد المزامنة أو انسَخه والصقه، ثم انقر على حفظ لتطبيق التغييرات ومعرفة طريقة عمله في منظومة 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.

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

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