ملعب 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 إلى صفحة تسجيل الدخول. انقر على Sign in with Google (تسجيل الدخول باستخدام حساب Google) واختَر حسابك لتسجيل الدخول.
  5. انقر على الزر تفويض للسماح بربط الحساب.
يوضِّح هذا الشكل خطوات ربط حساب تطبيق Google Home
            لربط حساب Google Home Playground.

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

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

تسجيل الدخول

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

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

انقر على Sign in With Google (تسجيل الدخول باستخدام حساب 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 Playground.

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

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

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

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

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

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

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

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

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

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

يوضّح هذا الشكل الأجهزة التي يُنصح بتفعيل ميزة "التحقّق الثانوي" من خلالها.

تتطلب قائمة السمات التالية استخدام التحقُّق الثانوي من المستخدِم:

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

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

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

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

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

يمكنك التحقّق من صحة استجابة المزامنة أو تعديلها في 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 Playground.

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

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

يعرض هذا الشكل رموز تقديم الملاحظات والإبلاغ عن المشاكل في Google Home Playground.