Cloud-to-cloud Local Home SDK Device SDK
Google Home Playground هو تطبيق ويب يحاكي مشروعًا منزليًا ذكيًا بأنواع أجهزة وسمات قابلة للضبط. يمكنك إنشاء أجهزة افتراضية وتعديل سمات الجهاز وحالاته والاطّلاع على هذه الأجهزة في Google Home Graph واستيراد إعدادات الأجهزة أو تصديرها.
إكمال عملية ربط الحساب
لاستخدام Google Home Playground، نقترح ربط الأداة بحسابك أولاً. افتح Google Home app (GHA) على هاتفك، وابدأ عملية ربط الحساب:
- انقر على رمز علامة الجمع (+) في أعلى يمين الصفحة.
- اختَر إعداد جهاز > يعمل مع Google.
- ابحث عن الإجراء بعنوان Google Home Playground.
- اختَر "الإجراء"، وسيوجّهك GHA إلى صفحة تسجيل الدخول. انقر على تسجيل الدخول باستخدام حساب Google واختَر حسابك لتسجيل الدخول.
- انقر على الزر تفويض للسماح بربط الحساب.

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

تسجيل الدخول
شغِّل تطبيق Google Home Playground من خلال النقر على الزر أدناه:
انقر على Sign in With Google (تسجيل الدخول باستخدام حساب Google). يُرجى الحرص على تسجيل الدخول باستخدام الحساب نفسه الذي استخدمته في GHA لإكمال عملية ربط الحساب.

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

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

تعديل سمات الجهاز
- حدّد علامة التبويب السمات، وعدّل السمة للسمات المتوافقة مع الجهاز.
- بعد الانتهاء من التعديل، اضغط على Enter وسيتم تطبيق تغييرات السمات على Home Graph.
- يمكنك الاطّلاع على هذه السمات المعدَّلة في منطقة السجلّ.
تعديل حالات الأجهزة
- اختَر علامة التبويب States (الولاية) وعدِّل الولاية مباشرةً. سيتم تطبيق تغييرات الحالة على Home Graph.
- ويمكنك الاطّلاع على تعديلات الحالة هذه في منطقة السجلّ.
إضافة عملية تحقّق ثانوية من المستخدم إلى جهاز افتراضي
يمكنك إضافة سيارة رياضية متعددة الأغراض إلى أجهزة افتراضية وإعداد نوع التحدّي والسلوك المرتبط بها على كل جهاز. ويمكنك إضافة سيارة رياضية متعددة الأغراض إلى أجهزة افتراضية وإعداد نوع التحدّي والسلوك ذي الصلة على كل جهاز.
إعداد SUV على الجهاز
- في لوحة قائمة الأجهزة، اختَر الجهاز الافتراضي الذي تريد ضبطه.
- في لوحة معلومات الجهاز، اختَر علامة التبويب SUV واضبط ما يلي:
- مفعّلة: سواء كانت SUV مفعّلة أو غير مفعّلة (بدون اختبار) على الجهاز.
- نوع التحدّي: ما إذا كانت SUV تتطلّب إقرارًا صريحًا (ackRequiredd) أو رقم تعريف شخصي (pinpined)
- رقم التعريف الشخصي: رقم التعريف الشخصي الصالح.
- التعامل مع رقم التعريف الشخصي غير الصحيح: عندما يكون رقم التعريف الشخصي غير صحيح، سواء طلبت من المستخدم المحاولة مرة أخرى، أو إذا حدث خطأ.

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

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

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

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

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

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

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

الإبلاغ عن المشاكل
يسعدنا معرفة رأيك. يمكنك الإبلاغ عن مشاكل باستخدام علامة التعجب التعليقات في أعلى اليسار.
