デスクトップ（Web）向け Video API リファレンスアプリ Release Notes

追加

• 動画および画面共有の設定が拡充されました。カメラと画面共有が別々のセクションになり、画面共有の解像度、フレームレート、ビットレート、コーデックの優先順位、およびスケーラブルな画面共有を個別に設定できるようになりました。また、コンテンツの最適化、ローカルカメラのミラーリング、解像度/フレームレートのオーバーレイ表示のオン/オフ切り替え機能が追加されました。 画面共有のコーデックおよびスケーラビリティの変更は、次回の画面共有開始時に適用されます。
• 優先する画面共有対象領域 — ブラウザの共有ピッカーで、画面全体、ウィンドウ、ブラウザタブなど、デフォルトの共有対象領域を指定する設定が追加されました。
• 音声処理の設定 — 「音声」設定に、WebRTCのエコーキャンセル、ノイズ抑制、自動ゲイン制御、およびVonageの高度なノイズ抑制設定が追加されました。
• 可観測性の向上 — パブリッシャーおよびサブスクライバーのメディア統計に加え、ネットワーク状態の統計情報を追加しました。
• サーバー移行後の録画の自動復旧 — サーバーのローテーション後にセッションの移行と録画の自動再開を有効化し、すでに同意済みの参加者に対して同意の確認画面を再度表示する必要がなくなりました。この機能を利用するには、プラットフォームの対応およびセッション／アーカイブのWebhookの設定が必要です。字幕は自動的に再開されません。セッション移行ガイド
• Okta 認証：ベアラー・トークンのイントロスペクション機能と、PKCE 対応の OAuth 2.0 認証コードを使用したブラウザベースのログインフローを備えた、オプションの Okta 認証を追加しました。 ブラウザのアクセストークンはサーバー側で保持され、不透明な HttpOnly セッション Cookie によってブラウザのセッションが安全に管理されます。認証が有効になっている場合、未認証のユーザーは自動的にサインインページにリダイレクトされます。デフォルトでは、認証は無効のままです。
• 日本語ローカライズ — 日本語UIのサポートを追加し、未翻訳部分をすべて翻訳しました。

固定

• トークンの有効期限をUNIX秒単位で設定するように修正しました。セッション参加トークンの有効期限は24時間となり、クライアント側の入力によって、サーバー側で制御されるトークンの役割や有効期限を上書きすることはできなくなりました。
• ログに記録したり転送したりする前に、機密性の高いリクエスト／レスポンスヘッダーおよびネストされたクライアントログフィールドを伏せ字処理しました。
• 非同期 /v2/hooks ハンドラの失敗によりバックエンドがクラッシュするのを防ぎました。
• 加入者統計の重複を修正し、加入者ごとの統計を分離するとともに、測定されたフレームレートとエンコード解像度を報告するようにしました。
• 本番環境でのカスタム背景画像の読み込みを修正し、カスタム画像が削除された際にアクティブ状態のエフェクトを解除しました。
• ビデオエフェクトおよび画面共有のズーム機能の利用可否チェックを修正しました。また、通話前のネットワークテストによる利用可否の確認と、メディアプロセッサのサポート状況の確認を分離しました。
• 「Escape」キーの押下や背景のクリックが、録画同意の拒否とみなされるのを防ぎました。
• オーディオ出力の空の状態が重複する問題を修正し、マイクアイコンの表示の一貫性を整えました。
• ドイツ語、スペイン語、メキシコ・スペイン語、イタリア語の翻訳を完了し、ブラウザの地域別言語コードを標準化しました。
• 画面共有参加者の名前が、地域設定に応じて正しく表示されるようになりました。
• 絵文字リアクションで参加者の名前が切り取られる問題を修正し、通話前のネットワークテストにおけるタイムアウトエラーを地域に合わせて対応するとともに、デフォルトのタイムアウト時間を延長しました。
• フロントエンドの設定：app-config.json を使用し、yarn sync:env を実行してください。生成された env.sh ファイルは、直接編集しないでください。
• カスタムテーマ：designTokens.json を、再構成された theme.json 形式に移行してください。テーマトークンの名前も変更されています。設定ガイド
• Node.js：サポートされるエンジンの範囲は、^22.13.0 || >=24 となりました。
• 依存関係：Vonage Video Client SDK を 2.34.0 から 2.35.1 に、network-test ライブラリを 5.0.0 から 5.1.2 に、 React Routerを6.30.3から7.18.2へ、OpenTokレイアウトライブラリを5.5.0から5.5.1へ更新しました。その他にも、いくつかの依存関係を更新しました。

