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

ملعب Google Home

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

إكمال ربط الحساب

لاستخدام 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 Playground بحسابه.

تسجيل الدخول

أطلق Home Playground بالنقر على الزر أدناه:

تشغيل "مساحة المرح"

انقر على تسجيل الدخول باستخدام حساب Google. احرص على تسجيل الدخول باستخدام الحساب نفسه الذي استخدمته في GHA لإكمال عملية ربط الحساب.

يعرض هذا الشكل الحالة الأولية لملعب Google Home،
            ويبرز زر تسجيل الدخول في أعلى يسار الشاشة.

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

يعرض هذا الشكل قائمة الأجهزة ومعلومات الجهاز ومنطقة السجل في طريقة العرض التلقائية لـ Google Home Playground.

تتألف واجهة مستخدم الويب من ثلاث لوحات:

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

جهاز افتراضي

عرض معلومات الجهاز الافتراضي

في لوحة قائمة الأجهزة، اختَر الجهاز الافتراضي الذي تريد عرضه. ستعرض لوحة معلومات الجهاز معلوماته مصنّفة إلى خمس علامات تبويب:

  • المعلومات الأساسية: خصائص الجهاز من المستوى الأعلى، بما في ذلك نوع الجهاز والمعرّف والاسم.
  • السمات: سمات الجهاز المتوافقة.
  • السمات: سمات الجهاز المحدّدة للسمات.
  • الحالات: جميع حالات الأجهزة
  • SUV: تهيئة التحقق من المستخدم الثانوي للجهاز.

تعديل معلومات الجهاز الافتراضي

بالإضافة إلى عرض معلومات الجهاز الافتراضي، يمكنك أيضًا تعديل معلوماته المخزنة مباشرةً في Home Graph عبر لوحة معلومات الجهاز.

تعديل السمات المدعومة

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

تعديل سمات الجهاز

  1. حدد علامة التبويب المعلومات/السمات الأساسية، وعدّل السمة للسمات التي يسمح بها الجهاز.
  2. بعد الانتهاء من التعديل، اضغط على Enter وسيتم تطبيق تغييرات السمات على Home Graph.
  3. يمكنك الاطّلاع على هذه السمات المعدّلة في منطقة السجلّ.

تعديل حالات الجهاز

  1. اختيار علامة التبويب الحالات وتعديل الولاية مباشرةً سيتم تطبيق تغييرات الحالة على Home Graph.
  2. يمكنك عرض تعديلات الحالة هذه في منطقة السجلّ.

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

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

ضبط SUV على الجهاز

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

تحديد الأجهزة التي تمكّن SUV

في لوحة قائمة الأجهزة، يظهر رمز مفتاح مفتاح بجوار كل جهاز به SUV.

يعرض هذا الشكل الأجهزة الموصى بها لتفعيل التحقق الثانوي من المستخدم.

تتطلب قائمة السمات التالية استخدام سيارات الدفع الرباعي:

إنشاء جهاز افتراضي جديد

  1. في لوحة قائمة الأجهزة، انقر على إضافة جهاز.
  2. في اللوحة المنبثقة، حدد نوع الجهاز وأدخل اسم الجهاز الجديد. بدلاً من ذلك، يمكنك تحديد مجموعة محددة مسبقًا من الأجهزة لإضافتها.
  3. بعد إكمال جميع الخطوات، ستتم إضافة الجهاز الجديد إلى Home Graph.
يعرض هذا الشكل أداة تجربة المستخدم لإضافة نوع جهاز جديد في "مساحة المرح" في Google Home.

إزالة جهاز افتراضي

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

استيراد الأجهزة الافتراضية وتصديرها

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

يعرض هذا الشكل أداة تجربة المستخدم لاستيراد الأجهزة الافتراضية وتصديرها في Google Home Playground.

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

  1. انقر على لتصدير الأجهزة الافتراضية إلى ملف.
  2. أدخل اسم الملف الذي تريد تصديره، وانقر على موافق.
  3. بعد إدخال اسم الملف، سينزِّل المتصفح ملف الأجهزة الافتراضية التي تم تصديرها.

استيراد أجهزة افتراضية من ملف

  1. انقر على لاستيراد أجهزة افتراضية من ملف.
  2. حدد الملف الذي تريد استيراده، وانقر على موافق.
  3. بعد تأكيد استيراد الملف، سيستورد Home Playground الأجهزة الافتراضية مع حالات من الملف، وسيحدِّث معلومات وحالات الأجهزة المستوردة في Home Graph.

فحص سجلات التفاعل

عند تفاعلك مع الأجهزة الافتراضية، يطبّق 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. يمكنك الاطّلاع على المستندات المرجعية لمعرفة تنسيق كل طريقة.

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

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

يعرض هذا الشكل أداة تجربة المستخدم لإضافة نوع جهاز جديد في "مساحة المرح" في Google Home.

التعليقات والإبلاغ عن المشاكل

نود أن نعرف رأيك! يمكنك إرسال تعليقاتك إلينا بالنقر على رمز الوجه المبتسم sentiment_satisfi في أعلى يسار الشاشة، أو الإبلاغ عن المشاكل باستخدام رمز علامة التعجب التعليقات.

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