iframe การค้นพบไฟล์แนบเป็นมุมมองเริ่มต้นที่ครูจะเห็นเมื่อเปิดส่วนเสริมในระหว่างการสร้างงานของ Classroom ไฟล์แนบคือเนื้อหาหรือกิจกรรมที่คุณตั้งใจให้นักเรียนโต้ตอบด้วย
จากภายในหลักสูตรของ Classroom ครูสร้างโพสต์ใหม่ (เช่น งาน ประกาศ หรือคำถาม) และเลือกส่วนเสริมจากรายการแบบเลื่อนลงของส่วนเสริม Classroom จะอนุญาตให้ส่วนเสริมเพิ่มไฟล์แนบในโพสต์ได้ในช่วงเวลาสั้นๆ (ตามชั่วโมง)
รูปที่ 1. มุมมองการสร้างงาน ซึ่งรวมถึงตัวเลือกส่วนเสริมที่ครูสามารถแนบได้
เมื่อครูเลือกส่วนเสริมแล้ว Classroom จะสร้าง iframe ของการค้นพบไฟล์แนบและโหลด URL เปิดใช้งานของส่วนเสริม พารามิเตอร์การค้นหาของ iframe ที่เกี่ยวข้องจะส่งไปยัง URL เปิดใช้งาน
รูปที่ 2 ตัวอย่าง UI ของการค้นหาไฟล์แนบใน iframe
ครูจะใช้เว็บแอปพลิเคชันของพาร์ทเนอร์ใน iframe เพื่อเลือกไฟล์แนบ แอปจะเรียกใช้ Classroom API เพื่อแนบไฟล์แนบไปกับงาน เมื่อครูเลือกไฟล์แนบเสร็จแล้ว ส่วนเสริมจะส่งเปย์โหลด postMessage เพื่อขอให้ปิด iframe
iframe จะปิดและครูอาจเห็นไฟล์แนบซึ่งสามารถเลือกดูตัวอย่างหรือนำออกจากงานได้
รูปที่ 3 มุมมองการสร้างงานที่มีไฟล์แนบของส่วนเสริม 3 ประเภท
ข้อควรพิจารณาเกี่ยวกับ UX ภายใน iframe
- เมื่อเปิดครั้งแรก ส่วนเสริมจะต้องแจ้งให้ครูลงชื่อเข้าใช้
- ต้องลงชื่อเพียงครั้งเดียวของ Google สำหรับการเรียก Classroom API ทั้งหมด หากผลิตภัณฑ์ของคุณมีระบบการเข้าสู่ระบบแยกต่างหาก คุณต้องลิงก์บัญชี
- ครูจะต้องดูตัวอย่างไฟล์แนบใน iframe ได้ก่อนที่จะทำการเลือกขั้นสุดท้าย
- ครูควรสามารถค้นหาหรือเรียกดูเนื้อหาที่แนบได้
- ส่วนเสริมอาจแสดงมุมมองต่างๆ เช่น เนื้อหาล่าสุด เนื้อหาของฉัน และการกรองตามทักษะการเรียนรู้
- ส่วนเสริมต้องมีความสามารถในการสร้างรายการที่แนบใหม่ได้จากภายใน iframe
ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อกำหนด UX ได้ในรายการตรวจสอบข้อกำหนดส่วนเสริมของ Classroom
แสดงสถานะการออกใบอนุญาตภายใน iframe
หากส่วนเสริมต้องใช้ใบอนุญาตแต่ครูไม่มี ให้ต้องแสดงข้อความที่ชัดเจนต่อครูเพื่อแจ้งให้ทราบถึงขั้นตอนถัดไปที่เหมาะสมเพื่อแก้ไขปัญหา ทั้งนี้เพื่อป้องกันความสับสนที่อาจเกิดขึ้นจากข้อจำกัดในการอนุญาตให้ใช้สิทธิ
นอกจากนี้ เรายังขอแนะนำให้ส่วนเสริมของคุณดำเนินการดังนี้
- แสดงระดับการอนุญาตให้ใช้สิทธิของครูภายใน iframe การค้นหาไฟล์แนบ
- ซ่อนหรือปิดใช้เนื้อหาที่ครูไม่พร้อมใช้งานเนื่องจากข้อจำกัดระดับใบอนุญาต