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-session
と whep-session
を許可するようにしてください。
location ~ ^/(whip|whip-resource|whip-session|whep|whep-resource|whep-session)/ {
...
}
ローリングアップデートが完了した後、 whip-resource
と whep-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_connections
とmax_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.jsonl
に ERROR
で出力されるシグナリング失敗のエラーメッセージは connection.created 以降に変更します。
イベントウェブフック connection.failed の挙動¶
connection.failed はシグナリング時にエラーが発生した場合通知する仕組みでしたが、 今後は認証が成功した後に接続が失敗した場合のみ通知されます。
これにより、認証が失敗した場合には connection.failed ウェブフックは通知されません。