ملعب 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. انقر على الزر تفويض للسماح بربط الحساب.

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

تسجيل الدخول

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

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

انقر على Sign in With Google (تسجيل الدخول باستخدام حساب 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. انقر على علامة التبويب States (الحالات) وعدِّل الحالة مباشرةً. سيتم تطبيق تغييرات الحالة على Home Graph.
2. يمكنك الاطّلاع على تعديلات الحالة هذه في منطقة السجلّ.

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

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

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

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

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

في لوحة قائمة الأجهزة، يظهر رمز مفتاح مفتاح بجانب كل جهاز مزوّد بـ 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
}

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

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

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

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

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