ملعب Google Home

حزمة 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 Playground بحسابه

تسجيل الدخول

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

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

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

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

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

يوضح هذا الشكل قائمة الأجهزة ومعلومات الجهاز ومساحة السجل
            العرض التلقائي لـ Google Home Playground

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

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

جهاز افتراضي

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يعرض هذا الرسم الأجهزة التي يُنصح بتفعيلها الثانوية
            التحقق من المستخدم.

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

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

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

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

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

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

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

يعرض هذا الرسم زر فتح محرِّر ردود المزامنة.

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

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

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

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

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

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

  1. انقر على للتصدير. الأجهزة الافتراضية إلى ملف.
  2. أدخِل اسم الملف الذي تريد تصديره، وانقر على حسنًا.
  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
}
الحقول النوع الوصف
uri string عنوان URL لطلب بيانات من واجهة برمجة التطبيقات Home Graph
request object نص الطلب الخاص بطلب بيانات من واجهة برمجة التطبيقات Home Graph يمكنك الاطّلاع على المستندات المرجعية المستندات المرجعية لتنسيق كل طريقة.
response object نص الاستجابة لطلب البيانات من واجهة برمجة التطبيقات Home Graph. يمكنك الاطّلاع على المستندات المرجعية المستندات المرجعية لتنسيق كل طريقة.

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

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

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

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

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

يوضح هذا الشكل رموز تقديم الملاحظات والآراء
       في Google Home Playground