Khung hiển thị trong dòng (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ở 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 thả xuống tiện ích bổ sung (Hình 1).
Hình 1. Chế độ xem của một bài tập được tạo, bao gồm cả các lựa 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 iframe có liên quan đều được truyền đến URL khởi chạy (Hình 2).
Hình 2. Ví dụ về giao diện người dùng phát hiện tệp đính kèm trong iframe.
Hãy xem chế độ xem Khám phá tệp đính kèm như trang đích cho giáo viên trong tiện ích bổ sung của bạn. Thông thường, giáo viên sẽ sử dụng ứng dụng web của đối tác trong iframe để chọn nội dung đính kèm vào mục trong luồng. Ứng dụng tiện ích bổ sung có thể hạn chế nội dung được hiển thị, tuỳ thuộc vào việc mục trên luồng là thông báo, bài tập hay tài liệu khoá học. Sau đó, ứng dụng bổ trợ sẽ thực hiện các lệnh gọi Classroom API để tạo và đính kèm tệp đính kèm vào bài tập.
Khi giáo viên chọn và tạo 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. Khung nội tuyến sẽ đóng và giáo viên sẽ thấy các tệp đính kèm. Sau đó, họ có thể chọn xem trước hoặc xoá các tệp đính kèm đó khỏi bài tập (Hình 3). Giáo viên hoàn tất quy trình tạo bằng cách giao mục trên bảng tin cho học viên.
Hình 3. Chế độ xem của một bài tập được tạo có 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
- 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 sử dụng tính năng đăng nhập một lần của Google cho tất cả các lệnh gọi đến Classroom API. Nếu sản phẩm của bạn 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 có thể tìm kiếm hoặc duyệt xem nội dung có thể đính kèm.
- Tiện ích bổ sung này có thể cung cấp nhiều 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 có khả năng tạo một mục có thể đính kèm mới 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 về các yêu cầu đối với trải nghiệm người dùng.
Trạng thái cấp phép
Nếu tiện ích bổ sung của bạn yêu cầu sản phẩm phải có giấy phép, thì bạn nên hiển thị một thông báo rõ ràng để giải thích cách giáo viên không có giấy phép có thể khắc phục tình trạng này. Bạn cũng nên cân nhắc việc ẩn hoặc tắt nội dung mà giáo viên không thể sử dụng do các quy định hạn chế về việc cấp phép.