リリースノート

CHANGE

後方互換性のない変更

UPDATE

後方互換性がある変更

ADD

後方互換性がある追加

FIX

バグ修正

2024.1.1

バグフィックスアップデート

リリース:

2024 年 7 月 1 日

  • [FIX] 録画機能利用時、パケットのタイムスタンプに異常がある場合に発生する問題を修正しました

2024.1.0

メジャーアップデート

リリース:

2024 年 6 月 26 日

ハイライト

  • クラスターリレー機能を追加しました

    • いずれのノードからでも同一のチャネルに接続できるようになりました

  • クラスターアフィニティ機能を追加しました

    • リレー機能利用時に、特定のノードに同一セッションの接続を集約する仕組みを追加しました

    • この機能によりノード間通信を極力発生させないようにすることができます

  • ライセンスの同時接続数の合計を維持する機能を追加しました

    • ノードに障害が発生したとしても、クラスター全体の同時接続数を維持できるようになりました

  • テンポラリーノード機能を追加しました

    • クラスターの維持に影響しないノードを手軽に削除できるようになりました

  • OBS WHEP に対応しました

    • OBS の WHEP ソース機能を利用し Sora から映像を取得できるようになりました

    • 2024 年 6 月 現在、OBS 安定版では WHEP に対応していません

  • OBS WHIP/WHEP の TURN に対応しました

    • 2024 年 6 月 現在、OBS 安定版では TURN に対応していません

  • OBS WHIP/WHEP の H.265 (HEVC) に対応しました

    • 2024 年 6 月 現在、OBS 安定版では H.265 に対応していません

  • セッションとコネクションが破棄される時間を指定できるライフタイム機能を追加しました

    • セッションやコネクションで指定した時間が経過すると自動的に破棄されるようになりました

  • 複数のコーデックで、複数の画質が同時に配信できるサイマルキャストマルチコーデック機能を追加しました

    • 2024 年 6 月 現在、ブラウザでは利用できません

  • 音声トラックを削除した後に、再度音声トラックを追加した際に正常に録音されない問題に対応しました

    • Chrome/Edge の不具合により、今まで音声がずれて録画されてしまっていた問題を解決しました

    • Safari でも同様の不具合を確認していますが、本対応では解決できていません

正式版

今回のリリースで以下の機能は実験的機能から正式版になりました。

廃止情報

  • CentOS 7 向けパッケージの提供を終了しました

  • モード機能のイニシャルモードを廃止しました

  • 認証成功時に払い出す h264_profile_level_id を廃止しました

    • 代わりに "video_h264_params": {"profile_level_id": "<profile-level-id>"} を使用してください

  • sora.conf から default_h264_profile_level_id を廃止しました

  • 実験的機能として提供していた sora.conf の rtp_publish_worker_number を廃止しました

  • 実験的機能として提供していた Lyra を廃止しました

    • Opus 1.5 で Lyra 同様の低ビットレートが利用可能になったこと、Lyra が 2 年間更新がないことが廃止の理由です

  • sora.conf の contact_node_name_list を廃止しました

  • sora.conf の cluster_auto_connect を廃止しました

    • クラスター機能の自動での再接続は常に有効になります

非推奨情報

  • Ubuntu 20.04 の提供を Sora 2024.1.x 系をもって終了します

    • Ubuntu 20.04 は 2025 年 4 月にサポートが終了します

  • multistream: false で利用するレガシーストリームを非推奨にしました

  • JoinCluster API を非推奨にしました

    • JoinCluster API は 2024 年 12 月リリース予定の Sora で廃止されます

    • RegisterClusterNode API を利用してください

  • ListClusterNodes API の include_all_known_nodes 指定を非推奨にしました

    • include_all_known_nodes は 2024 年 12 月リリース予定の Sora で廃止されます

    • 廃止後は include_all_known_nodes が常に true として動作するようになります

  • 統計エクスポーター機能を非推奨にしました

    • 統計エクスポーター機能は 2025 年 6 月リリース予定の Sora で廃止されます

    • 統計ウェブフック を利用してください

  • ユーザエージェント統計を非推奨にしました

    • ユーザエージェント統計は 2025 年 6 月リリース予定の Sora で廃止されます

    • RTC 統計情報を利用してください

  • ユーザエージェント統計 API を非推奨にしました

    • ユーザエージェント統計 API は 2025 年 6 月リリース予定の Sora で廃止されます

    • RTC 統計情報 API を利用してください

破壊的変更

  • クラッシュを意図的に発生させるテスト用 Sora_20221221.GenerateCrashLog API を Sora_20380119.GenerateCrashLog に変更しました

  • イベントウェブフック connection.destroyed の reason に含まれる値を変更しました

    • 2023.2.x までは disconnected_api_reason と同じ、または disconnected_api_reason が無ければ null が含まれていました

    • 2024.1.x からは normal / disconnected_api / session_destroyed / lifetime_expired が含まれるようになります

    • 2023.2.x までの設定を維持する移行用の設定 legacy_event_webhook_connection_destroyed_reason を追加しています

      • この移行用の設定 legacy_event_webhook_connection_destroyed_reason は 2024 年 12 月リリース予定の Sora にて廃止します

    • 詳細は connection.destroyed の reason に破壊的変更を行いました をご確認ください

  • 統計 API の RTP ヘッダー拡張の項目名のプレフィックスを rtp_hdr_ext から rtp_hdrext へ変更しました

  • TerminateSession API を非同期に変更しました

    • セッション破棄の確認は session.destroyed ウェブフックを利用してください

  • ライセンスチェックのタイミングを変更しました

    • 今までは WebSocket 接続時にライセンスチェックを行っていましたが、 "type": "connect" 時にチェックを行うように変更しました

      • WHIP と WHEP については変更はありません

    • 詳細についてはサポートまでお問い合わせください

変更履歴

  • [CHANGE] シグナリング "type": "disconnect" 時に指定できる reason の最大値を 128 バイトに制限しました

  • [CHANGE] TerminateSession API を非同期に変更しました

    • セッション破棄の確認は session.destroyed ウェブフックを利用してください

  • [CHANGE] 統計 API の RTP ヘッダー拡張の項目名のプレフィックスを rtp_hdr_ext から rtp_hdrext へ変更しました

  • [CHANGE] モード機能のイニシャルモードを廃止しました

  • [CHANGE] 最大帯域幅指定で利用する SDP を b=TIAS と b=AS から b=TIAS のみに変更しました

  • [CHANGE] 帯域推定で利用する REMB で送信するビットレートを b=TIAS のみに変更したのに合わせて音声ビットレートを含めないようにしました

  • [CHANGE] 音声コーデック Lyra への対応を廃止しました

  • [CHANGE] SDP の msid の appdata を UUIDv4 を BASE32 でエンコードした値から、 connection_id に メディアの種類を追加した値に変更しました

  • [UPDATE] 開発ツール を最新版に更新しました

  • [ADD] Ubuntu 24.04 x86_64 と arm64 版のパッケージ提供を開始しました

  • [ADD] connection.jsonl にコネクションを破棄した理由 destroyed_reason を追加しました

    • destroyed_reason には normal / disconnected_api / session_destroyed / lifetime_expired が含まれます

  • [ADD] sora.conf に VP9 利用時に RTP ヘッダー拡張 dependency_descriptor を払い出す rtp_hdrext_dependency_descriptor_vp9 を追加しました

    • デフォルトは false です

    • この設定を true した場合 Firefox で VP9 が利用できなくなります

  • [ADD] ListConnections API と ListChannelConnections API の戻り値に recording_block 項目を追加しました

  • [FIX] メッセージングオンリー機能利用時に multistream: true の指定を不要にしました

