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 muốn 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 phát hiện tệp đính kèm trong một 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 sẽ đóng và giáo viên có thể xem 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. Chế độ xem của một bài tập được tạo bằng 3 tệp đính kèm tiện ích bổ sung thuộc 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
- Khi mở lần đầu, 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 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 có thể cung cấp nhiều chế độ xem 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 cung cấp khả năng tạo một mục đính kèm mới từ 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 và giáo viên không có giấy phép, thì phải hiển thị cho giáo viên một thông báo rõ ràng để thông báo cho họ về các bước tiếp theo phù 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 mà giáo viên không xem được do các quy định hạn chế về cấp phép.