Element iframe wykrywania załączników to początkowy widok wyświetlany nauczycielowi, gdy otwarcie dodatku podczas tworzenia zadania w Classroom. An załącznik to treść lub zadanie do wykonania przez uczniów. wchodzą w interakcję z reklamą.
Z poziomu zajęć w Classroom nauczyciel tworzy nowego posta (na (zadanie, ogłoszenie czy pytanie) i wybiera dodatek z listy dodatków. Przez krótki czas (w zależności od godziny) Classroom pozwala dodatkiowi na dodawanie załączników do postów.
Rysunek 1. Widok tworzenia projektów, w tym możliwych opcji dodatków, które nauczyciel może dołączyć.
Gdy nauczyciel wybierze dodatek, Classroom utworzy załącznik. Element iframe wykrywania i wczytuje adres URL uruchamiania dodatku. Dowolne odpowiednie zapytanie iframe do adresu URL uruchamiania.
Rysunek 2. Przykład interfejsu użytkownika do wykrywania załączników w elemencie iframe.
Nauczyciel wybiera w elemencie iframe aplikację internetową partnera
załącznik. Aplikacja wykonuje wywołania interfejsu Classroom API w celu dołączenia załącznika.
w danym projekcie. Gdy nauczyciel skończy wybieranie załączników,
dodatek wysyła ładunek postMessage
z żądaniem zamknięcia elementu iframe.
Element iframe zostanie zamknięty i nauczyciel może teraz zobaczyć załączniki, wyświetlić podgląd projektu lub go z niego usunąć.
Rysunek 3. Widok tworzenia projektu z 3 dodatkiem typu działania załączniki.
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 Twój produkt ma oddzielny system logowania, musisz połączyć konta.
- Nauczyciel musi mieć możliwość wyświetlenia podglądu załącznika w elemencie iframe, zanim podejmują ostateczną decyzję.
- Nauczyciel powinien mieć możliwość wyszukiwania i przeglądania, które można dołączyć treści.
- Dodatek może udostępniać różne widoki, takie jak najnowsze treści, i filtrować według umiejętności uczenia się.
- Dodatek musi umożliwiać utworzenie nowego elementu, który można podłączyć: wewnątrz elementu iframe.
Więcej informacji znajdziesz na liście kontrolnej wymagań dotyczących dodatków do Classroom. na temat wymagań UX.
Wyświetlanie stanu licencji w elemencie iframe
Jeśli dodatek wymaga licencji, a nauczyciel jej nie ma, możesz muszą zostać przedstawione nauczycielowi jako informacja o kolejnym kroków do rozwiązania problemu. Pozwoli to uniknąć nieporozumień przed ograniczeniami licencyjnymi.
Zalecamy też, aby dodatek:
- Wyświetla poziom licencji nauczyciela w narzędziu wykrywania załączników iframe.
- ukrywa lub wyłącza treści niedostępne dla nauczyciela z powodu licencjonowania. ograniczenia poziomów dostępu.