ملعب Google Home

من السحابة إلى السحابة    حزمة تطوير البرامج (SDK) لخدمة Local Home    واجهات برمجة التطبيقات 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. تأكَّد من تسجيل الدخول باستخدام الحساب نفسه الذي استخدمته في 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. بعد الانتهاء من التعديل، اضغط على مفتاح الإدخال وسيتم تطبيق التغييرات على السمات في Home Graph.
3. يمكنك الاطّلاع على هذه السمات المعدَّلة في منطقة السجلّ.

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

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

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

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

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

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

تحديد الأجهزة التي تتيح إجراء ثانوي لإثبات هوية المستخدم

في لوحة قائمة الأجهزة ، يظهر رمز مفتاح key بجانب كل جهاز يتيح إجراء ثانوي لإثبات هوية المستخدم.

تتطلّب قائمة السمات التالية إجراء ثانوي لإثبات هوية المستخدم:

• ArmDisarm
• LockUnlock
• OpenClose
• Reboot
• 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
}

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

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

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

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