umbot
    Preparing search index...

    Class YandexSoundRequest

    Класс, отвечающий за загрузку аудиофайлов в навык Алисы

    https://yandex.ru/dev/dialogs/alice/doc/resource-sounds-upload-docpage/ Документация API Яндекс.Диалогов

    YandexSoundRequest

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    _appContext _request skillId

    Accessors

    oauth

    Methods

    _getAuthorizationHeader _log call checkOutPlace deleteSound deleteSounds downloadSoundFile getLoadedSounds setOAuth

    Constructors

    Properties

    Protected_appContext

    _appContext: AppContext

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

    Protected_request

    _request: Request

    Экземпляр класса для отправки HTTP-запросов

    skillId: string | null

    Идентификатор навыка, необходимый для корректного сохранения аудиофайлов

    YandexRequest Базовый класс для работы с API Яндекса

    Accessors

    • get oauth(): string | null | undefined

      Возвращает установленный OAuth-токен (или null, если авторизация отключена).

      Returns string | null | undefined

    Methods

    Protected_getAuthorizationHeader

    • _getAuthorizationHeader(token: string): string

      Формирует значение заголовка Authorization для токена.

      API Яндекс.Диалогов (загрузка изображений и звуков) принимает схему OAuth. Сервисы Yandex Cloud используют другие схемы — наследники переопределяют метод (см. YandexSpeechKit).

      Parameters

      • token: string

        Токен авторизации

      Returns string

      Значение заголовка Authorization

    Protected_log

    • _log(error?: string | Error): void

      Пишет информацию об ошибках через AppContext.logError (структурированный логгер)

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

      Parameters

      • Optionalerror: string | Error = ''

        Текст ошибки или объект ошибки

      Returns void

    • Выполняет HTTP-запрос к API Яндекса

      Отправляет запрос к указанному эндпоинту API и обрабатывает полученный ответ.

      Type Parameters

      • T extends IYandexApi

        Тип ожидаемого ответа, наследующий интерфейс IYandexApi

      Parameters

      • Optionalurl: string | null = null

        URL-адрес эндпоинта API

      Returns Promise<T | null>

      • Результат запроса или null в случае ошибки сети/Request
      interface MyApiResponse extends IYandexApi {
        data: {
          id: string;
          name: string;
        };
      }

      const api = new YandexRequest('token', appContext);

      // Выполнение запроса (метод не выбрасывает исключений).
      // При ошибке API ответ содержит поле error — проверяйте его явно;
      // null возвращается только при ошибке сети/Request.
      const response = await api.call<MyApiResponse>('...');

      if (response) {
        if ('error' in response) {
          // Обработка ошибки API
          console.error('Ошибка API:', response.error);
        } else {
          // Обработка успешного ответа
          console.log('ID:', response.data.id);
          console.log('Name:', response.data.name);
        }
      } else {
        // Обработка ошибки сети/Request
        console.error('Ошибка запроса к API Яндекса');
      }

    • Проверка занятого места в хранилище аудиофайлов

      Returns Promise<IYandexCheckOutPlace | null>

      Информация о занятом месте:

      • total: общий доступный объем хранилища
      • used: использованный объем хранилища

      Для каждого аккаунта действует лимит в 1 ГБ. Учитывается размер сжатых файлов в формате OPUS

    • Удаление конкретного аудиофайла по его идентификатору

      Parameters

      • soundId: string

        Идентификатор аудиофайла для удаления

      Returns Promise<string | null>

      'ok' при успешном удалении, null при ошибке

    • Удаление всех загруженных аудиофайлов

      Returns Promise<boolean>

      true если все файлы успешно удалены, false при ошибке

      Если при удалении произойдет ошибка, некоторые файлы могут остаться в хранилище

    • Загрузка аудиофайла с сервера

      Parameters

      • soundDir: string

        Путь к аудиофайлу на сервере

      Returns Promise<IYandexRequestDownloadSound | null>

      Информация о загруженном аудиофайле:

      • id: уникальный идентификатор файла
      • skillId: идентификатор навыка
      • size: размер файла в байтах
      • originalName: оригинальное имя файла
      • createdAt: дата и время загрузки
      • isProcessed: статус обработки файла

    • Устанавливает OAuth-токен для авторизации

      Обновляет токен авторизации и заголовки запросов. При установке токена автоматически добавляется заголовок 'Authorization: OAuth {token}' ко всем последующим запросам.

      Parameters

      • oauth: string | null

        OAuth-токен для авторизации

      Returns void

      • Если передать null, авторизация будет отключена
      • Заголовок авторизации добавляется автоматически
      • Токен сохраняется для всех последующих запросов
      const api = new YandexRequest(null, appContext);

      // Установка нового токена
      api.setOAuth('new-token');
      // Теперь все запросы будут с заголовком:
      // Authorization: OAuth new-token

      // Сброс токена
      api.setOAuth(null);
      // Запросы будут без авторизации

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods