ym88659208ym87991671
Как включить и настроить шторку ассистента - IOS | Документация для разработчиков
Skip to main content

Как включить и настроить шторку ассистента

Обновлено 13 сентября 2022

О шторке

Шторка ассистента — это выдвижная панель в интерфейсе приложения, которая отображает окно для взаимодействия с виртуальным ассистентом. Шторка может быть в развернутом или свернутом состоянии.

Развернутая (длинная) шторка ассистента занимает весь экран приложения. В этом режиме отображается и панель ассистента, и основной контент (лента ассистента, смартапы и т. д.).

Свернутая (короткая) шторка появляется в нижней части экрана приложения и занимает только часть экрана. В этом режиме основной контент ассистента не отображается, и ассистент представлен только шторкой.

Включение и настройка шторки

Ниже описано, как включить шторку ассистента и настроить для нее фон.

Включить шторку

Чтобы включить шторку в своем приложении:

  1. Включите флаг dialogCompactMode.
  2. Добавьте отображение в иерархию ассистента через addChildViewController поверх основного контента приложения, оборачивать в навигационный контроллер не нужно.

Включить сплошной (солидный) фон

По умолчанию фон шторки градиентный.

Чтобы включить сплошной фон для шторки, включите флаг solidBottomBar.

Действия со шторкой

Ниже описаны действия со шторкой в приложении.

Вызвать шторку

Короткую шторку вызовет:

  • нажатие на лавашар;
  • команда активации споттера.

Длинную шторку вызовет:

  • нажатие на значок клавиатуры в короткой шторке;
  • сценарий, где есть последовательность шагов (например, «Дуэт»);
  • сценарий, где есть графическая информация (например, «Погода» или «Покажи лучшие акции»);
  • сценарий, в котором используется Canvas App (например, «Заказ продуктов»);
  • сценарий, который потребует длинный ответ ассистента (более трех строк).

Закрыть шторку

Короткая шторка закроется, если:

  • вы нажали на любое место экрана, где нет короткой шторки;
  • вы произнесли команду «Хватит» или «Выход»;
  • вы не взаимодействовали с ассистентом более пяти секунд после поднятия шторки.
caution

Закрытие короткой шторки (например, таймер на пять секунд, обработка нажатий вне шторки) управляется на стороне партнера. Подробнее читайте в пункте 5 инструкции выше.

Длинная шторка закроется, если:

  • вы нажали на значок закрытия;
  • вы произнесли команду «Хватит» или «Выход»;
  • вы нажали кнопку Назад;
  • вы смахнули шторку вниз. Обратите внимание, что если вы вышли из длинной шторки, короткая шторка не откроется.

Пример работы со шторкой ассистента

Демо-приложение с примером интеграции короткой шторки ассистента в светлой теме находится в папке  Examples/ASDKCompactModeExample архива ios_assistant_sdk_XX.X.XXXX-examples.

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней