ビデオJavascript SDK Release Notes

v2.34.2 — 2026年6月

固定

  • セッション開始直後にオーディオ入力デバイスを切り替えた場合（たとえば、Bluetoothヘッドフォンを接続した場合など）、 audioAcquisitionProblem これにより、セッションがルーティングトポロジーに移行すると、リモート参加者の音声が完全に途絶えてしまうという問題が発生しました。

  • AndroidのChrome WebView内で実行されているApplicationsが、プレコールテストにアクセスできなかったり、ビデオ会議に参加できなかったりする問題を修正しました。

  • 欠落していた TypeScript の定義を修正しました： constraints その物件は、 GetUserMediaProperties インターフェース内 ot.d.ts, これにより、SDKの実際の実行時の挙動との不一致が生じます。

v2.34.1 — 2026年5月

固定

  • publisher.setPreferredResolution() を背景フィルター（ぼかしまたは置換）と組み合わせて使用した際に、公開解像度が予期しない値に変更されてしまう問題を修正しました。これにより、背景フィルターが適用された場合でも、パブリッシャーは意図した解像度を維持するようになりました。

  • バックグラウンドフィルター（ぼかしまたは置換）が有効な状態で、ビデオを一度オフにしてから再びオンにする（publishVideo(false) の後に publishVideo(true) を実行する）と、フィルター処理されていないフレームが遠隔地の参加者に一瞬表示されてしまう問題を修正しました。SDK では、ビデオが再有効化された後、フィルター処理されたフレームのみが送信されるよう保証されるようになりました。

  • v2.34で導入された変更のうち、OT.hasMediaProcessorSupport()のTypeScript定義において、mediaTypeパラメータが誤って必須とされていた問題を修正しました。これにより、mediaTypeパラメータはオプションとなり、引数なしでOT.hasMediaProcessorSupport()を呼び出す既存のコードとの互換性が回復しました。

v2.34.0 — 2026年5月

追加

  • ネットワーク状態に関する新たなインサイトが追加されました。このバージョンでは、クライアントの可観測性機能に新しいネットワーク状態メトリクスが追加され、ネットワークのパフォーマンスや品質指標を詳細に把握できるようになりました。これらのメトリクスは、バージョン 2.33.0 で導入されたパブリッシャーおよびサブスクライバーの統計情報を補完するものであり、開発者が動画の品質に影響を与えるネットワーク状態をプロアクティブに監視し、接続の問題を診断し、必要な調整について適切な判断を下すのに役立ちます。 詳細については、以下を参照してください。 本書.

  • Safari および Firefox での背景ぼかしと背景置換のサポートが追加されました。このバージョンでは、Safari および Firefox での背景ぼかしと背景置換のサポートが追加されています。これにより、すべての主要なブラウザおよびデバイス間で機能の一貫性が確保され、プラットフォームを問わず背景効果のサポートを統一してほしいというお客様のご要望にお応えします。 必要なブラウザAPIが利用可能かどうかを確認するため、SDKはインラインWebワーカーを使用します。このインラインWebワーカーは、厳格なCSPを適用しているApplications（具体的には、以下を含んでいないApplications）において、コンテンツセキュリティポリシー（CSP）違反を引き起こす可能性があります。 blob: そして data: での worker-src または child-src ディレクティブを参照してください。詳しくは 本書.

  • 「Live Captions Translation」のサポートが追加されました。このバージョンでは、ビデオ通話中にリアルタイムで字幕を翻訳する「Live Captions Translation」のサポートが追加されました。各参加者は、各自で希望する翻訳言語を個別に選択できます。この機能は、AWS Translateがサポートするすべての言語に対応しています。これはプライベートベータ機能です。プロジェクトで「Live Captions Translation」を有効にするには、弊社までお問い合わせください。 Live Captions の詳細については、以下をご覧ください。 本書.

固定

  • このバージョンでは、加入者作成直後にメディア プロセッサ コネクタを設定すると失敗するタイミングの問題が修正されました。SDKは、コネクタを適用する前にストリームが利用可能になるまで待機するようになりました。

  • このバージョンでは、End-to-end EncryptionとSingle Peer Connectionの両方が有効なセッションで、ストリームがサブスクライブに失敗する問題が修正されました。

  • このバージョンでは、ネットワーク復旧時に不要な接続リセットを引き起こす可能性があった自動再接続処理の問題が修正されました。安定したピア接続を中断することなく、より確実に再接続が行われるようになりました。

  • このバージョンでは subscribeToVideo(true) 加入者初期化の直後、ビデオトラックがまだ受信されていない場合、失敗する可能性がある。

  • このバージョンでは、パケットロスが誤って計算されていた問題や、特定の状況でオーディオのフォールバックイベントが発生しなかった問題を修正しました。これらの修正点は、 ネットワーク状況の分析 この機能は、オーディオフォールバックイベントがネットワークの状態を判断するための入力要素の一つであるため重要です。これらの修正により、オーディオフォールバックの動作がより正確かつ信頼性の高いものになります。