テスト機能

  • [CHANGE] クラッシュを意図的に発生させるテスト用 Sora_20221221.GenerateCrashLog API のバージョンを変更し Sora_20380119.GenerateCrashLog API に変更しました

    • 今後、テスト API はバージョンが全て 20380119 に固定されます

  • [ADD] シグナリング通知を送信するテスト用 SendSignalingNotify API を追加しました

スポットライト機能

  • [ADD] スポットライト機能利用時に、セッションウェブフック session.updated と session.destroyed に spotlight_number 項目が含まれるようにしました

  • [ADD] セッションウェブフック session.created 時に spotlight_number を払い出せるようにしました

    • spotlight_number には 1 から 8 までの値を指定できます

    • セッションウェブフックで spotlight_number を払い出した場合、シグナリング接続時や認証成功時の払い出しの spotlight_number と異なる場合はエラーとなります。

    • シグナリング時と認証成功時の spotlight_number 指定は非推奨になりました

  • [FIX] スポットライト機能利用時に同一セッションで spotlight_number が同時接続数 0 の場合にシグナリング接続時、または認証成功時払い出しで変更できてしまう問題を修正しました

    • セッション破棄までは ChangeSpotlightNumber API 以外ではスポットライト数を変更できないように修正しました

  • [FIX] スポットライト機能利用時に multistream: true の指定を不要にしました

レガシーストリームを非推奨化

今まで multistream: false で利用していた、レガシーストリーム(非マルチストリーム)を非推奨にしました。 レガシーストリームは 2025 年 6 月に廃止します。

  • [CHANGE] sora.conf にレガシーストリームを有効にする legacy_stream を追加しました

    • デフォルトは false です

    • レガシーストリームを利用する場合は true に設定してください

詳細は レガシーストリーム(非マルチストリーム)機能からマルチストリーム機能への移行 をご確認ください。

ウェブフック機能

  • [ADD] sora.conf に認証ウェブフック失敗時に auth_webhook.jsonl にのみログを出力する legacy_auth_webhook_log を追加しました

    • 2023.2.x までの挙動を維持する設定です

    • この設定は 2024 年 12 月リリース予定の Sora にて廃止されます

    • デフォルトは false です

    • この設定を false にした場合、認証ウェブフックが失敗した際には auth_webhook_error.jsonl にログを出力します

      • auth_webhook.jsonl にはログを出力しません

    • この設定を true にした場合、認証ウェブフックが失敗した際には 2023.2.x までと同様に auth_webhook.jsonl にログを出力します

      • auth_webhook_error.jsonl にはログを出力しません

  • [ADD] sora.conf にウェブフックの接続確立タイムアウト時間を指定する webhook_connect_timeout を追加しました

    • 今までは固定の 600 s としていましたが、設定を追加するにあたりデフォルトを 30 s と変更しました

    • 範囲は 1 s から 600 s です

  • [ADD] 認証ウェブフックリクエストに Accept ヘッダーを追加しました

    • Accept ヘッダーに application/json が含まれます

  • [ADD] セッションウェブフックリクエストに Accept ヘッダーを追加しました

    • Accept ヘッダーに application/json が含まれます

  • [FIX] 認証ウェブフックでステータスコード 2XX で空ボディを受け取った際の不具合を修正しました

  • [FIX] 認証ウェブフックにシグナリング接続時の転送フィルターが含まれていない問題を修正しました

セッションウェブフック機能

  • [ADD] セッションウェブフック session.created の戻り値が正常では無い場合、エラーとしてセッションを破棄して、セッションウェブフック session.destroyed を送信する設定の session_created_response_validate_warning_as_error を sora.conf に追加しました

    • デフォルトは false です

    • false の場合はバリデーションに失敗した場合、デフォルト値が採用されそのまま処理は継続します

    • true の場合はバリデーションに失敗した場合、エラーとしてセッションを破棄します

      • セッションウェブフック session.destroyed の reason には validate_error が含まれます

  • [ADD] セッションウェブフック session.created のウェブフック処理中に問題が発生した際に session.destroyed の reason に webhook_error が含まれるようになりました

  • [ADD] セッションウェブフックがエラーになった理由を、 session_webhook_error.jsonl ログに reason として出力するようにしました

  • [FIX] セッションウェブフックの戻り値の JSON が不正な場合に、センシティブデータの処理をしていた問題を修正しました

  • [FIX] セッションウェブフックの戻り値が JSON オブジェクトではない場合に処理が失敗していた問題を修正しました

録画アーカイブイベントウェブフック機能

  • [ADD] 録画アーカイブ失敗時のウェブフック archive.failed に split と split_only と split_index を含むようにしました

  • [FIX] 分割録画にもかかわらず、録画アーカイブ失敗時のウェブフック archive.failed に分割録画ファイルが含まれない問題を修正しました

    • 一括と分割録画の両方が有効な場合、 filename と file_path と split_filename と split_file_path が含まれるようになります

    • 分割録画が有効な場合、 split_filename と split_file_path が含まれるようになります

    • 分割録画のみの場合、 filename と file_path は含まれなくなります

  • [ADD] テスト向け API として録画失敗を意図的に起こす FailArchive API を追加しました

    • 録画が実行されている指定した client_id の録画を失敗させます

    • イベントウェブフックの録画失敗ウェブフック archive.failed を意図的に発生させることができます

イベントウェブフック connection.destroyed の reason の破壊的変更

  • [CHANGE] イベントウェブフック connection.destroyed に含まれる reason の変更を行いました

    • 今までは disconnected_api_reason と同様、コネクション切断系 API で指定した reason 値、または未指定の場合は null が含まれていましたが、 今回の変更で normal / disconnected_api / session_destroyed / lifetime_expired のいずれかが含まれるようになりました

    • normal は通常のコネクション破棄

    • disconnected_api はコネクション切断系 API でコネクション破棄

    • session_destroyed はセッションライフタイムによりセッションの期限が切れた、または TerminateSession API によってセッション強制破棄されたことでのコネクション破棄

    • lifetime_expired はコネクションライフタイムによりコネクションの期限が切れたことによるコネクション破棄

  • [ADD] sora.conf にイベントウェブフック connection.destroyed に含まれる reason の値を、 disconnected_api_reason に含まれる値と同じにする移行用の設定 legacy_event_webhook_connection_destroyed_reason を追加しました

    • デフォルトは false です

    • 設定を true にした場合、 disconnected_api_reason の項目が無い場合は null が含まれます

      • また、コネクションライフタイム機能で切断したか際の判断ができなくなります

    • この設定は 2024 年 12 月リリース予定の Sora にて廃止されます

録画機能音ズレ問題の改善

この問題の改善はレガシー録画、セッション録画の両方で行っています。

Chrome / Edge 側のバグにより、録画機能利用時に replaceTrack などを利用して MediaStreamTrack を削除し、 一定時間経過後に新しく MediaStreamTrack を追加した際に、音声パケットに関連するタイムスタンプと NTP タイムスタンプが正しく出力されない問題あります。

この問題により Chrome / Edge では録音/録画したファイルにて音ズレが発生してしまう場合がありました。

