Введение
Клиентский SDK Vonage Video API версии 2.36 уже доступен. Этот выпуск содержит пять важных обновлений: новая ошибка для API сквозного шифрования, расширенная наблюдаемость клиента с помощью аналитики ограничений качества, встроенная логика повторных попыток публикации для JavaScript SDK, совместимость с iOS 27 и обновление безопасности для корневых сертификатов CA, встроенных в библиотеку WebRTC в составе нативных SDK.
Версия 2.36 доступна для JavaScript (Web), iOS, Android, Linux и Windows. Полный список изменений см. в примечаниях к выпуску.
Новая ошибка в API сквозного шифрования
Новая ошибка OT_ENCRYPTION_NOT_ENABLED предоставляет дополнительную информацию в ситуациях, когда сквозное шифрование не было включено. Ошибка возвращается, если секретный ключ шифрования задан в сессии, которая не была создана с включенным сквозным шифрованием.
Ранее это приводило к «тихой» ошибке, которая не была доступна разработчику.
Наблюдаемость клиента: аналитика ограничений качества
Версия 2.36 обеспечивает дополнительную прозрачность причин изменения качества видео у участника во время сессии, развивая систему отчетности о состоянии сети, представленную в предыдущих выпусках. Это обновление доступно для всех SDK: JavaScript (Web), iOS, Android, Linux и Windows.
Ранее SDK не сообщал, почему качество видео было ограничено в некоторых сценариях. Теперь SDK предоставляет более подробную информацию как для издателя, так и для подписчика.
Два новых поля в статистике видео подписчика решают эту задачу напрямую:
- SenderQualityRestriction — сообщает об ограничениях, примененных непосредственным отправителем (Media Router в маршрутизируемых сессиях или издателем в ретранслируемых сессиях).
SenderQualityRestriction — сообщает об ограничениях, примененных непосредственным отправителем (Media Router в маршрутизируемых сессиях или издателем в ретранслируемых сессиях).
- RemotePublisherQualityRestriction — сообщает об ограничениях, примененных исходным издателем.
RemotePublisherQualityRestriction — сообщает об ограничениях, примененных исходным издателем.
Оба поля используют один и тот же набор типов ограничений: none (нет), spatial (пространственное), temporal (временное), both (оба) и unknown (неизвестно).
Изменения в ограничениях качества отправителя также отображаются через существующее событие Subscriber.VideoQualityChanged, поэтому приложения, которые уже прослушивают это событие, получат новые данные без необходимости внесения изменений в интеграцию.
Также были добавлены два новых значения NetworkReason:
- NetworkReason.NoSubscribers — указывает на то, что битрейт издателя ограничен из-за отсутствия активных подписчиков.
NetworkReason.NoSubscribers — указывает на то, что битрейт издателя ограничен из-за отсутствия активных подписчиков.
- NetworkReason.DownstreamConstraint — указывает на то, что битрейт издателя ограничен условиями приемника (downstream), обычно когда масштабируемое видео отключено.
NetworkReason.DownstreamConstraint — указывает на то, что битрейт издателя ограничен условиями приемника (downstream), обычно когда масштабируемое видео отключено.
В совокупности эти дополнения предоставляют приложениям информацию, необходимую для информирования конечных пользователей о проблемах с качеством в режиме реального времени. Разработчики могут принимать меры во время звонка, а не после его завершения.
Полную информацию см. в руководстве по наблюдаемости клиента (Client Observability guide).
Встроенная функция повторных попыток публикации в JavaScript SDK
Версия 2.36 представляет встроенную поддержку повторных попыток для session.publish в JavaScript SDK. Теперь SDK автоматически обрабатывает восстановимые временные ошибки во время публикации, сокращая объем кода обработки ошибок, который необходимо поддерживать в приложениях.
Это функция с возможностью выбора (opt-in). Поведение session.publish по умолчанию остается полностью неизменным; существующие интеграции продолжат работать как прежде.
Чтобы включить встроенную повторную попытку, передайте новые параметры издателя при инициализации:
Три новых параметра издателя:
Параметр
Тип
По умолчанию
Описание
maxPublishTimeout
Number (мс)
15000
Максимальное время для успешной публикации. SDK повторяет попытку при любой восстановимой ошибке в течение этого окна. Невосстановимые ошибки возвращаются немедленно; истечение времени возвращает ошибку таймаута.
onRetry
Function(error)
Callback, вызываемый при каждой повторной попытке. Получает ошибку, вызвавшую событие. Используйте это для отображения индикатора «Повторная попытка...». Только для информации — повторные попытки нельзя отменить отсюда.
fallbackOnPartialPermission
Boolean
false
Если установлено значение true, и пользователь предоставил доступ только к некоторым устройствам (например, микрофону, но не камере), публикация продолжается с разрешенными устройствами вместо ошибки. Также корректно обрабатывает ситуацию, если устройство отключается после начала публикации.
Таймаут ведет себя по-разному в зависимости от того, как он установлен. Явно настроенное значение (например, maxPublishTimeout: 20000) действует как жесткий таймаут: SDK прекращает попытки, как только таймер истекает, независимо от состояния соединения. Если оставить значение по умолчанию 15000 мс, оно ведет себя как мягкий таймаут: если сокет отключается, таймер приостанавливается до восстановления соединения, а затем возобновляется. Это предотвращает отказ SDK во время временной потери связи.
Невосстановимые ошибки, такие как OT_NOT_CONNECTED и OT_PERMISSION_DENIED, никогда не повторяются, что гарантирует немедленное обнаружение реальных сбоев. SDK использует экспоненциальную задержку для интервалов повторных попыток.
Совместимость с iOS 27
Версия 2.36 обеспечивает полную совместимость с iOS 27 во всем SDK. Разработчикам, создающим приложения для iOS 27, не требуется вносить изменения в интеграцию. Мы также перенесли эти изменения совместимости в версию SDK 2.35.2, чтобы обеспечить готовность к последнему выпуску iOS.
Обновление безопасности: недоверие к корневому сертификату eMudhra
Версия 2.36 обновляет корневые сертификаты, встроенные в библиотеку WebRTC, используемую нативными SDK. Сертификаты, выданные скомпрометированными промежуточными центрами сертификации eMudhra (emSign), больше не считаются доверенными.
В октябре 2026 года было обнаружено, что закрытые ключи восьми промежуточных центров сертификации eMudhra могут быть восстановлены. Это серьезный инцидент безопасности, затронувший браузеры, операционные системы и широкий спектр программных стеков в Интернете. Поскольку эти ключи слабы, злоумышленник может создать поддельный сертификат для любого домена и использовать его для выдачи себя за серверы или перехвата трафика. Полную информацию об инциденте см. в раскрытии информации Cloudflare.
SDK использует встроенные корневые сертификаты библиотеки WebRTC для проверки безопасных соединений с TURN-серверами по TLS. Это обновление гарантирует, что SDK больше не принимает сертификаты, выданные затронутыми центрами сертификации, восстанавливая целостность этих соединений. Изменения в интеграции не требуются; достаточно обновиться до версии 2.36.
Начало работы
Чтобы обновиться до версии 2.36, установите JavaScript SDK с помощью следующей команды:
Для нативных SDK посетите нашу документацию для получения инструкций по установке для конкретной платформы.
Примечание: React Native SDK следует за каждым выпуском нативного SDK после завершения необходимой интеграции, тестирования и проверки.
Примечание: React Native SDK следует за каждым выпуском нативного SDK после завершения необходимой интеграции, тестирования и проверки.
Заключение
Версия 2.36 расширяет возможности мониторинга клиентов, улучшает видимость ошибок сквозного шифрования, снижает сложность интеграции за счет встроенной логики повторных попыток публикации, обеспечивает совместимость с iOS 27 и устраняет последствия компрометации сертификата eMudhra в октябре 2026 года с помощью обновленного встроенного хранилища доверенных сертификатов.
Разработчики, создающие видеоприложения для рабочей среды, получат прямые улучшения устойчивости во время выполнения, возможностей диагностики и многоязычной доступности. Мы рекомендуем обновиться до версии 2.36 для всех рабочих развертываний.












