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