iframe Rilevamento degli allegati

L'iframe di rilevamento degli allegati è la visualizzazione iniziale mostrata a un insegnante quando l'apertura di un componente aggiuntivo durante la creazione di un'attività di Classroom. Un attachment indica i contenuti o l'attività che vuoi che gli studenti interagire con loro.

In un corso di Classroom, l'insegnante crea un nuovo post (ad esempio, un compito, un annuncio o una domanda) e seleziona un componente aggiuntivo l'elenco a discesa dei componenti aggiuntivi. Per un breve periodo di tempo (nell'ordine delle ore), Classroom consente al componente aggiuntivo di aggiungere allegati al post.

Visualizzazione della creazione di un compito con le possibili opzioni dei componenti aggiuntivi di un insegnante
può allegare Figura 1. Vista di un sulla creazione di compiti, incluse le possibili opzioni aggiuntive che un insegnante può allegare.

Quando un insegnante seleziona un componente aggiuntivo, Classroom crea un allegato Discovery iframe e carica l'URL di avvio del componente aggiuntivo. Qualsiasi query iframe pertinente parametri vengono passati all'URL di avvio.

Esempio di UI di rilevamento degli allegati

Figura 2. Un esempio di UI di rilevamento degli allegati in un iframe.

L'insegnante utilizza l'applicazione web del partner, all'interno di un iframe, per selezionare una allegato. L'app effettua chiamate all'API Classroom per allegare l'allegato al compito. Quando l'insegnante ha finito di selezionare gli allegati, invia un payload postMessage richiedendo la chiusura dell'iframe.

L'iframe si chiude e l'insegnante può ora visualizzare gli allegati scegli di visualizzare l'anteprima o di rimuoverla dal compito.

Visualizzazione della creazione di un compito

Figura 3. Visualizzazione della creazione di un compito con il componente aggiuntivo di tre tipi di attività allegati.

Considerazioni sull'esperienza utente nell'iframe

  • All'apertura iniziale, il componente aggiuntivo deve richiedere all'insegnante di accedere.
  • È richiesto l'accesso Single Sign-On di Google per tutte le chiamate all'API Classroom. Se se il prodotto ha un sistema di accesso separato, è necessario collegare gli account.
  • Un insegnante deve essere in grado di visualizzare l'anteprima di un allegato all'interno dell'iframe prima per la scelta finale.
  • Un insegnante deve essere in grado di cercare o sfogliare i contenuti allegabili contenuti.
  • Il componente aggiuntivo può offrire un'ampia gamma di visualizzazioni, ad esempio contenuti recenti, contenuti e filtrarli in base alle competenze di apprendimento.
  • Il componente aggiuntivo deve offrire la possibilità di creare un nuovo elemento collegabile da all'interno dell'iframe.

Per ulteriori dettagli, consulta l'elenco di controllo dei requisiti per il componente aggiuntivo di Classroom sui requisiti UX.

Mostra lo stato di licenza nell'iframe

Se il componente aggiuntivo richiede una licenza e l'insegnante non ne ha una, messaggio deve essere presentato all'insegnante per informarlo della i passaggi per porre rimedio alla situazione. In questo modo, eviterai confusione che potrebbe sorgere dalle restrizioni sulle licenze.

Ti consigliamo inoltre di eseguire il componente aggiuntivo:

  • Mostra il livello di licenza dell'insegnante all'interno del rilevamento degli allegati iframe.
  • Nasconde o disattiva i contenuti non disponibili per un insegnante a causa delle licenze limitazioni di livello.