Element iframe wykrywania załączników to początkowy widok wyświetlany nauczycielowi podczas otwierania dodatku podczas tworzenia zadania w Classroom. Załącznik to treść lub aktywność, z którą uczniowie mają wejść w interakcję.
Nauczyciel tworzy nowy post (np. projekt, ogłoszenie lub pytanie) w ramach zajęć w Classroom i wybiera dodatek z listy. Przez krótki czas (kilka godzin) Classroom zezwala dodatkowi na dodawanie załączników do posta.
Rysunek 1. Widok tworzenia projektu z możliwymi opcjami dodatków, które nauczyciel może dołączyć.
Gdy nauczyciel wybierze dodatek, Classroom utworzy iframe dodatku Discovery i załaduje adres URL uruchomienia dodatku. Wszystkie odpowiednie parametry zapytania iframe są przekazywane do adresu URL uruchamiania.
Rysunek 2. Przykład interfejsu użytkownika do wykrywania załączników w elemencie iframe.
Nauczyciel używa aplikacji internetowej partnera w ramach ramki iframe, aby wybrać załącznik. Aplikacja wywołuje interfejs Classroom API, aby dołączyć załącznik do projektu. Gdy nauczyciel wybierze załączniki, dodatek wysyła postMessage z prośbą o zamknięcie ramki iframe.
Ramka iframe zostaje zamknięta, a nauczyciel może wyświetlić załączniki i wybrać, czy chce wyświetlić ich podgląd, czy usunąć je z projektu.
Rysunek 3. Widok tworzenia projektu z 3 dodatkami typu działania.
Uwagi na temat UX w elemencie iframe
- Po pierwszym otwarciu nauczyciel musi zalogować się w dodatku.
- Logowanie jednokrotne w Google jest wymagane we wszystkich wywołaniach interfejsu API Classroom. Jeśli Twoja usługa ma oddzielny system logowania, musisz połączyć konta.
- Przed dokonaniem ostatecznego wyboru nauczyciel musi mieć możliwość wyświetlenia podglądu załącznika w elemencie iframe.
- Nauczyciel powinien mieć możliwość wyszukiwania treści do załączania lub przeglądania takich treści.
- Dodatek może wyświetlać różne widoki, np. Ostatnie treści, Moje treści i filtrowanie według umiejętności.
- Dodatek musi umożliwiać utworzenie nowego elementu, który można podłączyć z elementu iframe.
Więcej informacji o wymaganiach dotyczących UX znajdziesz na liście kontrolnej wymagań dotyczących dodatków do Classroom.
Wyświetlanie stanu licencji w elemencie iframe
Jeśli dodatek wymaga licencji, a nauczyciel jej nie ma, musi wyświetlić mu jasną wiadomość z informacjami o kolejnych krokach, które należy wykonać, aby rozwiązać problem. Ma to na celu uniknięcie nieporozumień wynikających z ograniczeń licencyjnych.
Zalecamy też, aby dodatek:
- Wyświetla poziom licencji nauczyciela w ramce okna Attachment Discovery.
- Ukrywa lub wyłącza treści, które są niedostępne dla nauczyciela z powodu ograniczeń poziomu licencji.