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 działanie, z którymi uczniowie mogą korzystać.
W ramach zajęć w Classroom nauczyciel tworzy nowy wpis (np. projekt, ogłoszenie lub pytanie) i wybiera dodatek z listy dodatków. Przez krótki czas (według liczby godzin) Classroom umożliwia dodatkowi dodawanie załączników do postów.
Rysunek 1. Widok tworzenia projektu z możliwymi opcjami dodatków, które nauczyciel może dołączyć.
Gdy nauczyciel wybierze dodatek, Classroom tworzy element iframe wykrywania załączników i wczytuje adres URL uruchamiania dodatku. Do adresu URL uruchamiania przekazywane są wszystkie odpowiednie parametry zapytania iframe.
Rysunek 2. Przykład interfejsu użytkownika do wykrywania załączników w elemencie iframe.
Nauczyciel wybiera załącznik w aplikacji internetowej partnera w elemencie iframe. Aplikacja wykonuje wywołania interfejsu Classroom API, aby dołączyć załącznik do projektu. Gdy nauczyciel skończy wybierać załączniki, dodatek wysyła ładunek postMessage
z żądaniem zamknięcia elementu iframe.
Element iframe zostanie zamknięty i nauczyciel może teraz zobaczyć załączniki, które może wyświetlić lub usunąć z projektu.
Rysunek 3. Widok tworzenia projektu z 3 dodatkami typu działania.
Uwagi na temat UX w elemencie iframe
- Przy pierwszym uruchomieniu dodatek musi poprosić nauczyciela o zalogowanie się.
- Logowanie jednokrotne w Google jest wymagane we wszystkich wywołaniach interfejsu API Classroom. Jeśli usługa ma oddzielny system logowania, trzeba 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 treści, które można dołączyć.
- Dodatek może udostępniać różne widoki, np. najnowsze treści i moje treści, oraz filtrować je według umiejętności edukacyjnych.
- 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, musisz przedstawić nauczycielowi jasną wiadomość z informacjami o kolejnych krokach, jakie należy podjąć w celu rozwiązania tej sytuacji. Dzięki temu unikniemy nieporozumień, które mogą powstać w związku z ograniczeniami licencyjnymi.
Zalecamy też, 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 licencjonowania.