レガシーストリーム(非マルチストリーム)機能からマルチストリーム機能への移行

重要

レガシーストリーム機能は 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 つでしたが、マルチストリームでは複数配信することができます。

© Copyright 2024, Shiguredo Inc Created using Sphinx 7.4.7