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