تنبيه: سيتم طرح برامج معاينة المطوّرين الجديدة قريبًا. يمكنك تقديم طلب من هنا كُن من أوائل الأشخاص الذين يجرّبون الأدوات الجديدة ويقدّمون الملاحظات.

ملعب Google Home

Cloud-to-cloud    Local Home SDK    Device 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. انقر على الزر تفويض للسماح بربط الحساب.
تعرض هذه الصورة مسار ربط حساب Google Home
 لربط Google Home Playground.

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

تعرض هذه القيمة قائمة الأجهزة التلقائية التي تتم تعبئتها عند ربط المستخدم بملعب Google Home في حسابه بنجاح.

تسجيل الدخول

شغِّل تطبيق Google Home Playground من خلال النقر على الزر أدناه:

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

انقر على Sign in With Google (تسجيل الدخول باستخدام حساب Google). يُرجى الحرص على تسجيل الدخول باستخدام الحساب نفسه الذي استخدمته في GHA لإكمال عملية ربط الحساب.

يعرض هذا الشكل الحالة الأولية لملعب Google Home،
            ويتم تمييز زر تسجيل الدخول في أعلى يسار الصفحة.

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

يعرض هذا الشكل قائمة الأجهزة ومعلومات الجهاز ومنطقة السجلّ في طريقة العرض التلقائية "لمساحة لعب Google Home".

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

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

جهاز افتراضي

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

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

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

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

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

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

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

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

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

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

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

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

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

إعداد SUV على الجهاز

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

تحديد الأجهزة التي تعمل بمركبات رياضية متعددة الأغراض

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

يعرض هذا الشكل الأجهزة المقترَحة لتفعيل طريقة التحقّق الثانوية من المستخدمين.

تتطلب قائمة السمات التالية توفّر سيارات رياضية متعددة الاستخدام:

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

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

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

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

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

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

يعرض هذا الشكل الزر لفتح محرِّر استجابة المزامنة.

يمكنك تعديل الرد في المزامنة أو نسخه ولصقه، ثم النقر على حفظ لتطبيق التغييرات للاطّلاع على آلية العمل في منظومة Google Home المتكاملة.

يعرض هذا الشكل النافذة لتعديل استجابة المزامنة.

استيراد الأجهزة الافتراضية وتصديرها

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

ويعرض هذا الشكل أداة "تجربة المستخدم" لاستيراد الأجهزة الافتراضية
 وتصديرها في "ملعب Google Home".

تصدير الأجهزة الافتراضية إلى ملف

  1. انقر على لتصدير الأجهزة الافتراضية إلى ملف.
  2. أدخِل اسم الملف الذي تريد تصديره وانقر على OK (حسنًا).
  3. بعد إدخال اسم الملف، سينزّل المتصفح ملف الأجهزة الافتراضية التي تم تصديرها.

استيراد أجهزة افتراضية من ملف

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

فحص سجلّات التفاعل

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

كل إدخال في السجلّ هو مصفوفة JSON تحتوي على عناصر من البنية التالية:

{
  "uri": string,
  "request": object,
  "response": object
}
الحقول Type الوصف
uri string عنوان URL لاستدعاء واجهة برمجة التطبيقات Home Graph.
request object نص الطلب لاستدعاء واجهة برمجة التطبيقات Home Graph. يمكنك الاطّلاع على المستندات المرجعية على المراجع المرجعية للتعرّف على تنسيق كل طريقة.
response object نص الاستجابة لطلب البيانات من واجهة برمجة التطبيقات Home Graph يمكنك الاطّلاع على المستندات المرجعية على المراجع المرجعية للتعرّف على تنسيق كل طريقة.

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

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

يُظهر هذا الشكل أداة تجربة المستخدم لإضافة نوع جهاز جديد في
            Google Home Playground.

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

يسعدنا معرفة رأيك. يمكنك الإبلاغ عن مشاكل باستخدام علامة التعجب التعليقات في أعلى اليسار.

يعرض هذا الشكل رموزًا لتقديم الملاحظات والآراء والمشاكل المرتبطة بالإبلاغ عن المحتوى في "مساحة المرح" في Google Home.