iframe کشف پیوست، نمای اولیه ای است که هنگام باز کردن یک افزونه در حین ایجاد یک کار کلاس درس به معلم نشان داده می شود. پیوست محتوا یا فعالیتی است که قصد دارید دانش آموزان با آن تعامل داشته باشند.
از درون یک دوره Classroom، یک معلم یک پست جدید (به عنوان مثال، یک تکلیف، اطلاعیه یا سوال) ایجاد می کند و یک افزونه را از لیست کشویی برافزا انتخاب می کند (شکل 1).
شکل 1. نمای ایجاد تکلیف شامل گزینه های احتمالی افزودنی که معلم می تواند ضمیمه کند.
وقتی معلم افزونه‌ای را انتخاب کرد، Classroom یک iframe کشف پیوست ایجاد می‌کند و URL راه‌اندازی افزونه را بارگیری می‌کند. هر پارامتر مربوط به پرس و جوی iframe به URL راه اندازی ارسال می شود (شکل 2).
شکل 2. نمونه ای از یک رابط کاربری کشف پیوست در iframe.
نمای اکتشاف پیوست را به عنوان صفحه مقصد معلمان در افزونه خود در نظر بگیرید. به طور معمول، معلم از برنامه وب شریک در داخل iframe برای انتخاب محتوا برای پیوست کردن به آیتم جریان خود استفاده می کند. برنامه افزودنی ممکن است بسته به اینکه مورد جریان یک اطلاعیه، تکلیف یا مطالب دوره باشد، محتوای نمایش داده شده را محدود کند. سپس برنامه افزودنی فراخوانی های Classroom API را برای ایجاد و پیوست به تکلیف ایجاد می کند.
وقتی معلم انتخاب و ایجاد پیوست‌ها را به پایان رساند، افزونه یک بار postMessage ارسال می‌کند و درخواست می‌کند iframe بسته شود. iframe بسته می‌شود و معلم پیوست‌ها را می‌بیند، که ممکن است آن‌ها را برای پیش‌نمایش یا حذف از تکلیف انتخاب کنند (شکل 3). معلم با اختصاص دادن آیتم جریان به دانش آموزان خود، جریان ایجاد را تکمیل می کند.
شکل 3. نمای ایجاد یک تکلیف با سه پیوست افزودنی از نوع فعالیت.
ملاحظات تجربه کاربر
- در باز شدن اولیه، افزونه باید از معلم بخواهد که وارد سیستم شود.
- برای همه تماس‌های API Classroom، یک ورود به سیستم Google الزامی است. اگر محصول شما دارای سیستم ورود جداگانه است، باید حساب ها را پیوند دهید.
- یک معلم باید بتواند پیش‌نمایش یک پیوست را در iframe قبل از انتخاب نهایی خود مشاهده کند.
- یک معلم باید بتواند محتوای قابل پیوست را جستجو یا مرور کند.
- این افزونه ممکن است نماهای مختلفی مانند محتوای اخیر، محتوای من، و فیلتر با مهارت های یادگیری ارائه دهد.
- این افزونه باید توانایی ایجاد یک آیتم قابل پیوست جدید از داخل iframe را ارائه دهد.
برای جزئیات بیشتر در مورد الزامات تجربه کاربر، چک لیست الزامات افزونه Classroom را ببینید.
وضعیت صدور مجوز
اگر افزونه شما نیاز به مجوز برای محصول شما دارد، باید یک پیام واضح نشان داده شود تا توضیح دهد چگونه یک معلم بدون مجوز می تواند این وضعیت را اصلاح کند. همچنین پنهان کردن یا غیرفعال کردن محتوایی را که به دلیل محدودیت‌های صدور مجوز برای معلم در دسترس نیست، در نظر بگیرید.