من السحابة الإلكترونية إلى السحابة الإلكترونية حزمة تطوير برامج المنزل المحلية حزمة تطوير برامج الأجهزة
Google Home Playground هو تطبيق ويب يحاكي مشروع ذكاء صناعي للمنزل يتضمّن أنواع الأجهزة والسمات القابلة للضبط. يمكنك إنشاء أجهزة افتراضية وتعديل سمات الأجهزة وحالاتها وعرض هذه الأجهزة في Google Home Graph واستيراد إعدادات الأجهزة أو تصديرها.
إكمال عملية ربط الحساب
لاستخدام Google Home Playground، ننصحك أولاً بربط التطبيق بحسابك. افتح تطبيق Google Home app (GHA) على هاتفك، واتّبِع خطوات ربط الحساب:
- انقر على رمز علامة الجمع (+) في أعلى يمين الصفحة.
- اختَر إعداد الجهاز > يعمل مع Google.
- ابحث عن الإجراء بعنوان Google Home Playground.
- اختَر الإجراء، وسيوجّهك GHA إلى صفحة تسجيل الدخول. انقر على تسجيل الدخول باستخدام حساب Google واختَر حسابك لتسجيل الدخول.
- انقر على الزرّ تفويض لتفويض ربط الحساب.
بعد إكمال عملية ربط الحساب، ستظهر مجموعة من الأجهزة الافتراضية التلقائية على GHA لتتمكّن من التفاعل معها.
تسجيل الدخول
افتح Google Home Playground بالنقر على الزر أدناه:
انقر على تسجيل الدخول باستخدام حساب Google (Sign in With Google). احرص على تسجيل الدخول باستخدام الحساب نفسه الذي استخدَمته في GHA لإكمال عملية ربط الحساب.
بعد تسجيل الدخول، ستعرِض Google Home Playground الأجهزة الافتراضية المخزّنة في Home Graph.
تتألّف واجهة مستخدِم الويب من ثلاث لوحات:
- تعرض قائمة الأجهزة جميع أجهزتك الافتراضية. يمكنك اختيار جهاز افتراضي معيّن لعرض معلوماته وإنشاء أجهزة افتراضية من خلال هذه اللوحة.
- تعرِض معلومات الجهاز معلومات الجهاز الافتراضي المحدَّد. يمكنك أيضًا تعديل هذه المعلومات وإزالة الجهاز الافتراضي المحدّد من خلال اللوحة.
- منطقة السجلّ تعرِض سجلّات التفاعل بين Google Home Playground وHome Graph. يمكنك توسيع السجلّات لفحص حِزم بيانات الطلب والاستجابة من أجل تحديد المشاكل وحلّها.
جهاز افتراضي
عرض معلومات الجهاز الافتراضي
في لوحة قائمة الأجهزة، اختَر الجهاز الافتراضي الذي تريد الاطّلاع عليه. في لوحة قائمة الأجهزة، اختَر الجهاز الافتراضي الذي تريد الاطّلاع عليه. ستعرض لوحة معلومات الجهاز معلوماته مقسّمة إلى خمس علامات تبويب:
- المعلومات الأساسية: تشمل السمات ذات المستوى الأعلى للجهاز، بما في ذلك نوعه ورقم تعريفه واسمه.
- السمات: سمات الجهاز المتوافقة
- السمات: سمات الجهاز المتعلّقة بالسمات
- الحالات: جميع حالات الجهاز
- التحقّق الثانوي من المستخدِم: إعداد التحقّق الثانوي من المستخدِم للجهاز
تعديل معلومات الجهاز الافتراضي
بالإضافة إلى عرض معلومات الجهاز الافتراضي، يمكنك أيضًا تعديل المعلومات المخزّنة فيه مباشرةً في Home Graph من خلال لوحة معلومات الجهاز.
تعديل السمات المتوافقة
- انقر على علامة التبويب السمات، ثم على الزر تعديل.
- في اللوحة المنبثقة، يمكنك الاطّلاع على السمات المتوافقة حاليًا للجهاز، وكذلك
السمات المتاحة لإضافتها. استخدِم زرَّي السهم
(arrow_forward/arrow_back) لإضافة سمات متوافقة للجهاز أو إزالتها. - عند الانتهاء من تعديل السمات المتوافقة، انقر على حفظ، وسيتم تطبيق السمات المعدَّلة على Home Graph.
- يمكنك الاطّلاع على تعديلات السمات هذه في منطقة السجلّ.
تعديل سمات الجهاز
- اختَر علامة التبويب السمات وعدِّل سمة السمات المتوافقة مع الجهاز.
- بعد الانتهاء من التعديل، اضغط على مفتاح Enter وسيتم تطبيق التغييرات التي أجريتها على السمات على Home Graph.
- يمكنك الاطّلاع على هذه السمات المعدَّلة في منطقة السجلّ.
تعديل حالات الأجهزة
- اختَر علامة التبويب الحالات وعدِّل الحالة مباشرةً. سيتم تطبيق التغييرات على الحالة في Home Graph.
- يمكنك الاطّلاع على تعديلات الحالة هذه في منطقة السجلّ.
إضافة إجراء ثانوي لإثبات هوية المستخدم إلى الجهاز الافتراضي
يمكنك إضافة مركبة SUV إلى الأجهزة الافتراضية وضبط نوع التحدي والسلوك المقابل له على كل جهاز. يمكنك إضافة سيارة SUV إلى الأجهزة الافتراضية وضبط نوع التحدي والسلوك المقابل له على كل جهاز.
ضبط ميزة "التحقّق الثانوي من المستخدم" على الجهاز
- في لوحة قائمة الأجهزة، اختَر الجهاز الافتراضي الذي تريد ضبطه.
- في لوحة معلومات الجهاز، اختَر علامة التبويب SUV وضبط الإعدادات التالية:
- مفعَّلة: ما إذا كانت ميزة "التحقّق الثانوي من المستخدم" مفعَّلة أو غير مفعَّلة (بدون طلب تأكيد) على الجهاز
- نوع التحدّي: يشير ذلك إلى ما إذا كان التحدّي يتطلّب تأكيدًا صريحًا (ackNeeded) أو رقم تعريف شخصي (pinNeeded).
- رقم التعريف الشخصي: رقم التعريف الشخصي الصالح.
- معالجة رقم التعريف الشخصي غير الصحيح: عندما يكون رقم التعريف الشخصي غير صحيح، يجب تحديد ما إذا كان سيتم سؤال العميل مجددًا عما إذا كان يريد إعادة المحاولة، وإذا لم يكن الأمر كذلك، يجب تحديد الخطأ الذي يجب الردّ عليه.
تحديد الأجهزة التي تتيح ميزة "التحقّق الثانوي من المستخدم"
في لوحة قائمة الأجهزة، يظهر رمز مفتاح مفتاح بجانب كل جهاز مزوّد بتقنية SUV.
تتطلّب القائمة التالية من السمات استخدام فئة المركبات الرياضية المتعددة الاستخدامات (SUV):
إنشاء جهاز افتراضي جديد
- في لوحة قائمة الأجهزة، انقر على إضافة جهاز.
- في اللوحة المنبثقة، اختَر نوع الجهاز وأدخِل اسم الجهاز لجهازك الجديد. بدلاً من ذلك، يمكنك اختيار مجموعة محدّدة مسبقًا من الأجهزة لإضافة.
- بعد إكمال جميع الخطوات، ستتم إضافة الجهاز الجديد إلى Home Graph.
إزالة جهاز افتراضي
- في لوحة قائمة الأجهزة، اختَر الجهاز الذي تريد إزالته. بعد ذلك، في لوحة معلومات الجهاز، اختَر علامة التبويب المعلومات الأساسية، ثم انقر على إزالة الجهاز في أسفل الصفحة.
- أكِّد إزالة الجهاز في التنبيه المنبثق.
- بعد تأكيد إزالة الجهاز، ستتم إزالته من Home Graph.
محرِّر استجابة المزامنة
يمكنك التحقّق من استجابة المزامنة أو تعديلها في Google Home Playground. انقر على Sync Response Editor (محرِّر الردود في المزامنة) لفتح بيئة تطوير مضمّنة.
عدِّل ردّ المزامنة أو انسخه والصقه وانقر على حفظ لتطبيق التغييرات لمعرفة كيفية عملها في منظومة Google Home المتكاملة.
استيراد الأجهزة الافتراضية وتصديرها
لتحديد المشاكل وحلّها أو إعادة إنتاجها، يمكنك تصدير أجهزتك الافتراضية مع حالاتها إلى ملف، ومشاركة الملف مع الآخرين لاستيراد أجهزتك الافتراضية ومثيلها.
تصدير الأجهزة الافتراضية إلى ملف
- انقر على لتصدير الأجهزة الافتراضية إلى ملف.
- أدخِل اسم الملف الذي تريد تصديره، ثم انقر على حسنًا.
- بعد إدخال اسم الملف، سينزِّل المتصفّح ملف الأجهزة الافتراضية التي تم تصديرها.
استيراد الأجهزة الافتراضية من ملف
- انقر على لاستيراد devices الافتراضية من ملف.
- اختَر الملف الذي تريد استيراده، ثم انقر على حسنًا.
- بعد تأكيد الملف المطلوب استيراده، ستبدأ أداة Google Home Playground في استيراد الأجهزة الافتراضية التي تتضمّن حالات من الملف، وتعديل معلومات الأجهزة التي تم استيرادها وحالاتها في Home Graph.
فحص سجلّات التفاعلات
عند التفاعل مع الأجهزة الافتراضية، يطبّق Google Home Playground التغيير تلقائيًا على Home Graph. يتم تسجيل التفاعلات مع Home Graph في لوحة منطقة السجلّ ، حيث يمكنك توسيع كل إدخال لفحص حمولات طلب Home Graph API والاستجابة.
كل إدخال في السجلّ هو مصفوفة JSON تحتوي على عناصر من البنية التالية:
{
"uri": string,
"request": object,
"response": object
}
الحقول | النوع | الوصف |
---|---|---|
uri |
string |
عنوان URL لطلب البيانات من واجهة برمجة التطبيقات Home Graph |
request |
object |
نص طلب Home Graph من واجهة برمجة التطبيقات اطّلِع على المستندات المرجعية المستندات المرجعية للاطّلاع على تنسيق كل طريقة. |
response |
object |
نص الاستجابة لطلب البيانات من واجهة برمجة التطبيقات Home Graph اطّلِع على المستندات المرجعية المستندات المرجعية للاطّلاع على تنسيق كل طريقة. |
عرض أنواع الأجهزة والسمات المتوافقة
سيؤدي النقر على رمز علامة الاستفهام المساعدة في أعلى يسار الصفحة إلى عرض نوع الجهاز الحالي وقائمة السمات المتوافقة مع Google Home Playground.
الإبلاغ عن المشاكل
يسرّنا معرفة رأيك. الإبلاغ عن المشاكل التي واجهتها باستخدام رمز علامة التعجب ملاحظات في أعلى يسار الصفحة