iframe Khám phá tệp đính kèm là chế độ xem ban đầu mà giáo viên nhìn thấy khi mở tiện ích bổ sung trong quá trình tạo việc cần làm 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 khoá học của 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) và chọn một tiện ích bổ sung trong danh sách thả xuống về tiện ích bổ sung. 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ị quá trình tạo bài tập, bao gồm các lựa chọn 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 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 chuyể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 tệp đính kèm. Ứng dụng này 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 tải trọng postMessage yêu cầu đóng iframe.
iframe đóng lại và giáo viên lúc này có thể nhìn 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ị quá trình tạo bài tập có 3 tệp đính kèm của tiện ích bổ sung loại hoạt động.
Những điểm cần cân nhắc về trải nghiệm người dùng trong iframe
- Khi mở lần đầu, tiện ích bổ sung phải nhắc giáo viên đăng nhập.
- Tất cả lệnh gọi API Lớp học đều phải sử dụng tính năng đăng nhập một lần của Google. Nếu sản phẩm có một 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 xem trước đượ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 khác nhau, chẳng hạn 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 cung cấp khả năng tạo một mục có thể đính kèm mới từ bên trong iframe.
Hãy xem danh sách kiểm tra 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 không có giấy phép, thì giáo viên phải thấy một thông báo rõ ràng để giáo viên biết các bước tiếp theo cần thực hiện để giải quyết trường hợp này. Điều này giúp tránh mọi nhầm lẫn có thể phát sinh từ các quy định hạn chế về việc cấp phép.
Bạn cũng nên sử dụng tiện ích bổ sung:
- Hiển thị 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 mà giáo viên không xem được do các hạn chế về cấp độ giấy phép.