مرحبًا بك في "مركز مطوّري Google Home"، الوجهة الجديدة لتعلّم كيفية تطوير المهام المنزلية الذكية. ملاحظة: ستواصل إنشاء إجراءات في "وحدة تحكّم المهام".

ملعب Google Home

حزمة تطوير البرامج (SDK) للجهاز

Google Home Playground هو تطبيق ويب يسمح لك بمحاكاة مشروع منزلي ذكي من خلال محاكاة منزل افتراضي يتضمن أنواع أجهزة وسمات قابلة للضبط. يسمح لك 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".

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

  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.

الملاحظات والآراء والإبلاغ عن المشاكل

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

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