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