今回、新しく利用できるようになった RTP ヘッダー拡張 abs-capture-timestamp を利用する事で、 音声タイムスタンプを実際の値に推測する機能を導入することでこの問題に対応しました。

この問題は Safari / Safari Technology Preview では RTP ヘッダー拡張 abs-capture-timestamp が音声パケットに含まれてこないため、 改善することができません。

  • [CHANGE] rtp_hdrext_abs_capture_time のデフォルトを true に変更しました

  • [FIX] RTP ヘッダー拡張録画機能の音声タイムスタンプの推測機能を利用し、Chromium ベースのブラウザで録音/録画を行った際、音ズレが発生する問題を修正しました

    • abs-capture-time が利用できない場合は今まで通り音ズレが発生する場合があります

OBS WHIP対応

これは実験的機能です

  • [CHANGE] ウェブフックの sora_client に含まれる type を OBS-Studio から OBS-Studio-WHIP に変更しました

    "sora_client": {
  "raw": "Mozilla/5.0 (OBS-Studio/30.1.0; Mac OS X; ja-JP)",
  "type": "OBS-Studio-WHIP",
  "version": "30.1.0",
  "environment": "environment":"Mozilla/5.0 (OBS-Studio/30.1.0; Mac OS X; ja-JP)"
},

  • [ADD] sora.conf に OBS WHIP で TURN を利用する whip_turn を追加しました

    • この設定は OBS が正式に TURN へ対応したタイミングで廃止します

  • [ADD] OBS WHIP/WHEP で将来的に必須になる rtcp-mux-only に対応しました

  • [ADD] OBS WHIP で H.265 (HEVC) に対応しました

    • OBS 30.1 ではまだ WHIP での H.265 はサポートされていません

OBS WHEP 対応

これは実験的機能です

OBS での WebRTC/WHEP に対応しました。WebRTC で送られてくる音声と映像を WHEP ソースとして利用する事ができます。

  • [ADD] OBS WHEP に対応しました

    • Opus と H.264 の組み合わせのみ利用できます

    • WHEP での接続は複数の配信が発生したタイミングで切断されます

    • WHEP での接続は複数の配信が存在するチャネルには接続できません

    • OBS 30.1 ではまだ WHEP に対応していません

  • [ADD] sora.conf に OBS (WHEP) を有効にする whep を追加しました

  • [ADD] sora.conf に OBS WHEP の Bearer トークンを認証ウェブフックの metadata に対応させるキーを指定する whep_bearer_token_metadata_key を追加しました

    • OBS WHEP からの接続についても Bearer トークンを利用した認証機能が利用できます

    • デフォルトは未指定です

  • [ADD] WHEP 向けエンドポイント URL https://example.com/whep/<channel-id> を追加しました

  • [ADD] WHEP 向けリソース URL https://example.com/whep-resource/<channel-id>/<secret> を追加しました

    • PATCH と DELETE メソッドに対応しています

  • [ADD] WHEP を利用した際、認証ウェブフックに whep: true を追加しました

    • WHEP を利用していない接続の場合はこの項目は含まれません

  • [ADD] OBS WHEP で User-Agent として送られてくる情報を sora_client としてウェブフックで送信するようにしました

    • "raw": "Mozilla/5.0 (OBS-Studio/31.0.0; Mac OS X; ja-JP)"

    • "type": "OBS-Studio-WHEP"

    • "environment": "environment":"Mozilla/5.0 (OBS-Studio/31.0.0; Mac OS X; ja-JP)"

    • "version": "31.0.0"

  • [ADD] sora.conf に OBS WHEP で TURN を利用する whep_turn を追加しました

    • この設定は OBS が正式に TURN へ対応したタイミングで廃止します

詳細は OBS (WHEP) 対応機能 をご確認ください。

クラスター機能

これは実験的機能です

  • [UPDATE] ListClusterNodes API にライセンス情報を追加しました

    • license_type

    • license_serial_code

    • license_max_connections

  • [UPDATE] ListClusterNodes API にエラー情報を追加しました

    • ノードに接続ができなかった場合、そのノード情報に error を含めるようにしました

  • [CHANGE] 最大ノード数ライセンスと通常ライセンスが同一クラスターで混在できなくなりました

  • [CHANGE] sora.conf の contact_node_name_list を廃止しました

  • [CHANGE] sora.conf の cluster_auto_reconnect を廃止しました

    • クラスター機能の自動での再接続は常に有効になります

  • [CHANGE] JoinCluster API の名前だけを変更した RegisterClusterNode API を追加しました

    • RegisterClusterNode API は JoinCluster API とまったく同じ動作をします

    • JoinCluster API は 2024 年 12 月にリリース予定の Sora で廃止されます

  • [ADD] クラスター利用時に以下の API でクラスター全体の結果を返せる仕組みを追加しました

  • [FIX] InitCluster API で指定するノードが全て同一バージョンでは無い場合、エラーを返すように修正しました

クラスターテンポラリーノード機能

これは実験的機能です

クラスターの維持に影響しない一時的なノードを追加できるようになりました。 テンポラリーノードを利用する事でスケールアウト/スケールインが容易になります。

  • [ADD] sora.conf にテンポラリーノードとして利用する cluster_temporary_node を追加しました

    • デフォルトは false です

    • この設定は cluster が true の時のみ有効です

    • この機能は 最大ノード数ライセンス のみ有効です

    • テンポラリーノードはクラスター構成を維持するためのノードとしては認識されません

    • テンポラリーノードに障害が発生してもライセンスで決められた最大同時接続数の合計を維持する機能による接続数の維持は行われません

    • テンポラリーノードはクラスターへの登録には RegisterClusterNode API を利用してください

    • テンポラリーノードは停止時にクラスターから消去されます

    • テンポラリーノードを再起動した場合、クラスターには自動で参加しません。再度 RegisterClusterNode API を利用して登録してください

    • テンポラリーノードだけでクラスターを構築する事はできません

    • テンポラリーノードは PurgeClusterNode API でノードを消去することはできません

    • テンポラリーノードは InitCluster API で初期化することはできません

    • テンポラリーノードはクラスターの全てのノードが 2024.1.0 以降である必要があります

  • [UPDATE] ListClusterNodes API に temporary_node: <boolean> 項目を追加しました

詳細は テンポラリーノード機能 をご確認ください。

ライセンスで決められた最大同時接続数の合計を維持する機能

これは実験的機能です

クラスターのノードが離脱した際に、合計接続数を残りのノードで維持する機能を追加しました。

  • [ADD] クラスターでライセンスの同時接続数の合計を維持する機能を追加しました

    • この機能は cluster が true の場合にのみ有効です

    • この機能は 最大ノード数ライセンス のみ有効です

    • 同時接続数が 100 の 3 ノードのクラスターで動作させた場合に、 1 ノードが離脱した際、残りの 2 ノードが最大同時接続数が 150 に一時的に引き上げられ、合計での接続数を維持します その後、障害が発生していたノードが復旧した歳には、最大同時接続数は 100 に戻ります 100 を超えている接続は切断されたりはしません

詳細は ライセンスで決められた最大同時接続数の合計を維持する機能 をご確認ください。

クラスターリレー機能

これは実験的機能です

