iframe «Открытие вложений» — это начальное окно, отображаемое учителю при открытии дополнения во время создания задания в Classroom. Вложение — это контент или задание, с которым, как предполагается, будут взаимодействовать ученики.
В рамках курса Classroom преподаватель создает новый пост (например, задание, объявление или вопрос) и выбирает дополнение из выпадающего списка дополнений (Рисунок 1).
Рисунок 1. Схема создания задания, включая возможные дополнительные опции, которые может добавить преподаватель.
После того как учитель выберет дополнение, Classroom создаст iframe для обнаружения вложений и загрузит URL-адрес запуска дополнения. Все соответствующие параметры запроса iframe передаются на URL-адрес запуска (Рисунок 2).
Рисунок 2. Пример пользовательского интерфейса поиска вложений в iframe.
Представьте себе раздел «Поиск вложений» как главную страницу для преподавателей в вашем дополнении. Как правило, преподаватель использует веб-приложение партнера внутри iframe, чтобы выбрать контент для прикрепления к элементу своей трансляции. Приложение дополнения может ограничивать отображаемый контент в зависимости от того, является ли элемент трансляции объявлением, заданием или учебным материалом. Затем приложение дополнения выполняет вызовы API Classroom для создания и прикрепления вложения к заданию.
Когда преподаватель заканчивает выбор и создание вложений, дополнение отправляет сообщение postMessage с просьбой закрыть iframe. iframe закрывается, и преподаватель видит вложения, которые он может просмотреть или удалить из задания (Рисунок 3). Преподаватель завершает процесс создания, назначая элемент потока своим ученикам.
Рисунок 3. Схема создания задания с тремя дополнительными вложениями типа «деятельность».
Учет пользовательского опыта
- При первом запуске дополнение должно предложить учителю войти в систему.
- Для всех вызовов API Classroom требуется единый вход Google. Если в вашем продукте используется отдельная система авторизации, необходимо связать учетные записи.
- Преподаватель должен иметь возможность предварительно просмотреть вложенный файл внутри iframe, прежде чем сделать окончательный выбор.
- Учитель должен иметь возможность искать или просматривать прикрепляемый контент.
- Дополнение может предоставлять различные варианты отображения контента, такие как недавний контент, мой контент, а также фильтрацию по навыкам обучения.
- Дополнение должно предоставлять возможность создавать новый прикрепляемый элемент непосредственно внутри iframe.
Для получения более подробной информации о требованиях к пользовательскому интерфейсу см. контрольный список требований к дополнению Classroom.
Статус лицензирования
Если для вашего дополнения требуется лицензия на продукт, следует отобразить четкое сообщение, объясняющее, как учитель без лицензии может исправить ситуацию. Также следует рассмотреть возможность скрытия или отключения контента, недоступного учителю из-за ограничений лицензирования.