2024.2.x から 2025.1.x への移行

概要

2024.2.x から 2025.1.x への移行について変更点や注意点をまとめています。

もし不明点がある場合はサポートまでお問い合わせください。

レガシーストリームを廃止しました

シグナリング接続時に "multistream": false を指定して接続した場合バリデーションエラーになります。

2025 年 12 月リリース予定の Sora にてウェブフックやログの multistream 項目を非推奨とします。

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

multistream 項目の廃止

ウェブフック、ログ、API から multistream 項目を廃止しました。

session.vanished ウェブフックを廃止しました

Sora Exporter を利用する事で、より柔軟なセッションの監視ができることから、 session.vanished ウェブフックを廃止しました。

2025 年 6 月リリースの Sora にて廃止しました。

移行に際する不明点などはサポートまでお問い合わせください。

WHIP/WHEP 時のリソース URL をセッション URL に変更しました

WHIP の RFC 9725 化に伴い WHIP/WHEP 時のリソース URL をセッション URL に変更しました。

/whip-resource/:channel_id/:secret//whip-session/:channel_id/:secret/ に変更しました。

/whip-resource/:channel_id/:secret/ は 2025 年 12 月リリース予定の Sora にて廃止します。

NGINX の設定変更

NGINX を利用している場合は 2025.1.0 デプロイ時に location の設定を変更してください。

location ~ ^/(whip|whip-session|whep|whep-session)/ {
   ...
}

クラスター利用時のローリングアップデート

クラスター機能を利用している場合、 ローリングアップデートを行う前に whip-sessionwhep-session を許可するようにしてください。

location ~ ^/(whip|whip-resource|whip-session|whep|whep-resource|whep-session)/ {
   ...
}

ローリングアップデートが完了した後、 whip-resourcewhep-resource を削除してください。

location ~ ^/(whip|whip-session|whep|whep-session)/ {
   ...
}

クラスターリレーのツリー化

クラスターリレー機能を利用した際に、ノード数が増えるとリレー数が増えてノード負荷が高くなる問題を解決するために、リレーをツリー化しました。

リレーをツリー化することで 1 ノード辺りのリレー数を削減し、ノード負荷を分散することができるようになりました。

group_id の追加

セッションをグループ化する group_id を追加しました。

session.created ウェブフックの戻り値に group_id 項目でセッションのグループ ID を含める事ができます。

主にマルチテナントで Sora を利用している際に、現在のセッションをグループ化を目的としている機能です。

セッション単位での最大同時接続数を制限する max_connections の追加

session.created の払い出しで、セッション単位での最大同時接続数を制限する max_connections を追加しました。

トライアルでは trial_max_connections という項目でしたが、正式版に伴い max_connections に変更しました。 trial_max_connections は 2025 年 12 月リリース予定の Sora にて廃止します。

詳細は max_connections を確認してください。

  • trial_max_connections は 2025 年 12 月リリース予定の Sora にて廃止します。

  • trial_max_connectionsmax_connections を同時に指定した場合は max_connections が優先されます

  • trial_max_connections 廃止後は無視します

クラスターのローリングアップデートについて

2024.2.x から 2025.1.x へのローリングアップデートができます。

1 台 1 台ローリングアップデートを行ってください。

2024.1.x から 2025.1.x へのローリングアップデートはできません、 かならず 2024.2.x からのアップデートを行う場合、 2024.2.x を経由してから 2025.1.x へアップデートを行ってください。

legacy_signaling_error の廃止

2024.1.x までのシグナリングエラー時のログ出力先やウェブフック connection.failed の通知タイミングを維持する legacy_signaling_error を廃止しました。

今後は以下の挙動になります。

  • シグナリング時のエラーが sora.jsonl に出力しません

  • シグナリング時のエラーが signaling_error.jsonl に出力します

  • 認証失敗時のエラーが sora.jsonl に出力しません

  • 認証失敗時のエラーが signaling_error.jsonl に出力します

  • イベントウェブフック connection.failed が認証失敗時には通知しません

  • イベントウェブフック connection.failed が認証成功後に接続に失敗した時のみ通知します

認証失敗時のエラーログの出力

認証失敗時のログを sora.jsonl から signaling_error.jsonl に出力します。

認証時失敗時のエラーはシグナリングエラーと同等として扱います。 sora.jsonlERROR で出力されるシグナリング失敗のエラーメッセージは connection.created 以降に変更します。

イベントウェブフック connection.failed の挙動

connection.failed はシグナリング時にエラーが発生した場合通知する仕組みでしたが、 今後は認証が成功した後に接続が失敗した場合のみ通知されます。

これにより、認証が失敗した場合には connection.failed ウェブフックは通知されません。

© Copyright 2025, Shiguredo Inc Created using Sphinx 8.2.3