v2.33.1 — 2026年3月

必要条件

OpenTok.jsライブラリは現在、以下の言語でサポートされています：

  • エレクトロン（最新バージョン）
  • グーグル・クローム（最新版）
  • Android版Google Chrome（最新リリース版）
  • iOS版Google Chromeのベータ版サポート（最新リリース版）
  • Firefox（最新バージョン）
  • Android版Firefox（最新リリース版）
  • iOS版Firefoxのベータサポート（最新リリース版）
  • Windows および macOS 用 Microsoft Edge バージョン 79 以上（Chromium ベースの Edge バージョン）
  • macOSおよびiOSのSafari 11+。ビデオの相互運用性やその他の問題については サファリ・ブラウザ対応 ページを参照されたい。
  • オペラ（最新バージョン）
  • サムスン（最新リリース版）
  • WebView Android API レベル36以上
  • iOS 18.6+でのWebView

重要OpenTok.jsバージョン2.16は、Internet Explorer用プラグインをサポートする最後のバージョンです。OpenTok.jsバージョン2.16は、スタンダード環境では2020年5月、エンタープライズ環境では2020年6月に非推奨となります。

OpenTok.js ライブラリはポート 443 を使用します。ポート 443 はクライアントのネットワーク上で開いている必要があります。

既知の問題

ブラウザ固有の問題

サファリ
  • キャンバスコンテンツをストリーミングする際、内部でのダウンサンプリング、デバイスのピクセル比の処理、またはSafariのWebRTCエンコーディングの影響により、動画の画質が低下して見える場合があります。こちらをご覧ください WebKitのバグ.
  • WebKitベースのブラウザ（macOS/iOS版のSafari、iOS版のChrome）で開発者ツールが開かれている場合、エンドツーエンド暗号化が機能しません。現在、修正に取り組んでいます。
  • Video JavaScript SDK 2.27 以降では、Safari 14 以前のバージョンではサポートされていません。
  • 新しい購読者の音声は、ブラウザのタブにフォーカスを合わせるまで聞こえません。そのタブに切り替えると、音声が復元されます。こちらをご覧ください WebKitのバグ.
  • Safari 17.0 以降では、画面共有の動画については解像度の設定が無視されます。その結果、解像度は常に 640x360 になります。こちらをご覧ください WebKitのバグ.
  • 呼び出す際には OT.initPublisher() ユーザージェスチャーハンドラなしで画面共有パブリッシャーを初期化すると、 InvalidAccessError. これは Safariの想定される動作.
  • iOS 16.4以降でiCloudプライベートリレーが有効になっている場合、リレー中のセッションで接続が切断されることがあります。詳細はこちらをご覧ください WebKitのバグ.
  • iOS版のSafariでは、着信後に音声や映像が途切れることがあります。通話に応答してセッションに戻った後、iOSデバイスからの音声や映像が途切れる場合があります。以下のWebKitのバグを参照してください： #213853, #219318.
  • iOS/iPadOSのSafariから配信されるストリームの音質は、時間の経過とともに劣化し、パチパチという音や歪みが生じる場合があります。こちらをご覧ください WebKitのバグ.
iOS
  • iOSのブラウザをご利用の購読者の方には、場合によっては音量が正しく設定されていないことがあります。現在、修正に取り組んでいます。こちらをご覧ください WebKitのバグ.
  • iOS 17以降で、デバイスの向きを変更したり、動画のサイズを変更したりすると、動画がちらつきます。こちらをご覧ください WebKitのバグ.
  • iOS 17以降では、ビデオパブリッシャーで動画が当初、誤った解像度で表示され、サイズ変更の際に目に見えるちらつきが発生します。詳細はこちらをご覧ください WebKitの回帰バグ.
  • Appleの仕様により、iOS 17の動画に予期せず絵文字が表示されることがあります。 反応 機能です。エンドユーザーは手動でこの機能を無効にする必要があります：コントロールセンターを開き → 「ビデオエフェクト」をタップ → 「リアクション」をタップします。
Chrome / Chromium
  • Intel Smart Sound Technology オーディオドライバーがインストールされている Windows 環境では、パブリッシャーが audioInputDeviceChanged オーディオ入力デバイスを切り替えた際に発生する現象です。音声は引き続き正しく出力されます。現在、修正に取り組んでいます。
  • 公開中にノートパソコンの蓋を閉じると、パブリッシャーが破棄されてしまいます。こちらをご覧ください クロミウムのバグ.
  • Chrome 73以降では、ステレオ音声入力時にエコーキャンセルが無効になります。詳細はこちらをご覧ください Chromeの問題.
  • 以下の環境では公開機能はサポートされていません http ページ（ただし、 http://localhost). ページは、以下の方法で配信されなければなりません。 https.
  • 以下の条件を満たすストリームでは、動画がちらつくことがあります。 videoType に設定する。 "custom" 動画コンテンツに大きな変化がない場合。設定 videoContentHint への text または detail この問題を緩和します。詳しくは、 動画設定ガイド.
