Element iframe wykrywania załączników to widok początkowy wyświetlany nauczycielowi podczas otwierania dodatku podczas tworzenia zadania w Classroom. Załącznik to treść lub działanie, z którym uczniowie będą mogli wejść w interakcję.
W ramach zajęć w Classroom nauczyciel tworzy nowego posta (np. projekt, ogłoszenie lub pytanie) i wybiera dodatek z listy. Przez krótki czas (według godzin) Classroom zezwala na dodawanie załączników do postów.
Rysunek 1. Widok tworzonego projektu wraz z opcjami dodatków, które nauczyciel może dołączyć.
Gdy nauczyciel wybierze dodatek, Classroom tworzy element iframe odkrywania załączników i wczytuje adres URL uruchamiania dodatku. Odpowiednie parametry zapytania iframe są przekazywane do adresu URL uruchamiania.
Rysunek 2. Przykład interfejsu wykrywania załączników w elemencie iframe.
Nauczyciel wybiera załącznik za pomocą aplikacji internetowej partnera w elemencie iframe. Aplikacja wykonuje wywołania interfejsu Classroom API, aby dołączyć załącznik do projektu. Gdy nauczyciel wybierze załączniki, dodatek wyśle ładunek postMessage
, prosząc o zamknięcie elementu iframe.
Element iframe zostanie zamknięty, a nauczyciel będzie mógł zobaczyć załączniki, których podgląd może wyświetlić, lub które może usunąć z projektu.
Rysunek 3. Widok projektu z 3 dodatkami do aktywności.
Uwagi na temat wygody użytkownika w elemencie iframe
- Przy pierwszym otwarciu dodatek musi poprosić nauczyciela o zalogowanie się.
- Logowanie jednokrotne Google jest wymagane w przypadku wszystkich wywołań interfejsu API Classroom. Jeśli Twój produkt ma osobny 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 i przeglądania takich materiałów.
- Dodatek może dawać różne widoki, np. najnowsze treści i moje materiały, oraz filtrować według umiejętności edukacyjnych.
- Dodatek musi umożliwiać tworzenie nowego elementu dołączanego w elemencie iframe.
Więcej informacji o wymaganiach związanych z UX znajdziesz w liście kontrolnej wymagań dodatku do Classroom.
Wyświetlaj stan licencji w elemencie iframe
Jeśli dodatek wymaga licencji, a nauczyciel jej nie ma, muszą zostać wyświetlone jasne komunikaty z informacją o kolejnych krokach, które należy podjąć w celu rozwiązania problemu. W ten sposób unikniesz nieporozumień, które mogą pojawić się w wyniku ograniczeń licencyjnych.
Zalecamy również, aby dodatek:
- Wyświetla poziom licencji nauczyciela w elemencie iframe wykrywania załączników.
- Ukrywa lub wyłącza treści, które są niedostępne dla nauczyciela z powodu ograniczeń na poziomie licencji.