Video API Reference App for Desktop (Web) Release Notes

New Features

Advanced Settings: Quality Controls & Observability

A new dialog with dedicated tabs gives users full control over media configuration and real-time monitoring.

Video Settings

Configure:

• Resolution
• Frame rate
• Custom bitrate
• Codec priority (VP8, VP9, H264)

Audio Settings

Control:

• Bitrate mode
• Opus DTX
• Publisher/subscriber audio fallback

Observability Panel

Monitor:

• Stream health
• Quality metrics in real time

VideoHandler v2 API

Introduced a new /v2 backend router powered by createVideoHandler, with webhook endpoints for:

• Session lifecycle events
• Captions lifecycle events
• Archive lifecycle events

Session Key Abstraction

A JWT-based SessionKey now replaces raw sessionId across the backend session management layer, improving:

• Security
• Consistency

Batch Log Upload

Added a new /client-logs/batch endpoint that accepts an array of log events and forwards them in a single request, reducing overhead for high-frequency logging.

Logger Synchronizer

Introduced a new component that automatically synchronizes:

• User ID
• Session ID
• Connection ID

into the frontend logger context, ensuring consistent log correlation.

Reusable Notifications System

Added:

• NotificationsContainer
• Runtime logger provider

to provide a unified system for surfacing in-app notifications.

UI Theme Customization

Added:

• designTokens.json
• yarn sync:theme-tokens

to support visual theme customization across the application.

Vonage Video Host Configuration

Added support for the VONAGE_VIDEO_HOST environment variable, allowing the application to connect to a custom Vonage Video API endpoint.

Camera Not Available Notification

Users now receive a notification when their camera becomes unavailable during an active session.

Improvements

Configurable Environment Documentation

Expanded the README with comprehensive documentation covering:

• UI customization
• Environment configuration options

Material UI v9 Upgrade

Upgraded the application to Material UI (MUI) v9, enabling access to the latest component library improvements, enhanced theming capabilities, accessibility updates, and long-term framework support.

Security

Helmet Security Headers & Rate Limiting

Enhanced backend security by:

• Adding Helmet security headers
• Introducing Express rate limiting middleware
• Fixing trust proxy configuration to prevent IP spoofing

Fixed

• Screen share participant name not always visible
• Background effects delete icon not visible
• Enable/disable captions not working correctly in certain flows
• Vonage subscriber not created edge case causing unhandled errors
• App failing to detect OS-level microphone permission blocks
• Feedback report endpoint returning 500 errors
• Local screen share view not hidden when sharing the entire screen (preventing infinite mirror effect)
• Incorrect layout margins in the Goodbye component on small viewports

Known Issues

The list of known issues can be found here.

Added

• Improved the camera selector UI in the waiting room to better handle cases where no camera device is available.
• Added a warning indicator for Recording & Transcription status.
• Implemented backend Gollum integration for client events.
• Introduced the Vera Room embeddable component.
• Updated the icon in Video Effects.
• Added German language support with full translations.
• Displayed App and SDK versions in the footer.
• Config.json is now embedded at build time from vcrBuild.env.sh, there is no longer any runtime dependency.

Fixed

• Fixed layout margins in the GoodBye component for improved responsiveness.
• Made the recording indication always visible.
• Removed unused warning logs from the publisher.
• Hid the Video Effects option in MenuMoreOptions on unsupported browsers.
• Prevented zooming in and out in unsupported browsers (Firefox and Safari).

Known Issues

The list of known issues can be found here.

Added

• Added a link to cross-platform support in the README.
• Implemented makeRoomContextWrapper to compose all room-related providers for unit testing.
• Replaced mocked context and session hooks in unit tests.
• Introduced an initial base for the logging system.
• Refactored device handling with unified hooks and standardized usage.
• Added a common library with shared utility functions across the app.
• Upgraded Axios to the latest version.
• Updated README with new Vonage branding and a welcome section.

Fixed

• Updated error text color in FormSubmitted and adjusted Toolbar color for dark mode.
• Fixed an issue where device names were truncated incorrectly.
• Added padding to active speaker and screen share views.
• Fixed an issue where the emotions tab did not automatically close in small view.
• Resolved a TIMEOUT issue preventing publishers from subscribing to other users.
• Fixed misalignment between user pin and microphone icon.
• Enabled vertical scrolling on mobile screens.
• Fixed Pre-call Network Quality Test buttons (“Close” and “Stop test”) having identical behavior.
• Added padding around the Video component for screen widths between 900px and 1150px.
• Removed unused UI code from the library.
• Fixed video preview issues in Firefox.
• Ensured usernames remain visible on white backgrounds.
• Fixed an issue where the preview camera stayed on when it was turned off.

This release focuses on the following UX and UI improvements:

• Introduced a new Semantic UI token library for improved design consistency.
• Updated the landing page.
• Redesigned header (now including a language selector) and footer.
• Improved waiting room and meeting room experiences.
• Refreshed goodbye and unsupported browser pages.

Added

• Added a pre-call network test in the waiting room.
• Implemented Push-to-Talk functionality in the meeting room.
• Enabled camera toggle on mobile devices.
• Added participant list filtering in the meeting room.
• Added GitHub Copilot instructions to the repository.

Fixed

• Improved code quality with stricter TypeScript checks, enhanced linting, and stronger unit test coverage.
• Increased test reliability and introduced a new application configuration context for scoped reactivity.
• Migrated the repository to Nx, enabling faster builds through intelligent caching and task orchestration.
• Patched CVE-2025-55182.
• Camera and audio settings now persist after page reload.
• Fixed automatic camera detection when a camera becomes available during an ongoing meeting.
• Updated Vonage Video SDK to v2.32.1.
• Users are redirected to the waiting room if a username is not provided when entering the meeting room.
• Fixed Zoom to be fully clickable.

This release introduces several new features and improvements aimed at enhancing user experience and customization options.

Added

• Localization Support: Added multilingual support with a built-in language selector. Available languages include: English (en), English – United States (en-US), Spanish (es), Spanish – Mexico (es-MX) and Italian (it).

• Background Replacement & Effects: Users can now customize their background during sessions. Options include:

  • Predefined or custom background images
  • Adjustable background blur effect

• Scroll & Zoom for Screen Share: Added scroll and zoom functionality to the subscriber screen share view.

• Enhanced Configuration Options: A new configuration file enables users to control the visibility of specific functionalities (e.g., Screen Share) directly from settings.

Fixed

• Ghost Participant Issue: Fixed an issue where a user could remain in a call while others could not see them, even though they could still view all participants.

• Muted Icon Visibility: The publisher’s muted icon now correctly appears in their own participant list.

• Device Label Cleanup: Removed unnecessary characters from audio and device labels for cleaner display.

• Camera LED Behavior: Resolved an issue where the camera LED would remain on even when video was not being published.