umbot
    Preparing search index...

    Class MarusiaAdapter

    Адаптер для Маруси.

    Автоматически обрабатывает только те запросы, которые прошли проверку через isPlatformOnQuery — т.е. действительно пришли от Маруси. Не влияет на обработку запросов от других платформ.

    Поддерживает:

    • голосовые и текстовые запросы;
    • сохранение состояния (user/application/session);
    • карточки, кнопки, TTS-эффекты;
    • health-check (ping → pong);

    Подключается как любой другой адаптер: bot.use(new MarusiaAdapter(token)). Несколько адаптеров могут работать одновременно — система сама выберет подходящий на основе заголовков и структуры входящего запроса.

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    _platformOptions? _token? appContext? isVoice limit MAX_TIME_REQUEST platformName WARMING_TIME_REQUEST

    Methods

    _getResponse _initTTS _timeLimitLog getContent getLocalStorage getProcessingTime getQueryExample getRatingContext init isLocalStorage isPlatformOnQuery send setLocalStorage setQueryData soundProcessing updateTimeStart isVoice

    Constructors

    Properties

    Protected Optional_platformOptions

    _platformOptions?: IAdapterOptions

    Protected Optional_token

    _token?: string
    appContext?: AppContext<unknown>

    Контекст приложения

    isVoice: boolean = true

    Определяет тип платформы(голосовая или чат-бот)

    limit: number | null = null

    Определят лимит платформы. В значение указывается количество запросов, которое можно отправить платформе за 1 секунду. В случае если у платформы нет ограничений, можно указать 0 или null. По умолчанию null

    MAX_TIME_REQUEST: number = 2900

    Максимальное время ответа навыка в миллисекундах при превышении этого времени, будет отправлена ошибка

    platformName: string = T_MARUSIA

    Имя платформы

    WARMING_TIME_REQUEST: number = 2000

    Время ответа навыка в миллисекундах при превышении этого времени, будет отправлено предупреждение

    Methods

    Protected_getResponse

    Protected_initTTS

    Protected_timeLimitLog

    • _timeLimitLog(controller: BotController): void

      При превышении установленного времени исполнения, пишет информацию в лог После вызова getContent() автоматически проверяется время выполнения. Если оно превышает 2000 мс — пишется warning, если >2900 мс — ошибка.

      Parameters

      Returns void

    • Формирует тело ответа для отправки пользователю.

      Возвращает платформо-специфичный ответ (например, JSON для Алисы). Для платформ, которые отправляют ответ напрямую (например, Telegram через sendMessage), метод может возвращать { ok: true } или аналог.

      Parameters

      • controller: BotController

        контроллер с готовым ответом

      • OptionalstateData: Record<string, unknown> | null

        данные для локального хранилища

      Returns Promise<IMarusiaWebhookResponse>

      ответ в формате, понятном платформе

    • Возвращает демо результат запроса, который будет приходить от платформы. Используется только при локальном тестировании. Необходимо указывать для того, чтобы можно было корректно проверить работоспособность приложения.

      Обязательно определите метод, ели планируется тестирования приложения через инструменты предоставляемые платформой. Это существенно упростит процесс разработки приложения.

      Parameters

      • query: string

        Запрос пользователя

      • userId: string

        Идентификатор пользователя

      • count: number

        Порядковый номер запроса

      • state: string | IMarusiaRequestState

        Данные из локального хранилища

      Returns Record<string, unknown>

    • Инициализация адаптера. Определять не обязательно. Стоит указывать в случаях, когда нужно выполнить доп логику, например указать токены или писать какую-то статистику по использованию.

      Parameters

      • appContext: AppContext

      Returns void

    • Возвращает признак того, соответствует ли запрос текущей платформе или нет

      Parameters

      • query: IMarusiaWebhookRequest

        Запрос, который пришел в приложение

      • Optionalheaders: Record<string, unknown>

        Заголовок с которым был отправлен запрос

      Returns boolean

      true, если запрос относится к этой платформе, иначе false

      isPlatformOnQuery(query, headers) {
        return headers?.['x-telegram-bot-api-secret-token'] === this._token;
      }

      isPlatformOnQuery(query) {
        return typeof query === 'object' && query.meta?.session_id;
      }

    • Отправка текста пользователю Этот метод используется для активных рассылок — когда бот инициирует диалог первым (например, уведомление). В методе реализована механика преобразования текстового значения controllerOrText в контроллер, а также базовый механизм для отправки ответа.

      Переопределять данный метод не рекомендуется. Переопределить стоит только в том случае, если по каким-то технических условиям текущая реализация метода вам не подходит.

      Если платформа не поддерживает возможность начать диалог самостоятельно, то можно оставить метод пустым, либо вывести любую заглушку.

      Returns boolean

    • Парсит входящий запрос и заполняет контроллер.

      Обязательно установите:

      • controller.text — текст сообщения пользователя
      • controller.userId — уникальный ID пользователя
      • controller.platform = this.platformName

      Опционально:

      • controller.intent — если платформа присылает интент
      • controller.entities — извлечённые сущности
      • controller.session — данные сессии

      Parameters

      Returns boolean

      false, если запрос повреждён или не может быть обработан; иначе true

    • Дополнительная обработка для звуков. В данном методе стоит реализовать логику, с помощью которой будут наложены дополнительные эффекты для озвучивания текста пользователю

      Parameters

      Returns Promise<void>

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods