iframe của chế độ Khám phá tệp đính kèm là chế độ xem ban đầu mà giáo viên nhìn thấy khi mở một tiện ích bổ sung trong quá trình tạo việc cần làm trong Lớp học. Một tệp đính kèm là nội dung hoặc hoạt động mà bạn định cho học viên xem tương tác với.
Từ trong một khoá học trên Lớp học, một giáo viên sẽ tạo một bài đăng mới (ví dụ: ví dụ: một bài tập, thông báo hoặc câu hỏi) và chọn một tiện ích bổ sung trong danh sách tiện ích bổ sung thả xuống. Trong một khoảng thời gian ngắn (theo thứ tự giờ), Lớp học cho phép tiện ích bổ sung thêm tệp đính kèm vào bài đăng.
Hình 1. Chế độ xem của một
tạo bài tập, bao gồm cả những tiện ích bổ sung mà giáo viên có thể đính kèm.
Sau khi giáo viên chọn một tiện ích bổ sung, Lớp học sẽ tạo một Tệp đính kèm Khám phá iframe và tải URL chạy của tiện ích bổ sung. Bất kỳ truy vấn iframe nào có liên quan tham số mới được truyền đến URL chạy.
Hình 2. Ví dụ về giao diện người dùng khám phá tệp đính kèm trong iframe.
Giáo viên sẽ sử dụng ứng dụng web của đối tác trong iframe để chọn một
tệp đính kèm. Ứng dụng thực hiện lệnh gọi API Lớp học để đính kèm tệp đính kèm
vào bài tập. Khi giáo viên chọn xong tệp đính kèm,
tiện ích bổ sung gửi tải trọng postMessage yêu cầu đóng iframe.
iframe đóng lại và lúc này giáo viên có thể thấy các tệp đính kèm mà họ có thể chọn xem trước hoặc xoá khỏi bài tập.
Hình 3. Khung hiển thị một bài tập đã tạo với 3 tiện ích bổ sung cho loại hoạt động tệp đính kèm.
Những điều cần cân nhắc về trải nghiệm người dùng trong iframe
- Vào lần mở đầu tiên, tiện ích bổ sung phải nhắc giáo viên đăng nhập.
- Mọi lệnh gọi API Lớp học đều phải đăng nhập một lần bằng Google. Nếu sản phẩm của bạn có hệ thống đăng nhập riêng biệt, bạn phải liên kết các tài khoản.
- Giáo viên phải có thể xem trước tệp đính kèm trong iframe trước đưa ra lựa chọn cuối cùng.
- Giáo viên phải có thể tìm kiếm, duyệt qua, đính kèm được nội dung.
- Tiện ích bổ sung này có thể cung cấp nhiều chế độ xem như nội dung gần đây, nội dung và lọc theo kỹ năng học tập.
- Tiện ích bổ sung này phải cho phép tạo một mục mới có thể đính kèm từ trong iframe.
Hãy xem danh sách kiểm tra các yêu cầu của tiện ích bổ sung trên Lớp học để biết thêm chi tiết về các yêu cầu về trải nghiệm người dùng.
Hiển thị trạng thái cấp phép trong iframe
Nếu tiện ích bổ sung đó yêu cầu phải có giấy phép nhưng giáo viên lại không có giấy phép, thì hãy thông báo phải được hiển thị cho giáo viên để thông báo cho họ về các bước để khắc phục tình hình. Việc này giúp tránh mọi nhầm lẫn có thể phát sinh do các quy định hạn chế về giấy phép.
Tiện ích bổ sung của bạn cũng nên:
- Hiển thị cấp độ cấp phép của giáo viên trong phần Khám phá tệp đính kèm iframe.
- Ẩn hoặc tắt nội dung giáo viên không xem được do giấy phép cấp độ.