Ramka iframe wykrywania załączników to widok początkowy wyświetlany nauczycielowi po otwarciu dodatku podczas tworzenia zadania w Classroom. Załącznik to treść lub działanie, z którym uczniowie mają wejść w interakcję.
W ramach kursu w Classroom nauczyciel tworzy nowy post (np. projekt, ogłoszenie lub pytanie) i wybiera dodatek z listy dodatków (rysunek 1).
Rysunek 1. Widok tworzenia projektu z możliwymi opcjami dodatków, które nauczyciel może dołączyć.
Gdy nauczyciel wybierze dodatek, Classroom utworzy ramkę iframe do wykrywania załączników i wczyta adres URL uruchamiania dodatku. Wszystkie odpowiednie parametry zapytania elementu iframe są przekazywane do adresu URL uruchomienia (rysunek 2).
Rysunek 2. Przykład interfejsu wykrywania załączników w elemencie iframe.
Widok Odkrywanie załączników to strona docelowa dla nauczycieli w dodatku. Zazwyczaj nauczyciel używa aplikacji internetowej partnera w elemencie iframe, aby wybrać treści do dołączenia do elementu strumienia. Aplikacja dodatku może ograniczać wyświetlanie treści w zależności od tego, czy element strumienia jest ogłoszeniem, projektem czy materiałem do kursu. Aplikacja dodatku wykonuje wywołania interfejsu Classroom API, aby utworzyć załącznik i dołączyć go do zadania.
Gdy nauczyciel skończy wybieranie i tworzenie załączników, dodatek wysyła postMessageładunek z prośbą o zamknięcie elementu iframe. Ramka iframe zamyka się, a nauczyciel widzi załączniki, które może wyświetlić lub usunąć z zadania (rysunek 3). Nauczyciel kończy proces tworzenia, przypisując element strumienia uczniom.
Rysunek 3. Widok tworzenia projektu z 3 załącznikami dodatków typu aktywności.
Kwestie związane z wrażeniami użytkownika
- Przy pierwszym otwarciu dodatek musi poprosić nauczyciela o zalogowanie się.
- Wszystkie wywołania interfejsu Classroom API wymagają logowania jednokrotnego w Google. Jeśli Twoja usługa ma oddzielny system logowania, musisz połączyć konta.
- Nauczyciel musi mieć możliwość wyświetlenia podglądu załącznika w elemencie iframe przed dokonaniem ostatecznego wyboru.
- Nauczyciel powinien mieć możliwość wyszukiwania lub przeglądania treści, które można dołączyć.
- Dodatek może udostępniać różne widoki, takie jak ostatnie treści, moje treści i filtrowanie według umiejętności.
- Dodatek musi umożliwiać utworzenie nowego elementu dołączanego w ramce iframe.
Więcej informacji o wymaganiach dotyczących interfejsu znajdziesz na liście kontrolnej wymagań dotyczących dodatków do Classroom.
Stan licencjonowania
Jeśli dodatek wymaga licencji na produkt, powinien wyświetlać się jasny komunikat wyjaśniający, jak nauczyciel bez licencji może rozwiązać ten problem. Możesz też ukryć lub wyłączyć treści, które nie są dostępne dla nauczyciela z powodu ograniczeń licencyjnych.