ملاحظة مهمّة: يجب أن تكون مشتركًا في "برنامج الإصدار التجريبي من Matter Private" لبدء تطوير أجهزة وتطبيقات Matter من خلال وحدة تحكّم مطوّري البرامج في Google Home. تقديم طلب الآن

مجموعة أدوات اختبار Google Home

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

تشمل الاختبارات التي يتم إجراؤها من خلال Test Suite، على سبيل المثال لا الحصر، ما يلي:

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

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

يمكنك تشغيل أداة Test Suite بالنقر على الزر أدناه:

إطلاق Test Suite

اختبار الإجراء بنفسك

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

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

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

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

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

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

    3. إذا كنت تستخدم سمة Scene (مَشاهد)، اختَر اختبار سمة 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 غير صالح" مع {"error": "invalid_grant"} على طلب غير صالح لإعادة تحميل الرمز المميز. إذا لم يتطابق الرد مع "رمز الخطأ" أو "الرسالة" أو "الخطأ"، لن تنجح حالة الاختبار هذه. للحصول على مزيد من المعلومات، يمكنك الانتقال إلى تبادل الرموز المميزة لإعادة تحميل الرموز المميزة.
يمكنك إجراء اختبار لمعرفة ما إذا تم تعديل رمز الدخول بعد إعادة تحميل الرمز المميّز. يجب عرض رموز الدخول الجديدة استجابةً لطلبات إعادة تحميل الرموز المميّزة. إذا كان الخادم يوفّر رمز الدخول نفسه، ستتعذّر حالة الاختبار.
تأكّد من أنّ رمز الدخول الذي انتهت صلاحيته لا يزال صالحًا. سيتم عرض وقت انتهاء صلاحية رمز الدخول.
تحقَّق مما إذا كان قد تم استبدال الرمز المميّز لإعادة التحميل أثناء إعادة التحميل. نتحقّق مما إذا كان قد تم تغيير الرموز المميّزة لإعادة التحميل بعد طلب إعادة تحميل الرمز المميّز. وإذا تغيّر الرمز المميّز لإعادة التحميل، على الخادم ألّا يتم إبطال الرمز المميّز لإعادة التحميل إلا بعد استخدام رمز مميّز جديد لإعادة التحميل، وذلك لتجنّب حالات السباق التي قد تؤدي إلى إيقاف ربط حساب المستخدم. وسيتعذّر الاختبار إذا تم إبطال الرمز المميز لإعادة التحميل القديم قبل استخدام الرمز الجديد.

رسائل خطأ

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

رسالة الخطأ كيفية حلّ المشكلة
عدم استخدام واجهة HomeGraph API في المشروع <_id_> قبل أو يتم إيقافه تأكد من تفعيل HomeGraph API.
لم يتم العثور على الكيان المطلوب تحقّق من أنّ agentUserId صالح ومرتبط بالخدمة.
تأكّد من أن لديك إذن resourcemanager.projects.get في المشروع ${your project id} ومن أنك حصلت على جميع الأذونات في شاشة طلب الموافقة.
  1. اتّبِع التعليمات الواردة في تحديد مشاكل أذونات إدارة الهوية وإمكانية الوصول وحلّها للتأكّد من أن حسابك لديه أذونات resourcemanager.projects.get للمشروع.
  2. انتقِل إلى صفحة التطبيقات التي يمكنها الوصول إلى حسابك للتحقّق من الأذونات التالية لـ &quotحزمة خدمات اختبار المنازل المنزلية&الذكية:
    • معلومات الحساب الأساسية
      1. الاطّلاع على عنوان البريد الإلكتروني الرئيسي لحسابك على Google
      2. الاطّلاع على بياناتك الشخصية، بما في ذلك أيّ بيانات شخصية أتاحتها للجميع
    • إمكانية الوصول الإضافي
      1. استخدام Assistant: إمكانية وصول واسع النطاق إلى حسابك على Google
      2. التحقق من الأجهزة المنزلية الذكية والتحكّم فيها في قاعدة البيانات الرئيسية
    في حال عدم توفّر أي مستخدم، عليك إزالة إمكانية الوصول أولاً ومنح جميع الأذونات في شاشة طلب الموافقة عند تسجيل الدخول مرة أخرى.

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

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

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

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