ファイアフォックス
  • macOS版のFirefoxで、内蔵のFaceTimeカメラを使用する場合、フレームレートを設定しても効果はありません。こちらをご覧ください Mozillaのバグ.
  • セッティング audioBitrate で OT.initPublisher() Firefoxでは効果がありません。こちらをご覧ください Mozillaのバグ.
  • Android 13では、Firefoxのマイクおよびカメラの権限設定を有効にするには、設定後に端末を再起動する必要があります。
  • Android 13 では、画面の向きを切り替えた際に、動画の解像度が正しく更新されない場合があります。こちらをご覧ください Mozillaの回帰現象.
アンドロイド
  • Android 12 および 13 では、Chrome で音量を調整するには、端末の音量スライダーではなく「メディア音量」を使用する必要があります。こちらをご覧ください クロミウムのバグ.
  • AndroidのWebViewでは、アプリがバックグラウンドに移行すると（アプリ切り替えや着信時など）、パブリッシャーの動画が停止し、フォアグラウンドに戻っても再生が再開されません。

マックオス

  • Appleの仕様により、macOS 14（Sonoma）の動画に予期せず絵文字が表示されることがあります。 反応 機能。無効にするには：メニューバーの緑色のカメラアイコンをクリックし、「リアクション」のチェックを外します。

一般的な問題

  • について accessDialogOpened を呼び出す際に、イベントが誤ってディスパッチされる可能性があります OT.getUserMedia()、アクセス許可のダイアログが表示されなかった場合でも。
  • 場合によっては、Google スライドのプレゼンテーションをタブ共有する際、公開者のアスペクト比が 4:3 の場合、動画にレターボックスが表示されることがあります。プレゼンテーション全体を画面共有する場合は、この現象は発生しません。
  • 一部のモバイル版Firefoxユーザーの場合、デバイスの向きによって、配信元の動画ストリームが破損することがあります。こちらをご覧ください Mozillaのバグ.

修正された問題

  • 複数の参加者による長時間セッションに影響するメモリーリークを修正しました。
  • TypeScriptの定義で、publisher statsプロパティの名前が誤っていた問題を修正しました。 transport の代わりに transportStats.

v2.33.0 — 2026年2月

新機能と変更点

  • 新しいパブリッシャーおよびサブスクライバーの統計情報と、動画品質の変更イベントが追加されました。このバージョンでは、以下の新しいパブリッシャーおよびサブスクライバーの統計情報が追加されています。パブリッシャー向けには、同時配信（Simulcast）およびSVCの動画レイヤーメトリクス、トランスポート統計情報。サブスクライバー向けには、動画のフリーズ／一時停止の追跡およびデコードメトリクス。さらに、パブリッシャーとサブスクライバーの両方に対して、動画品質の変更イベントが追加されています。詳細については、以下を参照してください。 本書.

  • ビデオセッションにおける送信者のネットワーク統計情報の完全なサポートが追加されました。このバージョンでは、ビデオセッションにおける加入者向けの送信者のネットワーク統計情報の完全なサポートが追加されました（これまではベータ版でした）。詳細については、以下を参照してください。 本書.

  • パブリッシャー向けの推奨動画解像度およびフレームレートのサポートが追加されました。このバージョンでは、パブリッシャーの推奨動画解像度およびフレームレートを設定するための新しいメソッドが追加されました。これにより、パブリッシャーの初期化時に指定された解像度やフレームレートを超えない範囲で、送信される動画の品質を動的に調整できるようになります。詳細については、以下を参照してください。 本書.

  • OpenTok.js では、iOS 版 Google Chrome を完全にサポートするようになりました。詳細については、以下をご覧ください。 本書.

  • を非推奨としました。 video.frameRate プロパティは Subscriber.getStats() 完了ハンドラ。このプロパティは非推奨となっており、将来的に削除される予定です。代わりに、 video.decodedFrameRate プロパティを使用してください。詳しくは 本書.

修正された問題

  • Publisher Max BitrateのTypeScript定義が以前のリリースに含まれていなかった問題を解決しました。
  • シグナリングプロトコルのウェブソケット処理ロジックにおけるメモリーリークを修正。
  • オーディオ処理オプション（ゲインコントロール、エコーキャンセルなど）が特定のシナリオで正しく適用されない問題を修正しました。
  • デフォルト・デバイスの切り替え検出やデバイスのトラッキング精度など、オーディオ入力デバイスの変更管理に関する問題を修正しました。