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