مجموعة أجهزة Smart Home Test

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

تشمل الاختبارات التي يتم تنفيذها بواسطة مجموعة الاختبار، على سبيل المثال لا الحصر، ما يلي:

  • تأكّد من تنفيذ حالة التقرير وطلب المزامنة للأجهزة والسمات.

  • يتحقق من أن القصد من QUERY تم تنفيذه لجهازك وأن نتائجه تتطابق مع نتائج حالة التقرير.

يمكنك إطلاق أداة الاختبار بالنقر على الزر أدناه:

إطلاق حزمة الاختبار

اختبار ذاتي للحركة

يصف القسم التالي كيفية تشغيل حزمة الاختبار على جهازك ومشاريع الإجراءات المنزلية الذكية. تتطلب حزمة الاختبار تسجيل الدخول للتمكّن من فحص الأجهزة المتوفّرة في قاعدة البيانات الرئيسية وإرسال الطلبات مباشرةً إلى "مساعد Google".

لاختبار الإجراء بنفسك، اتّبِع الخطوات التالية:

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

  3. اضبط تفاصيل المشروع:

    1. في حقل رقم تعريف المشروع، أدخِل معرّف المشروع لإجراءاتك المنزلية الذكية.
    2. انقر على التالي.
  4. اضبط إعدادات الاختبار:

    1. في حال اعتماد إجراء المنزل الذكي، اترك القيمة التلقائية لحالة الإبلاغ/مهلة المزامنة بدون تغيير. ومع ذلك، للاختبار، يمكنك تغيير قيمة المهلة إذا استغرق الوكيل المزيد من الوقت لإبلاغ "الحالة" بالرسم البياني الرئيسي.
    2. عند اعتماد إجراء المنزل الذكي، تأكّد من أن خيار اختبار طلب المزامنة مفعّل، أثناء الاختبار، سيُطلب منك إضافة جهاز أو تحديثه أو إزالته والتحقق مما إذا كانت قائمة الأجهزة قد تغيّرت في الرسم البياني الرئيسي. يتم تنفيذ الإجراءات من خلال الدمج الذي تختبره. يجب دائمًا أن تتضمّن عملية الدمج الخاضعة للاختبار جهازًا واحدًا على الأقل مُرفقًا بالمستخدم الوكيل.

    3. إذا كنت تستخدم سمة Scene (المشهد)، اختَر اختبار سمة المشهد.

  5. إجراء اختبار تشغيل وعرض النتائج:

    1. انقر على التالي لبدء إجراء الاختبارات. وتعرض الواجهة الأجهزة والسمات التي يتم اختبارها.
  6. الاطّلاع على صفحة النتائج &الإرسال:

    1. بعد اكتمال الاختبارات، انقر على التالي لعرض النتائج.

وتشمل نتائج الاختبار عدد الاختبارات التي تم اجتيازها والتي تعذّر اجتيازها، بالإضافة إلى نتيجة نهائية تشير إلى النسبة المئوية لاجتياز الاختبارات.

اختبار التحقق من ربط الحساب

يؤدّي ربط الحساب دورًا مهمًا في منظومة المنزل الذكية من Google. يتحقّق اختبار التحقّق من ربط الحساب في Test Suite من خدمة OAuth بحثًا عن أي مشاكل محتملة.

يحتوي اختبار التحقق من ربط الحساب على اختبارات للتحقق من رموز الدخول وإعادة تحميل الرموز المميزة:

اختبار التحقق من رمز الدخول

يتم اختبار رموز الدخول التي يتم عرضها من نقطة نهاية استبدال الرمز المميز للتأكد من أنها ذات تنسيق صالح ويتم عرضها باستخدام رمز مميز صالح لإعادة التحميل.

عناصر الاختبار الشرح
التحقّق مما إذا كان رمز الدخول بتنسيق JWT لا تقترح ميزة ربط حساب Google رموز الدخول إلى تنسيق JWT. في حال العثور على تنسيق JWT، يتم عرض التحذير التالي: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
تحقَّق من أنّ رمز الدخول الذي تنتهي صلاحيته يتضمن رمزًا مميزًا لإعادة التحميل. يجب تقديم رمز الدخول المميز عندما تنتهي صلاحية رمز الدخول. لن ينجح هذا الاختبار في حال عدم العثور على رمز إعادة التحميل.

