レガシーストリーム(非マルチストリーム)機能からマルチストリーム機能への移行¶
重要
レガシーストリーム機能は 2025 年 6 月リリースの Sora にて廃止します。
シグナリング接続時に "multistream": false
を指定した機能をレガシーストリーム機能としました。
なぜレガシーストリームを廃止するのか¶
レガシーストリーム機能は 10 年以上前の WebRTC の初期の仕様に基づいて開発されたため、 現在では時代遅れとなっています。
マルチストリーム機能は WebRTC の最新仕様に合わせて開発され、 より柔軟な配信や視聴ができます。
レガシーストリームでは実現困難な機能が増え、維持コストも高くなってきています。 また、レガシーストリームに似ている仕組みである WHIP/WHEP への対応を行いました。
レガシーストリームの役割は終了したと考え、 2025 年 6 月リリース予定の Sora にて廃止します。
Sora 2024.1.0 からレガシーストリームがデフォルトで無効にし非推奨へ¶
2024 年 6 月リリースの Sora から、レガシーストリーム機能はデフォルトで無効になり、非推奨となります。
そのため multistream: false
で接続した場合、シグナリングエラーになります。
もし、レガシーストリーム機能を引き続き利用したい場合は、
legacy_stream
オプションを true
に設定してください。
2025 年 6 月リリース予定の Sora でレガシーストリームが廃止に¶
2025 年 6 月リリース予定の Sora にて、レガシーストリーム機能を廃止します。
レガシーストリーム機能ではできて、マルチストリーム機能ではできないこと¶
視聴側の SDP 再交換を発生させずに、同一メディアストリームでストリームを受信できる¶
マルチストリームでは配信者が切り替わるたびに SDP 再交換が必須となります。 このため、挙動が大きく異なりますので注意してください。
移行時の注意点¶
不明点などはサポートまでお問い合わせください。
参加/離脱の挙動¶
これまで視聴側は SDP を一度交換するだけでしたが、 マルチストリーム機能では配信者が切り替わるたびに SDP 交換が必要となります。
マルチストリームでは新しく配信者が参加したタイミングでストリームやトラックを追加する処理が必要になります。 同じように配信者が離脱したタイミングでストリームやトラックを削除する処理が必要になります。
複数配信のサポート¶
レガシーストリームでは配信者は常に 1 つでしたが、マルチストリームでは複数配信することができます。