既知の問題

既知の問題のリストはこちら これ.

新機能

詳細設定：品質管理と可観測性

専用のタブを備えた新しいダイアログにより、ユーザーはメディアの設定やリアルタイムのモニタリングを完全に制御できるようになります。

動画設定

設定：

• 決議
• フレームレート
• カスタムビットレート
• コーデックの優先順位（VP8、VP9、H.264）

オーディオ設定

制御：

• ビットレートモード
• Opus DTX
• パブリッシャー／サブスクライバーのオーディオフォールバック

オブザーバビリティ・パネル

モニター：

• 水路の状態
• リアルタイムの品質指標

VideoHandler v2 API

新しいものを導入しました /v2 バックエンドルーターは、以下の技術によって提供されています createVideoHandler、以下のWebhookエンドポイントに対応しています：

• セッション・ライフサイクル・イベント
• ライフサイクルイベントのキャプション
• アーカイブのライフサイクルイベント

セッションキーの抽象化

JWT ベースの SessionKey これで raw に置き換わりました sessionId バックエンドのセッション管理レイヤー全体において、以下の点を改善します：

• セキュリティ
• 一貫性

ログのバッチアップロード

新しいものを追加しました /client-logs/batch ログイベントの配列を受け取り、それらを単一のリクエストとして転送するエンドポイント。これにより、高頻度のロギングに伴うオーバーヘッドを軽減します。

ロガー・シンクロナイザー

自動的に同期を行う新しいコンポーネントを導入しました：

• ユーザーID
• セッションID
• 接続ID

フロントエンド・ロガーのコンテキストに取り込み、ログの関連付けの一貫性を確保します。

再利用可能な通知システム

追加された：

• NotificationsContainer
• 実行時ロガープロバイダー

アプリ内通知を表示するための統一されたシステムを提供すること。

UIテーマのカスタマイズ

追加された：

• designTokens.json
• yarn sync:theme-tokens

アプリケーション全体でのビジュアルテーマのカスタマイズに対応するため。

Vonage ビデオホストの設定

のサポートが追加されました。 VONAGE_VIDEO_HOST 環境変数により、アプリケーションがカスタムのVonage Video APIエンドポイントに接続できるようになります。

「カメラが利用できません」という通知

セッション中にカメラが利用できなくなった場合、ユーザーに通知が表示されるようになりました。

改善点

設定可能な環境に関するドキュメント

README を拡充し、以下の内容を網羅した詳細なドキュメントを追加しました：

• UIのカスタマイズ
• 環境設定オプション

Material UI v9 へのアップグレード

ApplicationsをMaterial UI（MUI）v9にアップグレードし、コンポーネントライブラリの最新の改良点、テーマ設定機能の強化、アクセシビリティの更新、およびフレームワークの長期サポートを利用できるようにしました。

セキュリティ

ヘルメット・セキュリティ・ヘッダーとレート制限

以下の取り組みにより、バックエンドのセキュリティを強化しました：

• ヘルメットセキュリティヘッダーの追加
• Expressのレート制限ミドルウェアのご紹介
• 修正 trust proxy IPスプーフィングを防ぐための設定

固定

• 画面共有の参加者の名前が常に表示されるとは限らない
• 背景効果の削除アイコンが表示されない
• 特定のフローにおいて、字幕の有効化／無効化が正しく機能しない
• Vonageの加入者が作成されないというエッジケースにより、未処理のエラーが発生している
• アプリがOSレベルのマイク権限のブロックを検知できない
• フィードバックレポートのエンドポイントが500エラーを返している
• 画面全体を共有する際、ローカルの画面共有ビューが非表示にならない（無限ミラー効果を防ぐため）
• 小さなビューポートでの「Goodbye」コンポーネントのレイアウトマージンが不正確

既知の問題

既知の問題のリストはこちら これ.

追加