إعادة تحميل اختبار التحقق من الرمز المميز

ويتم اختبار إعادة تحميل الرموز المميّزة للتأكّد من أن نقطة نهاية تبادل الرموز المميّزة تستبدلها بشكل صحيح برموز دخول جديدة.

عناصر الاختبار الشرح
الرمز المميز لإعادة التحميل مع الرمز المميز لإعادة التحميل غير صالح، جارٍ التحقق من استجابة الشريك. من المفترض أن يعرض الخادم الخطأ HTTP 400 Invalid Request (طلب غير صالح في HTTP) مع {"error": "invalid_grant"} إلى طلب غير صالح لإعادة تحميل الرمز المميز. وإذا لم يتطابق الرد مع &رمز الخطأ أو رسالة الخطأ، ستفشل حالة الاختبار هذه. لمزيد من المعلومات، يُرجى الانتقال إلى تبديل الرموز المميَّزة لإعادة تحميل رموز الدخول.
اختبِر ما إذا تم تعديل رمز الدخول بعد إعادة تحميل الرمز المميز. يجب عرض رموز الدخول الجديدة استجابةً لطلبات الرمز المميز لإعادة التحميل. إذا كان الخادم يوفر رمز الدخول نفسه، ستفشل حالة الاختبار.
تحقَّق مما إذا كان رمز الدخول الذي لا تنتهي صلاحيته لا يزال صالحًا. سيتم عرض وقت انتهاء صلاحية رمز الدخول.
تحقق مما إذا كان قد تم تدوير رمز إعادة التحميل أثناء إعادة التحميل. نراجع ما إذا تم تغيير الرموز المميزة لإعادة التحميل بعد طلب الرمز المميز لإعادة التحميل أم لا. في حال تغيير الرمز المميّز لإعادة التحميل، يجب أن يُلغي الخادم صلاحية الرمز المميز لإعادة التحميل القديم فقط بعد استخدام الرمز المميز الجديد لإعادة التحميل، وذلك لمنع حالات السباق التي قد تؤدي إلى إيقاف ربط حساب المستخدم. وسيتعذّر الاختبار إذا ألغيت صلاحية الرمز المميّز القديم لإعادة التحميل قبل استخدام الرمز الجديد.

رسائل خطأ

يسرد الجدول التالي بعض رسائل الخطأ الشائعة التي قد تواجهك، والطريقة المقترحة لحلها.

رسالة الخطأ كيفية الحل
لم يتم استخدام واجهة Home Graph API في المشروع <_id_> قبل أو إيقافه تأكّد من تفعيل HomeGraph API.
لم يتم العثور على الكيان المطلوب تحقّق من أنّ agentUserId صالحة ومرتبطة بالخدمة.

إرسال نتائج الاختبار

يجب أن تجتاز نتائج مجموعة أدوات الاختبار 100% من الاختبارات قبل إرسال نموذج الشهادة. إذا كانت لديك أي سمات تتطلّب اختبارًا يدويًا، يبقى عليك تشغيل أداة مجموعة الاختبار وإرفاق النتيجة حتى إذا لم تجتاز 100%.

لإرسال نتائج الاختبار والإقرار بإجراءك الذكي في المنزل، اتّبِع الخطوات التالية:

  1. بعد أن تتلقّى نتائج الاختبار وتكون مستعدًا لاعتماد الإجراء المنزلي الذكي، انقر على إرسال في أداة مجموعة أدوات الاختبار.
  2. انقر على الزر تنزيل نتائج الاختبار لاسترداد نتائج الاختبار.
  3. انقر على الانتقال إلى نموذج الإرسال لإرسال نتائج الاختبار إلى Google.
  4. املأ جميع الحقول المطلوبة، ثم انقر على إرسال.