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

概要

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

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

WHIP/WHEP 時のリソース URL 廃止しました

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

  • /whip-resource/:channel_id/:secret/ を廃止しました

  • /whep-resource/:channel_id/:secret/ を廃止しました

  • 2025 年 12 月リリースの Sora にて /whip-resource/:channel_id/:secret/ は廃止しました

  • 2025 年 12 月リリースの Sora にて /whep-resource/:channel_id/:secret/ は廃止しました

  • /whip-session/:channel_id/:secret/ を利用してください

  • /whep-session/:channel_id/:secret/ を利用してください

NGINX の設定変更

NGINX を利用している場合は Sora 2025.2.0 デプロイ時に location の設定を resource から session に変更してください。

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

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

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

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

ICE コネクションステート機能のタイムアウト値の古い設定を廃止しました

ICE コネクションステート機能のタイムアウトの値を認証成功時に払い出せる仕組みを追加したため、 sora.confice_connection_state_disconnected_timeoutice_connection_state_failed_timeout を廃止しました。

default_ice_connection_state_disconnected_timeoutdefault_ice_connection_state_failed_timeout を利用してください。

組み込み TURN 機能無効の設定を廃止しました

組み込み TURN 機能は 2016 年 6 月にリリースされ、長年安定して動作してきたため、 組み込み TURN 機能を無効にする設定を非推奨にし、無効にする設定を 2025 年 12 月リリース予定の Sora にて廃止します。

  • 2025 年 6 月リリースの Sora にて組み込み TURN 機能を無効にする turnfalse にする設定を非推奨にしました

  • 2025 年 12 月リリース予定の Sora にて組み込み TURN 機能の設定 turn を廃止しました

    • 組み込み TURN 機能を無効にすることができなくなります

WHIP/WHEP の TURN 機能を無効にする設定を廃止しました

WHIP/WHEP の TURN 機能をデフォルトで有効にしたため、無効にする設定を廃止しました。

  • 2025 年 6 月リリースの Sora にて WHIP/WHEP の TURN を無効にする whip_turnfalse にする設定を非推奨にしました

  • 2025 年 12 月リリース予定の Sora にて WHIP/WHEP の TURN 機能の設定を廃止しました

    • WHIP/WHEP の TURN を無効にすることができなくなります

注釈

今後、TURN の仕組みを実装していないクライアント向けに、シグナリングの query-string に turn=false を追加することで、TURN を無効にすることができるようにすることを検討しています。

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

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

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

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

© Copyright 2025, Shiguredo Inc Created using Sphinx 8.2.3