ملعب 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. يمكنك توسيع السجلات لتفقد حمولات الطلب والاستجابة لاستكشاف الأخطاء وإصلاحها.

جهاز افتراضي

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

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

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

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

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

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

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

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

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

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

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

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

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

تكوين SUV على الجهاز

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

تحديد الأجهزة التي تمكن سيارات الدفع الرباعي

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

تتطلّب قائمة السمات التالية استخدام 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
}

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

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

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

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