• 待合室のカメラセレクターのUIを改善し、カメラデバイスが利用できない場合にも対応できるようにしました。
• 録音とテープ起こしのステータスに警告インジケータを追加。
• 顧客イベントのバックエンドGollumインテグレーションを実装。
• Vera Room埋め込みコンポーネント導入。
• ビデオエフェクトのアイコンを更新しました。
• 完全な翻訳を伴うドイツ語サポートを追加。
• フッターにアプリとSDKのバージョンを表示。
• ビルド時にvcrBuild.env.shからConfig.jsonが埋め込まれるようになり、実行時の依存関係がなくなりました。

固定

• GoodByeコンポーネントのレイアウトマージンを修正し、応答性を改善しました。
• 録画表示を常に見えるようにした。
• パブリッシャーから未使用の警告ログを削除しました。
• 非対応ブラウザで、MenuMoreOptionsのVideo Effectsオプションを非表示にしました。
• 未対応のブラウザ（FirefoxとSafari）でズームインとズームアウトができないようにした。

既知の問題

既知の問題のリストはこちら これ.

追加

• READMEにクロスプラットフォーム・サポートへのリンクを追加。
• ユニット・テストのために、すべてのルーム関連プロバイダーを構成する makeRoomContextWrapper を実装した。
• ユニットテストのモックされたコンテキストとセッションフックを置き換えた。
• ロギングシステムの初期ベースを導入。
• 統一されたフックと標準化された使用方法で、デバイス処理をリファクタリング。
• アプリ全体で共有されるユーティリティ関数を備えた共通ライブラリを追加。
• アクシオスを最新バージョンにアップグレード。
• READMEを更新し、新しいVonageブランドとウェルカムセクションを追加しました。

固定

• FormSubmittedのエラーテキストの色を更新し、ダークモードのツールバーの色を調整しました。
• デバイス名が正しく切り捨てられない問題を修正しました。
• アクティブスピーカーと画面共有ビューにパディングを追加。
• スモールビューでエモーションタブが自動的に閉じない問題を修正しました。
• パブリッシャーが他のユーザーを購読できないTIMEOUTの問題を解決しました。
• ユーザーピンとマイクアイコンのズレを修正。
• モバイル画面での縦スクロールを可能にした。
• 通話前のネットワーク品質テストボタン（「閉じる」と「テスト停止」が同じ動作になっていたのを修正しました。
• 画面幅が900pxから1150pxの場合に、Videoコンポーネントの周囲にパディングを追加しました。
• ライブラリから未使用のUIコードを削除。
• Firefoxでのビデオプレビューの問題を修正しました。
• ユーザー名が白い背景でも表示されるようにした。
• プレビューカメラがオフになってもオンのままになっていた問題を修正。

このリリースでは、以下のUXとUIの改善に重点を置いています：

• 新しいセマンティックUIトークンライブラリを導入し、デザインの一貫性を向上。
• ランディングページを更新。
• ヘッダーとフッターのデザインを一新。
• 待合室や会議室での体験を改善。
• さよならと未対応のブラウザページをリフレッシュ。

追加

• 待合室での通話前ネットワークテストを追加。
• 会議室にプッシュ・ツー・トーク機能を導入。
• モバイル端末でカメラの切り替えが可能に。
• 会議室に参加者リストのフィルタリング機能を追加しました。
• リポジトリにGitHub Copilotの説明を追加。

固定

• TypeScriptチェックの厳格化、リンティングの強化、ユニットテストのカバレッジ強化により、コード品質が向上した。
• テストの信頼性が向上し、スコープされた反応性のための新しいアプリケーション・コンフィギュレーション・コンテキストが導入された。
• リポジトリをNxに移行し、インテリジェントなキャッシュとタスクオーケストレーションによってビルドの高速化を実現。
• CVE-2025-55182 を修正した。
• カメラとオーディオの設定が、ページのリロード後も保持されるようになりました。
• 進行中の会議中にカメラが利用可能になった場合の自動カメラ検出を修正。
• Vonage Video SDKをv2.32.1に更新しました。
• 会議室に入室する際、ユーザー名が入力されていない場合、ユーザーは待合室にリダイレクトされます。
• ズームを完全にクリックできるように修正。