クラスター利用時に、複数のノードから同一チャネルに参加できる仕組みを追加しました。

  • [ADD] sora.conf にクラスター利用時に複数ノードから同一チャネルに接続できる機能を実現する cluster_relay の設定を追加しました

    • この機能は cluster が true の場合にのみ利用できます

    • デフォルトで true が設定されています

    • クラスターリレー機能は 最大ノード数ライセンス のみで利用できます

    • クラスターリレー機能は "multistream": false では利用できません

    • リレー機能はクラスターの全てのノードが 2024.1.0 以降である必要があります

    • 詳細は リレー機能 をご確認ください

  • [ADD] GetStatsReport API にクラスターリレー機能の統計情報を追加しました

    • この統計データは厳密なデータではないため、参考程度にご利用ください

    • ノードが削除された場合でも再起動するまでは統計情報は残り続けます

    • cluster_relay

      • [{"node_name": "sora-01@192.0.2.100", "total_sent_byte_size": 5000, "total_received_byte_size": 5000, ...]

    • node_name

      • 対象ノード名

    • total_sent_byte_size

      • 対象ノードへリレー機能で送信したバイト数の合計

    • total_received_byte_size

      • 対象ノードからリレー機能で受信したバイト数の合計

    • total_sent

      • 対象ノードからリレー機能で送信したパケット数の合計

    • total_received

      • 対象ノードからリレー機能で受信したパケット数の合計

  • [CHANGE] リレー機能利用時には認証が 2 回発生する場合があります

  • [CHANGE] リレー機能利用時には multistream と spotlight が既存セッションと異なる場合の挙動 の挙動が変わり、接続数が 0 の場合に multistream と spotlight の指定が既存セッションと異なる場合でもセッションが破棄されなくなります

    • この挙動は 2024 年 12 月リリースの Sora にてリレー機能を利用しない場合でも反映される予定です

詳細は リレー機能 をご確認ください。

クラスターリレー機能利用時のアフィニティ機能

これは実験的機能です

クラスターリレー機能利用時に一定の同時接続数まで特定のノードに同一セッションの接続を集約する機能を追加しました。

  • [ADD] sora.conf にリレー機能を利用する際に、アフィニティ機能(同一セッションへの接続を同一ノードに寄せる) かどうかを指定する default_cluster_affinity の設定を追加しました

    • デフォルトで true が設定されています

    • この機能は sora.conf の cluster が true の場合にのみ利用できます

    • この機能は sora.conf の cluster_relay が true の場合にのみ利用できます

    • true の場合は一定数の接続までは特定のノードに接続を集約します

      • 同時接続数がライセンス最大値の場合はリダイレクトが発生します

    • false を指定すると、可能な限りリダイレクトをせずにそのノードでリレーが行われます

      • 同時接続数がライセンス最大値の場合はリダイレクトが発生します

  • [ADD] sora.conf にアフィニティを行う 1 ノード、1 セッションあたりの最大同時接続数を指定する cluster_affinity_threshold を追加しました

    • デフォルトは 10 です

    • 1 ノード、1 セッションあたりの同時接続数が cluster_affinity_threshold 未満のノードがあれば、同じノードに新規接続が割り振られます

  • [ADD] 認証成功時の払い出しで cluster_affinity の払い出し を払い出すことでコネクション単位でのアフィニティ機能を利用するかどうかを指定できる機能を追加しました

音声ストリーミング

音声ストリーミング機能のエラー処理を充実させました。

  • [ADD] audio_streaming_url に接続ができない場合、再接続を試みる機能を追加しました

  • [ADD] audio_streaming_url への接続を諦める機能を追加しました

    • 接続を諦めた場合、再接続を試みるには一度クライアントを切断する必要があります

  • [ADD] audio_streaming_url に接続ができない場合、再接続を試みる回数を指定する audio_streaming_max_retries を追加しました

    • 最大リトライ回数まで再接続を試みても接続ができない場合は接続を諦めます

    • デフォルトは 0 です

    • 0 にした場合は常に再接続を試みます

    • 0..10 の間で指定できます

  • [ADD] audio_streaming_url に接続ができない場合、再接続を試みる間隔を指定する audio_streaming_retry_interval を追加しました

    • デフォルトは 5 s です

    • 0 にした場合は音声パケットが送られてきたタイミングで再接続を試みます

    • 0..60 s の間で指定できます

  • [ADD] audio_streaming_url からステータスコード 5xx が返ってきた場合、再接続を試みる機能を追加しました

  • [ADD] audio_streaming_url への接続を諦めた際、イベントウェブフック audio-streaming.failed を送信する機能を追加しました

    • 諦めるのはコネクション単位のため、イベントウェブフックを送信します

    • このウェブフックは ignore_audio_streaming_webhook の影響は受けません

  • [ADD] イベントウェブフック audio-streaming.failed を送信しない設定 ignore_audio_streaming_failed_webhook を追加しました

    • デフォルトは true です

    • true にした場合は audio-streaming.failed イベントウェブフックを送信しません

  • [ADD] audio_streaming_url から "type": "error" が含まれる JSON が送られてきた際、音声ストリーミングサーバーへの接続を諦める機能を追加しました

  • [ADD] audio_streaming_url への接続を諦めた際、セッションに参加している全てのコネクションにシグナリング通知 audio-streaming.failed を送信する機能を追加しました

  • [FIX] 音声ストリーミング audio-streaming.started のウェブフック処理中にエラーになった場合、セッションが破棄されてしまう問題を修正しました

統計ウェブフック機能

実験的機能です

統計エクスポーター に変わる、 統計ウェブフック機能 を追加しました。

  • [ADD] sora.conf に統計ウェブフックの送信先を指定する stats_webhook_url を追加しました

  • [ADD] sora.conf に統計ウェブフックログを出力するかどうかを指定する stats_webhook_log を追加しました

    • デフォルト false です

    • デフォルトではログを出力しません。ログを出力したい場合は true に設定してください

  • [ADD] sora.conf に統計ウェブフック type: connection.rtc を無視するかどうかを指定する ignore_connection_rtc_webhook を追加しました

    • デフォルト false です

  • [ADD] sora.conf に stats_webhook_worker_number を追加しました

  • [ADD] 統計ウェブフックにクライアントの RTC 統計情報を送信する type: connection.rtc を追加しました

    • これは統計エクスポーターの "type": "connection.user-agent" と同じデータをウェブフックとしてリクエストを送信します

    • 統計エクスポーターでは HTTP/2 を利用して送信していましたが、統計ウェブフックは HTTP/1.1 で送信します

  • [ADD] GetStatsReport API に統計ウェブフックの成功数の項目 total_successful_stats_webhook を追加しました

  • [ADD] GetStatsReport API に統計ウェブフックの失敗数の項目 total_failed_stats_webhook を追加しました

詳細は 統計ウェブフック機能 をご確認ください。

RTC 統計 (ユーザエージェント機能)

統計ウェブフック機能追加に伴い、ユーザーエージェント統計から RTC 統計へ名前を変更します。 ユーザエージェント機能は 2025 年 6 月リリース予定の Sora で廃止されます。

  • [ADD] sora.conf に RTC 統計機能をデフォルトを指定する default_rtc_stats を追加しました

    • デフォルトは true です

    • true の場合、 Sora はクライアントへ RTC 統計の送信を要求します

  • [ADD] 認証成功時の払い出しに rtc_stats の払い出し を追加しました

  • [ADD] ListRtcStats API を追加しました

  • [ADD] ListChannelRtcStats API を追加しました

  • [ADD] GetRtcStats API を追加しました

  • [ADD] 実験的機能として sora.conf に rtc_stats_log を追加しました

    • デフォルトで false です

    • rtc_stats 項目個別に rtc_stats.jsonl にログを出力します

  • [FIX] ユーザーエージェント統計情報の認証成功時払い出し指定が無視されていた問題を修正しました

  • [FIX] ユーザーエージェント統計情報の GetUserAgentStats の戻り値の stats を user_agent_stats に修正しました

セッションライフタイム機能

実験的機能です

セッションに対してライフタイム (破棄されるまでの時間) を設定する機能を追加しました。

  • [ADD] セッションのライフタイムをセッションウェブフック session.created の戻り値で session_lifetime を指定できるようになりました

    • 秒 で指定してください

    • 最大 2,592,000 秒 (30 日) まで指定できます

    • セッション生成後に変更することはできません

    • session_lifetime が未指定の場合は 無制限 です

    • session.destroyed の reason に lifetime_expired が入ります

    • connection.destroyed の reason に session_destroyed が入ります

    • セッションのライフタイムが終了すると、セッションが破棄され切断します

    • セッションのライフタイムが終了すると、セッションウェブフック session.destroyed が送信されます

コネクションライフタイム機能

実験的機能です

コネクションに対してライフタイム (破棄されるまでの時間) を設定する機能を追加しました。

  • [ADD] コネクションのライフタイムを認証ウェブフックの払い出しで connection_lifetime の払い出し を指定できるようになりました

    • 秒 で指定してください

    • 最大 2,592,000 秒 (30 日) まで指定できます

    • コネクション生成後に変更することはできません

    • connection_lifetime が未指定の場合は 無制限 です

    • connection.destroyed の reason に lifetime_expired が入ります

    • コネクションのライフタイムが終了すると、コネクションが破棄され切断します

    • コネクションのライフタイムが終了すると、コネクションウェブフック connection.destroyed が送信されます

    • コネクションのライフタイムよりセッションのライフタイムが優先されます

サイマルキャストマルチコーデック機能

実験的機能です

一つのサイマルキャストで複数のコーデックを利用する事ができる、サイマルキャストマルチコーデックを追加しました。

  • [ADD] 複数の映像コーデックを同時に配信するサイマルキャストマルチコーデック機能に対応しました

    • サイマルキャストマルチコーデックの配信に対応した SDK のみで利用できます

      • 2024 年 6 月 時点で以下の SDK が実験的に対応しています

      • Sora C SDK

      • Sora C++ SDK

    • ブラウザを利用した場合、サイマルキャストマルチコーデック機能を利用して配信することはできません、視聴側は利用できます

  • [ADD] sora.conf にてサイマルキャストコーデック機能を有効にするするかどうかを指定する simulcast_multicodec を追加しました

    • デフォルトは false です

    • simulcast_multicodec を true に設定するとサイマルキャストマルチコーデック機能が利用可能になります

  • [ADD] シグナリング接続時に "simulcast_multicodec" 項目を追加しました

    • "simulcast_multicodec": true を指定する際には "simulcast": true を指定する必要があります

  • [ADD] 認証ウェブフックに "simulcast_multicodec" 項目を追加しました

    • simulcast が true かつ simulcast_multicodec が true の時のみ含まれます

  • [ADD] 認証成功時の払い出しで simulcast_multicodec を払い出した場合、サイマルキャストマルチコーデックを利用できるようになりました

    • sora.conf にて simulcast_multicodec が true に指定されている必要があります

    • "simulcast": true が指定されている必要があります

  • [ADD] 認証成功時の払い出しで simulcast_codecs を指定できるようになりました

  • [ADD] sora.conf にてサイマルキャストのデフォルトコーデックを設定する simulcast_codecs_file を指定できるようになりました

  • [ADD] イベントウェブフック connection.{created, updated, destroyed} に simulcast_multicodec 項目を追加しました

    • simulcast が true かつ simulcast_multicodec が true の時のみ含まれます

  • [ADD] コネクションログに simulcast_multicodec 項目を追加しました

    • 項目は必ず含まれます

  • [ADD] "type": "offer" 時に simulcast_multicodec 項目を追加しました

    • 項目は必ず含まれます

詳細は サイマルキャストマルチコーデック をご確認ください。

H.264/H.265 B-frame 対応

実験的機能です

実験的機能として H.264 と H.265 の B-frame 向けの RTP ヘッダー拡張 に対応しました。

B-frame 向けの RTP ヘッダー拡張に対応している場合、 H.264/H.265 で B-frame を利用した配信/視聴が行えるようになります。

B フレームの録画には対応していません。

  • [ADD] H.264 と H.264 で B-frame を利用する RTP ヘッダー拡張に対応しました

  • [ADD] sora.conf に H.264 で B-frame を利用するかどうかを指定する h264_b_frame を追加しました

    • デフォルトは false です

  • [ADD] sora.conf に H.265 で B-frame を利用するかどうかを指定する h265_b_frame を追加しました

    • デフォルトは false です

  • [ADD] シグナリング type: connect 時に H.264 で B-frame を利用するかどうかを指定する h264_params: {"b_frame": true} を追加しました

    • デフォルトは false です

    • sora.conf にて h264_b_frame が true に指定されている必要があります

    • sora.conf にて signaling_h264_params が true に指定されている必要があります

  • [ADD] シグナリング type: connect 時に H.265 で B-frame を利用するかどうかを指定する h265_params: {"b_frame": true} を追加しました

    • デフォルトは false です

    • sora.conf にて h265_b_frame が true に指定されている必要があります

    • sora.conf にて signaling_h265_params が true に指定されている必要があります

  • [ADD] ウェブフックの video_h264_params に b_frame を追加しました

    • sora.conf の h264_b_frame が true に指定されていない場合は b_frame は含まれません

  • [ADD] ウェブフックの video_h265_params に b_frame を追加しました

    • sora.conf の h264_b_frame が true に指定されていない場合は b_frame は含まれません

  • [ADD] 認証成功時の払い出しで video_h264_params に b_frame を追加しました

    • デフォルトは false です

    • 接続時や払い出し時に未指定の場合はデフォルトの false が利用されます

  • [ADD] 認証成功時の払い出しで video_h265_params に b_frame を追加しました

    • デフォルトは false です

    • 接続時や払い出し時に未指定の場合はデフォルトの false が利用されます

プレイアウト遅延機能

実験的機能です

プレイアウト遅延機能を追加しました。

プレイアウト遅延機能を利用することでフレームをどれくらい速くレンダリングする必要があるかを配信毎に指定できます。

  • [CHANGE] sora.conf の RTP ヘッダー拡張 playout-delay を利用するかどうかを指定する rtp_hdrext_playout_delay のデフォルトを true に変更しました

  • [ADD] sora.conf にプレイアウト遅延の最小値のデフォルトを指定する default_playout_delay_min_delay を追加しました

  • [ADD] sora.conf にプレイアウト遅延の最大値のデフォルトを指定する default_playout_delay_max_delay を追加しました

  • [ADD] 認証成功時の払い出しでプレイアウト遅延の最小値を指定する playout_delay_min_delay を追加しました

    • playout_delay_max_delay も一緒に指定する必要があります

  • [ADD] 認証成功時の払い出しでプレイアウト遅延の最大値を指定する playout_delay_max_delay を追加しました

    • playout_delay_min_delay も一緒に指定する必要があります

詳細は プレイアウト遅延機能 をご確認ください。

メディア配信ワーカー

実験的機能です

配信ワーカー機能をメディア配信ワーカー機能に変更しました。

  • [UPDATE] スポットライト機能をメディア配信ワーカーで利用できるようになりました

  • [CHANGE] sora.conf の rtp_publish_worker_number を media_publish_worker_number に変更しました

WebSocket シグナリング時の HTTP ヘッダーを認証ウェブフックにコピーする機能

実験的機能です

  • [ADD] sora.conf に WebSocket シグナリング接続時の HTTP ヘッダーを認証ウェブフックのヘッダーにコピーする copy_websocket_signaling_header_names を追加しました

    • デフォルトは未指定です

    • 大文字小文字は区別されません

    • copy_websocket_signaling_header_names = X-Forwarded-For, X-Real-IP, Tracestate のように指定してください

  • [ADD] 認証ウェブフックログ auth_webhook.jsonl に copy_headers 項目を追加しました

    • 認証ウェブフックにコピーされたヘッダーを出力します

2023.2.7

バグフィックスアップデート

リリース:

2024-04-24

  • [FIX] レガシー録画機能または録画機能(セッション単位)利用時の録画停止処理中に、新規コネクションが参加した際に、そのコネクションが切断されるまで、録画停止処理が完了しない問題を修正しました

  • [FIX] レガシー録画機能にて録画停止処理中に録画の開始および StopRecording API 実行した際 RECORDING-INTERNAL-ERROR が返されていたのを STOPPING-RECORDING を返すように修正しました

  • [FIX] クラスター有効時に、ごく稀にノード起動に失敗することがある問題を修正しました

2023.2.5

ホットフィックスアップデート

リリース:

2024-03-08

  • [FIX] 録画機能で録画中、出力済の分割録画ファイルのファイルディスクリプタを掴み続ける問題を修正しました

2023.2.4

ホットフィックスアップデート

重要

このリリースはクラスターをご利用いただいているお客様にのみ提供しております。

リリース:

2024-02-27

  • [FIX] クラスター利用時にでリーダーノードがダウンした場合に、他のノードのセッションも終了してしまう問題を修正しました

2023.2.3

バグフィックスアップデート

リリース:

2024-02-07

  • [FIX] "multistream": false を指定して接続した場合に、配信/視聴ができない問題を修正しました

  • [FIX] セッションウェブフックが一部の HTTP サーバーで正常に処理できず、エラーになる問題を修正しました

  • [FIX] データチャネルの終了時にクライアント側で警告が出力される問題を修正しました

2023.2.2

バグフィックスアップデート

リリース:

2024-01-04

変更履歴

  • [FIX] sora.conf の event_webhook_url が未指定の状態で録画を開始した場合、セッションが破棄されない問題を修正しました

  • [FIX] ウェブフックで mTLS 利用時に、特定の条件下でクライアント証明書を送らなくなる問題を修正しました

    • ウェブフックで HTTPS を利用する場合は TLS 1.2 のみを利用するように変更しました

  • [FIX] ウェブフックで mTLS 利用時に、 CA 証明書が指定されていない場合に OS 組み込みの証明書を利用できない問題を修正しました

  • [FIX] 統計エクスポーターで mTLS 利用時に、 CA 証明書が指定されていない場合に OS 組み込みの証明書を利用できない問題を修正しました

  • [FIX] 音声ストリーミングで mTLS 利用時に、 CA 証明書が指定されていない場合に OS 組み込みの証明書を利用できない問題を修正しました

  • [FIX] API ログの書き込みに失敗した場合でも、 API の処理を中断しないように修正しました

  • [FIX] PurgeClusterNode API の API ログ操作名が LeaveCluster となっていたのを PurgeClusterNode に修正しました

  • [FIX] クラスターに参加済のノードが、別クラスターに対する JoinCluster API を受け入れてしまう問題を修正しました

  • [FIX] 録画機能で大幅にパケットの到着が遅れている場合、分割録画に失敗することがある問題を修正しました

2023.2.0

メジャーアップデート

リリース:

2023-12-20

ハイライト

  • セッション単位で録画する新しい録画機能を追加しました

    • 今までの録画機能は レガシー録画機能 と名前を変更しました

    • レガシー録画機能と新しい録画機能は別チャネルであれば同時に利用することができます

    • レガシー録画機能は 2025 年 12 月リリース予定の Sora にて廃止されます

    • 詳細は 録画機能 (セッション単位) をご確認ください

  • 接続単位で録画をブロックできる機能を追加しました

    • 今まではチャネルに参加している全ての接続が録画されていましたが、新しい録画機能では接続単位で録画をブロックできるようになりました

    • 新しい録画機能でのみ利用できます

  • より大規模な配信を可能にする配信ワーカー機能を追加しました

    • 今まで音声や映像をクライアントに配信するワーカーは 1 つでしたが、配信するワーカーを複数にすることで、より多くのユーザーに配信することができるようになりました

  • データチャネルの負荷を下げるために SCTP パケットのチェックサム計算を省略する機能を追加しました

    • 利用するにはクライアント側もチェックサム計算を省略する機能に対応している必要があります

  • ウェブフックで IPv6 アドレスが利用できるようになりました

  • ウェブフックなどでルート CA 証明書に OS 組み込みのものを利用するようにしました

正式版

廃止情報

破壊的変更

変更履歴

  • [CHANGE] ウェブフックなどで利用するルート CA 証明書に OS 組み込みのものを利用するように変更しました

  • [UPDATE] DataChannel を利用したメッセージングのみで接続する場合に role が sendrecv 以外でも接続ができるようになりました

  • [ADD] シグナリング "type": "offer" に channel_id と session_id を追加しました

  • [ADD] connection.jsonl の ice_connection_state に ICE コネクションステート checking と disconnected だった時間を追加しました

  • [ADD] Sora が利用している Erlang VM の設定を追加できる環境変数 SORA_ADDITIONAL_ERL_ARGS を追加しました

  • [ADD] 認証成功時の払い出しに検証用の RTP パケットロスシミュレーターの設定値、 rtp_packet_loss_simulator_incoming と rtp_packet_loss_simulator_outgoing が指定できるようになりました

  • [ADD] sora.jsonl と internal.jsonl に UUIDv4 を Base32 でエンコードしたユニークな ID を含めるようにしました

    • "id": "base32(uuidv4)"

  • [FIX] データチャネルで利用する SCTP のストリーム ID 採番を RFC 8832 に準拠させました

  • [FIX] 録画機能で H.264 利用時に送られてくる分割ペイロードが壊れている場合は処理をスキップするように修正しました

OBS WHIP

これは実験的機能です

  • [ADD] OBS WHIP で User-Agent として送られてくる情報を sora_client としてウェブフックで送信するようにしました

    "sora_client": {
  "raw": "Mozilla/5.0 (OBS-Studio/30.0.0; Mac OS X; ja-JP)",
  "type": "OBS-Studio",
  "version": "30.0.0",
  "environment": "environment":"Mozilla/5.0 (OBS-Studio/30.0.0; Mac OS X; ja-JP)"
},

  • [ADD] OBS WHIP で AV1 が動作するようにしました

    • OBS WHIP で AV1 を配信する仕組みは 2024 年 6 月 現在、 OBS には組み込まれていません

  • [FIX] WHIP 利用時に認証ウェブフックの項目に ignore_disconnect_websocket が含まれない問題を修正しました

    • 常に false が含まれます

転送フィルター機能

これは実験的機能です

転送フィルターに version や metadata が指定できるようになりました。

version を指定することで、転送フィルターの更新 API が並列で実行されても期待した値に変更することができるようになりました。

  • [ADD] 転送フィルターに version を設定できるようになりました

  • [ADD] 転送フィルターに metadata を設定できるようになりました

  • [ADD] 転送フィルター API CreateChannelForwardingFilter と CreateConnectionForwardingFilter に version を指定できるようになりました

  • [ADD] 転送フィルター API CreateChannelForwardingFilter と UpdateChannelForwardingFilter に metadata を指定できるようになりました

  • [ADD] 転送フィルター API CreateConnectionForwardingFilter と UpdateConnectionForwardingFilter に metadata を指定できるようになりました

  • [ADD] 転送フィルター API UpdateChannelForwardingFilter と UpdateConnectionForwardingFilter API に指定した expected_version が既存の version と一致していない場合は更新エラーになるようになりました

    • expected_version が既存のバージョンと一致した場合のみ desired_version で指定した値で version の値を更新します

  • [ADD] セッションウェブフックの戻り値に version と metadata を指定できるようになりました

  • [ADD] 認証成功の払い出し時に version と metadata を指定できるようになりました

  • [ADD] シグナリング時に version と metadata を指定できるようになりました

セッション API

  • [ADD] 指定したセッションを取得する GetSession API を追加しました

    • channel_id を指定してセッションを取得します

  • [ADD] セッション一覧を取得する ListSessions API を追加しました

    • 全てのセッション一覧を取得します

録画機能

  • [ADD] sora.conf に単一録画ファイルと分割録画ファイルの両方を出力する機能を有効にするかどうかを指定する recording_dual_output を追加しました

    • デフォルトは true です

    • false に指定した場合は 単一録画ファイルと分割録画ファイルの両方が出力 のパターンを指定できなくなります

  • [ADD] sora.conf に録画期限の最大値を指定する recording_max_expire_time を追加しました

    • デフォルトは 86400 s です

    • 設定できる最大値は 86400 s です

    • レガシー録画機能では一括録画と一括＆分割録画で expire_time が指定できます

    • 新しい録画機能(セッション単位)では一括録画、分割録画、一括＆分割録画で expire_time が指定できます

  • [ADD] sora.conf に分割録画時の分割時間の最大値を指定する recording_max_split_duration を追加しました

    • デフォルトは 86400 s です

    • 設定できる最大値は 86400 s です

  • [ADD] sora.conf に一括録画を含む場合に録画期限の設定を要求する recording_expire_time_required を追加しました

    • この設定は一括録画時に録画ファイルが大きくなりすぎるのを防ぐための設定です

    • デフォルトは false です

    • この設定を true にした場合、一括録画を含む場合に expire_time が必須になります

    • この設定を true にした場合、レガシー録画機能では expire_time に 0 以外の値を指定する必要があります

    • この設定を true にした場合、新しい録画機能(セッション単位)では expire_time の値を指定する必要があります

    • この設定を true にした場合でも分割録画のみの場合は expire_time は必須になりません

新しい録画機能 (セッション単位)

今までの録画機能は レガシー録画機能 と名前を変更しました。

レガシー録画機能と新しい録画機能は別チャネルであれば同時に利用することができます。

  • [ADD] sora.conf にレガシー録画を有効にするかどうか指定する legacy_recording を追加しました

    • デフォルトは true です

    • false にした場合、レガシー録画機能が利用できなくなります

    • この設定は移行用の設定で、 2025 年 12 月リリース予定の Sora にて廃止されます。

  • [ADD] セッションウェブフック session.created 時に "recording": true を指定することで録画を開始します

  • [ADD] セッションウェブフック session.created 時に "recording_expire_time" を指定することができるようになりました

    • セッション破棄時に録画は自動で終了します

    • セッション破棄前に期限が来た場合はそこで録画は終了します

  • [ADD] セッションウェブフック session.created 時に "recording_split_duration" を指定することができるようになりました

  • [ADD] セッションウェブフック session.created 時に "recording_split_only" を指定することができるようになりました

  • [ADD] セッションウェブフック session.created 時に "recording_metadata" を指定することができるようになりました

  • [ADD] セッションウェブフック recording.started を追加しました

  • [ADD] セッションウェブフック recording.report を追加しました

  • [ADD] 新しい録画用の StartRecording API を追加しました

    • セッション破棄時に自動で録画は終了します

    • expire_time がオプションになっています

    • expire_time デフォルトは未定義です

  • [ADD] 新しい録画用の StopRecording API を追加しました

詳細については 録画機能 (セッション単位) をご確認ください。

移行については レガシー録画機能から新しい録画機能 (セッション単位) への移行 をご確認ください。

新しい録画機能 (セッション単位) における接続単位の録画ブロック機能

これは実験的機能です

この機能は新しい録画機能 (セッション単位) でのみ利用できます。レガシー録画機能では利用できません

  • [ADD] 認証成功時に "recording_block": true を払い出すことで、その接続の録画をブロックし、録画ファイルの出力を拒否できるようになりました

    • これは録画が有効になっていない場合に払い出しても問題ありません

    • この値を途中で変更することはできません

  • [ADD] イベントウェブフック connection.{created, updated, destroyed} の data に "recording_block" の項目を追加しました

    • 認証成功時に "recording_block": true を払い出していれば true に、それ以外は false になります

シグナリング通知メタデータ

sora.conf で signaling_notify_metadata を false にした際の挙動を変更しました。

外部への HTTP リクエストに HTTP ヘッダーを追加

ウェブフックや統計エクスポーター、音声ストリーミングを利用した際の外部への HTTP リクエストに、 x-sora- prefix とは別に sora- prefix の HTTP ヘッダーを追加しました。

これは RFC 6648 による x- prefix の非推奨化に準拠するためです。

今後 x-sora- prefix は非推奨になります。 現時点で具体的な時期は決まっていませんが、将来的に 1 年以上の移行期間を設けて廃止する予定です。

  • [ADD] セッションウェブフックに sora-session-webhook-type ヘッダーを追加しました

    • すでにある x-sora-session-webhook-type ヘッダーは将来的に廃止予定です

  • [ADD] イベントウェブフックに sora-event-webhook-type ヘッダーを追加しました

    • すでにある x-sora-event-webhook-type ヘッダーは将来的に廃止予定です

  • [ADD] 統計エクスポーターに sora-stats-exporter-type ヘッダーを追加しました

    • すでにある x-sora-stats-exporter-type ヘッダーは将来的に廃止予定です

  • [ADD] セッションウェブフックに sora-session-id ヘッダーを追加しました

  • [ADD] イベントウェブフックに sora-connection-id ヘッダーを追加しました

  • [ADD] イベントウェブフックに sora-session-id ヘッダーを追加しました

ウェブフック

  • [CHANGE] セッションウェブフック audio-streaming.started に max_connections と total_connections が含まれなくなりました

  • [CHANGE] セッションウェブフック audio-streaming.stopped に max_connections と total_connections が含まれなくなりました

  • [CHANGE] クラスター機能利用時のセッションウェブフック session.destroyed に connections が含まれなくなりました

  • [ADD] sora.conf にウェブフックで IPv6 利用する webhook_ipv6 を追加しました

    • デフォルトは false です

    • この設定を有効にしない限りウェブフックで IPv6 は利用できません

  • [ADD] sora.conf にイベントウェブフック connection.updated の送信間隔を変更する connection_updated_webhook_interval を追加しました

    • デフォルトは 1 min です

    • 最小は 1 min です

    • 最大は 10 min です

    • 時間単位は min のみが指定できます

  • [ADD] sora.conf に 録画イベントウェブフック split-archive.available を送信しないようにする ignore_split_archive_available_webhook を追加しました

    • デフォルトは false です

  • [ADD] 接続イベントウェブフック connection.{created, updated, destroyed} に ICE コネクションステートが checking と disconnected だった時間の項目を追加しました

    • data.ice_connection_state.total_checking_duration_ms に checking だった合計時間(ミリ秒)が入ります

    • data.ice_connection_state.total_disconnected_duration_ms に disconnected だった合計時間(ミリ秒)が入ります

  • [ADD] 認証ウェブフックに spotlight_focus_rid と spotlight_unfocus_rid を追加しました

    • spotlight が true の時だけ追加されます

  • [ADD] 接続イベントウェブフック connection.{created, updated, destroyed} に ICE コネクションステートの checking と disconnected の時間を通知する項目を追加しました

    • ice_connection_state 項目を追加しました

    • ice_connection_state に total_checking_duration_ms に checking だった合計時間(ミリ秒)が入ります

    • ice_connection_state に total_disconnected_duration_ms に disconnected だった合計時間(ミリ秒)が入ります

    "data": {
  "ice_connection_state": {
    "total_checking_duration_ms": 0,
    "total-disconnected_duration_ms": 0
  }
}

  • [ADD] セッションウェブフック session.updated を追加しました

    • クラスターが有効時には connections は含まれません

    • 録画機能 (セッション単位) 有効時に recording 項目が含まれます

  • [ADD] セッションウェブフック session.destroyed に reason が含まれるようになりました

    • reason には以下が含まれます

      • normal

        • 正常終了

      • terminated_api

      • abort

        • 異常終了

  • [ADD] sora.conf にセッションウェブフック session.updated を送信しないようにする ignore_session_updated_webhook を追加しました

    • デフォルトは false です

  • [ADD] sora.conf にセッションウェブフック session.updated の送信間隔を変更する session_updated_webhook_interval を追加しました

    • デフォルトは 1 min です

    • 最小は 1 min です

    • 最大は 10 min です

    • 時間単位は min のみが指定できます

  • [FIX] 認証ウェブフックで simulcast_rid は spotlight が true の場合は追加しないようにしました

    • simulcast が true かつ spotlight が false の時だけ追加されます

データチャネル

  • [ADD] データチャネルの SCTP のパケットのチェックサム計算を省略する仕組みを追加しました

    • データチャネルは DTLS レイヤーでデータ保護が行われているため、 SCTP のチェックサムは追加の整合性を得ることができないため省略することができます

    • クライアント側もチェックサム計算を省略する機能に対応している必要があります

    • データチャネル利用時の CPU リソースがクライアント、SFU ともに節約されます

    • https://datatracker.ietf.org/doc/html/draft-ietf-tsvwg-sctp-zero-checksum

  • [ADD] SCTP のチェックサムを省略した回数の統計情報を追加しました

    • total_received_sctp_zero_checksum

    • total_sent_sctp_zero_checksum

クラスター機能

これは実験的機能です

Sora 2023.1.x で構築されているクラスターは Sora 2023.2.x へローリングアップデートで移行できます。

警告

2023.2.x から 2023.1.x へのローリングアップデートは行えません。クラスターを再構築する必要があります。

  • [CHANGE] クラスター関連のログは cluster.jsonl に出力するよう変更しました

  • [ADD] 最新のバージョンと 1 世代前のバージョンの Sora ノードが混在する状態でのクラスター運用ができるようになりました

    • 全てのクラスターに参加するノードが同じバージョンになるまでは 1 世代前のバージョンと混在できる仕組みを追加しました

    • Sora 2023.2.x と 2023.1.x で、特定のノードのアップデートが難しい場合でも、先に他のノードをアップデートすることができるようになります

    • クラスターに 1 世代前のバージョンのノードが混在している場合、新しい接続は全て古いバージョンのクラスターの仕組みを利用します

    • 全てのノードが新しいバージョンのクラスターになったタイミングで、新しいバージョンのクラスターの仕組みを利用しはじめます

詳細については クラスター機能 をご確認ください。

注釈

InitCluster API でクラスターを初期化する際には、新旧バージョンは混在させないでください。また Sora 2023.2.x で構成されたクラスターに JoinCluster API で Sora 2023.1.x のノードを参加させることはできません。

メディア配信ワーカー機能

これは実験的機能です

メディア配信ワーカー機能は音声や映像を配信するワーカーを複数用意することで、 1 チャネルで高ビットレートの映像をより多くのクライアントに配信することができるようになります。

  • [ADD] sora.conf に音声や映像の 1 配信に利用するメディア配信ワーカー数を指定する media_publish_worker_number を追加しました

    • デフォルトのメディア配信ワーカー数は 1 です

    • 同時に 100 クライアント以上へ配信する場合はまず 10 を設定することを推奨します

    • ワーカー数が 10 であれば 1 チャネル 1000 クライアント以上の配信ができるようになります

    • 最小は 1 で、最大は 500 です

ワーカー数の設定を 10 以上で検討している場合はまずサポートにご相談ください。

詳細については メディア配信ワーカー機能 をご確認ください。

シグナリング通知メタデータ拡張機能

これは実験的機能です

  • [ADD] 認証成功時に、シグナリング通知メタデータ拡張の初期値を払い出す signaling_notify_metadata_ext を追加しました。

統計エクスポーター

これは実験的機能です

  • [ADD] sora.conf に統計エクスポーターをデフォルトで有効にするかどうかの default_stats_exporter を追加しました

    • デフォルトは true です

  • [ADD] 認証成功時の払い出しで接続単位で統計エクスポーターを有効にするかどうかを指定する stats_exporter を追加しました

    • false を設定した場合は stats_collector_url が指定されていたとしても統計情報がエクスポートされません

H.265

これは実験的機能です

2024 年 6 月 現在、WebRTC H.265 のプロファイルに対応している WebRTC ライブラリはありません。 現在 仕様策定中 です。

  • [ADD] H.265 サイマルキャストに対応しました

  • [ADD] sora.conf に H.265 のデフォルトレベル ID を指定する default_h265_param_level_id を追加しました

    • デフォルトは 93 (3.1) です

  • [ADD] 認証払い出し時に H.265 のデフォルトレベル ID を指定する video_h265_params を追加しました

    • "video_h265_params": {"level_id": 93} のように指定できます

    • level_id の値は 0 から 255 の間である必要があります

  • [ADD] シグナリング時に H.265 のデフォルトレベル ID を指定する h265_params を追加しました

    • "video": {"codec_type": "H265", "h265_params": {"level_id": 93}} のように指定できます

    • level_id の値は 0 から 255 の間である必要があります

  • [ADD] sora.conf に、シグナリング時に H.265 のパラメータ指定を許可するかどうか設定する signaling_h265_params を追加しました

    • デフォルトは false です

© Copyright 2024, Shiguredo Inc Created using Sphinx 7.4.7