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