iframe Khám phá tệp đính kèm là chế độ xem ban đầu hiển thị cho giáo viên khi mở một tiện ích bổ sung trong quá trình tạo bài tập trên 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 dạng trình đơn thả xuống. Trong một khoảng thời gian ngắn (khoảng vài 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 quá trình tạo bài tập, 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 khởi chạy của tiện ích bổ sung đó. Mọi tham số truy vấn khung hiển thị nội tuyến 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 một 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 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.
- Bạn phải đăng nhập bằng một thông tin đăng nhập của Google cho tất cả các lệnh gọi API Lớp học. Nếu sản phẩm của bạn có hệ thống đăng nhập riêng, 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 khi đưa ra lựa chọn cuối cùng.
- Giáo viên phải 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 nhiều chế độ xem như nội dung gần đây, nội dung của tôi và bộ 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 đối với tiện ích bổ sung cho Lớp học để biết thêm thông tin chi tiết về các yêu cầu đối với 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 từ 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 phép của giáo viên trong khung hiển thị nội tuyến của tính năng 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.