Der iFrame zur Anhangserkennung ist die Anfangsansicht, die der Kursleiter sieht, wenn er beim Erstellen einer Classroom-Aufgabe ein Add-on öffnet. Ein Anhang ist der Inhalt oder die Aktivität, mit dem bzw. der die Schüler interagieren sollen.
In einem Classroom-Kurs erstellt eine Lehrkraft einen neuen Beitrag (z. B. eine Aufgabe, Ankündigung oder Frage) und wählt ein Add-on aus der entsprechenden Drop-down-Liste aus. Für kurze Zeit (nach Stunden) kann das Add-on dem Beitrag Anhänge hinzufügen.
Abbildung 1: Ansicht einer Aufgabenerstellung, einschließlich der möglichen Add-on-Optionen, die eine Lehrkraft anhängen kann.
Sobald eine Lehrkraft ein Add-on ausgewählt hat, erstellt Classroom einen iFrame für die Anhangserkennung und lädt die Start-URL des Add-ons. Alle relevanten iFrame-Suchparameter werden an die Start-URL übergeben.
Abbildung 2: Beispiel für eine UI für die Anhangerkennung in einem iFrame
Die Lehrkraft verwendet die Webanwendung des Partners in einem iFrame, um einen Anhang auszuwählen. Die App führt Classroom API-Aufrufe aus, um den Anhang an die Aufgabe anzuhängen. Wenn die Lehrkraft die Anhänge ausgewählt hat, sendet das Add-on eine postMessage-Nutzlast und fordert das Schließen des iFrames an.
Der iFrame wird geschlossen und die Lehrkraft kann nun die Anhänge sehen und diese dann als Vorschau ansehen oder aus der Aufgabe entfernen.
Abbildung 3: Ansicht einer Aufgabenerstellung mit drei Anhängen des Aktivitätstyp-Add-ons.
UX-Überlegungen zum iFrame
- Beim ersten Öffnen muss die Lehrkraft vom Add-on aufgefordert werden, sich anzumelden.
- Die Einmalanmeldung (SSO) von Google ist für alle Classroom API-Aufrufe erforderlich. Wenn Ihr Produkt ein separates Anmeldesystem hat, müssen Sie die Konten verknüpfen.
- Der Kursleiter muss in der Lage sein, sich eine Vorschau eines Anhangs im iFrame anzusehen, bevor er seine endgültige Auswahl trifft.
- Eine Lehrkraft sollte in der Lage sein, nach anhangbaren Inhalten zu suchen oder diese durchzustöbern.
- Das Add-on kann verschiedene Ansichten wie aktuelle Inhalte oder eigene Inhalte bieten und nach Lernfähigkeiten filtern.
- Das Add-on muss die Möglichkeit bieten, ein neues anfügbares Element innerhalb des iFrames zu erstellen.
Weitere Informationen zu den UX-Anforderungen finden Sie in der Checkliste mit den Anforderungen für das Classroom-Add-on.
Lizenzstatus im iFrame anzeigen
Wenn für das Add-on eine Lizenz erforderlich ist, die Lehrkraft aber keine hat, muss die Lehrkraft dort eine klare Botschaft erhalten, die sie über die nächsten geeigneten Schritte zur Behebung des Problems informiert. Damit soll verhindert werden, dass es zu Unklarheiten aufgrund von Lizenzbeschränkungen kommen kann.
Außerdem empfehlen wir Folgendes für Ihr Add-on:
- Zeigt die Lizenzebene der Lehrkraft im iFrame der Anhangserkennung an.
- Blendet Inhalte aus oder deaktiviert Inhalte, die aufgrund von Lizenzbeschränkungen für Lehrkräfte nicht verfügbar sind.