iframe của tính năng 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 tác vụ trong Lớp học. Tệp đính kèm là nội dung hoặc hoạt động mà bạn dự định để học viên tương tác.
Trong một khoá học trên Lớp học, giáo viên tạo một bài đăng mới (ví dụ: bài tập, thông báo hoặc câu hỏi) rồi 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 sẽ cho phép tiện ích bổ sung thêm tệp đính kèm vào bài đăng.
Hình 1. Khung hiển thị một bài tập đã tạo, bao gồm các tuỳ chọn 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 iframe Khám phá tệp đính kèm và tải URL chạy của tiện ích bổ sung đó. Mọi tham số truy vấn iframe có liên quan đều được truyền đến URL khởi 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ử 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 các 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 này sẽ gửi một 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 tệp đính kèm bổ sung loại hoạt động.
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 tài khoản.
- Giáo viên phải có thể xem trước tệp đính kèm trong iframe trước khi đưa ra lựa chọn cuối cùng.
- Giáo viên có thể tìm kiếm hoặc duyệt qua nội dung có thể đính kèm.
- Tiện ích bổ sung này có thể cung cấp một loạt chế độ xem, chẳng hạn như nội dung gần đây, nội dung của tôi và lọc theo kỹ năng học tập.
- Tiện ích bổ sung phải cho phép tạo một mục mới có thể đính kèm từ bên trong iframe.
Hãy xem danh sách kiểm tra các yêu cầu của tiện ích bổ sung Lớp học để biết thêm thông tin 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 giấy phép nhưng giáo viên lại không có giấy phép, thì giáo viên phải nhận được một thông báo rõ ràng để thông báo về các bước tiếp theo thích hợp để khắc phục tình huống. Điều này nhằm tránh mọi nhầm lẫn có thể phát sinh do các quy định hạn chế về việc cấp 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 iframe Khám phá tệp đính kèm.
- Ẩn hoặc tắt nội dung không được cung cấp cho giáo viên do các quy định hạn chế về cấp độ cấp phép.