إطار iframe لميزة "اكتشاف المرفقات" هو العرض الأولي الذي يظهر للمعلّم عند فتح إضافة أثناء إنشاء مهمة في Classroom. المرفق هو المحتوى أو النشاط الذي تريد أن يتفاعل معه الطلاب.
من داخل دورة تدريبية في Classroom، ينشئ المعلّم مشاركة جديدة (مثل مهمة دراسية أو إشعار أو سؤال) ويختار إحدى الإضافات من القائمة المنسدلة للإضافات (الشكل 1).
الشكل 1: عرض لإنشاء مهمة
يتضمّن خيارات الإضافة المحتملة التي يمكن لأستاذ
إرفاقها
بعد أن يختار المعلّم إضافة، تنشئ أداة Classroom إطارًا iframe لميزة "اكتشاف المرفقات" و تحمّل عنوان URL لبدء تشغيل الإضافة. يتمّ تمرير أيّ مَعلمات طلب بحث في إطار iframe ذات صلة إلى عنوان URL لبدء التطبيق (الشكل 2).
الشكل 2: مثال على واجهة مستخدم اكتشاف المرفقات في إطار iframe
يمكنك اعتبار طريقة العرض "اكتشاف المرفقات" هي الصفحة المقصودة للمعلّمين في إضافة التدريس. يستخدم المعلّم عادةً تطبيق الويب الخاص بالشريك ضمن إطار iframe لاختيار المحتوى الذي يريد إرفاقه بعنصر البث. قد يفرض تطبيق الإضافة قيودًا على المحتوى الذي يتم عرضه استنادًا إلى ما إذا كان عنصر البث عبارة عن إشعار أو واجب دراسي أو مادة دراسية. بعد ذلك، يُجري تطبيق الإضافة طلبات بيانات من واجهة برمجة التطبيقات في Classroom لإنشاء المرفق وإرفاقه بالواجب الدراسي.
عندما ينتهي المعلّم من اختيار المرفقات وإنشائها، تُرسِل الإضافة حمولة postMessage تطلب إغلاق الإطار المضمّن. يتم إغلاق إطار iframe ويظهر للمعلّم عندها المرفقات التي يمكنه اختيار معاينتها أو إزالتها من الواجب الدراسي (الشكل 3). يُكمل المعلّم عملية الإنشاء من خلال منح
الطلاب عنصر بثّ.
الشكل 3: عرض لإنشاء مهمة دراسية مع ثلاثة مرفقات إضافية من نوع النشاط
اعتبارات متعلقة بتجربة المستخدم
- عند فتح الإضافة لأول مرة، يجب أن تطلب من المعلّم تسجيل الدخول.
- يجب تفعيل ميزة "تسجيل الدخول المُوحَّد من Google" لجميع طلبات البيانات من Classroom API. إذا كان منتجك يستخدم نظام تسجيل دخول منفصلاً، يجب ربط الحسابات.
- يجب أن يتمكّن المعلّم من معاينة مرفق داخل إطار iframe قبل إجراء اختياره النهائي.
- يجب أن يتمكّن المعلّم من البحث عن المحتوى القابل للتضمين أو تصفّحه.
- قد تقدّم الإضافة مجموعة متنوعة من طرق العرض، مثل المحتوى الأخير والمحتوى الخاص بي والفلترة حسب المهارات التعليمية.
- يجب أن تتيح الإضافة إنشاء عنصر جديد قابل للدمج من داخل إطار iframe.
اطّلِع على قائمة التحقّق من المتطلبات الخاصة بإضافات Classroom للحصول على مزيد من التفاصيل حول متطلبات تجربة المستخدم.
حالة الترخيص
إذا كانت الإضافة تتطلّب ترخيصًا لمنتجك، يجب عرض رسالة واضحة توضّح كيفية حلّ المشكلة التي يواجهها المعلّم الذي ليس لديه ترخيص. ننصحك أيضًا بإخفاء المحتوى الذي لا يمكن للمعلّم الوصول إليه بسبب قيود الترخيص أو إيقافه.