ملعب Google Home

Cloud-to-Cloud    حزمة SDK للمنزل المحلي    حزمة SDK للجهاز

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

إكمال عملية ربط الحساب

لاستخدام ميزة Google Home Playground، ننصحك بربط الأداة أولاً بحسابك. افتح Google Home app (GHA) على هاتفك واتّبِع عملية ربط الحساب:

1. انقر على رمز علامة الجمع (+) في أعلى يمين الصفحة.
2. اختَر إعداد الجهاز > يعمل مع Google.
3. ابحث عن الإجراء بعنوان مساحة المرح في Google Home.
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. اختَر علامة التبويب الحالات وعدِّل الحالة مباشرةً. سيتم تطبيق تغييرات الحالة على Home Graph
2. يمكنك الاطّلاع على تعديلات الحالة هذه في منطقة السجلّ.

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

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

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

1. في لوحة قائمة الأجهزة، اختَر الجهاز الافتراضي الذي تريد ضبطه.
2. في لوحة معلومات الجهاز، اختَر علامة التبويب سيارة رياضية متعددة الأغراض واضبط ما يلي:
   • مفعَّلة: سواء كانت ميزة التحقُّق الثانوي من المستخدِم مُفعَّلة أو غير مفعَّلة (بدون تحدٍّ) على الجهاز.
   • نوع التحدي: ما إذا كانت إحدى سيارات الدفع الرباعي تتطلب إقرارًا صريحًا (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.

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

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