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