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