マルチストリーム機能¶

概要¶

重要

Sora ではデフォルトでマルチストリームを利用します。

マルチストリーム機能とは、1 つのピア接続で複数のストリームを管理する機能です。詳しくは Sora ドキュメントを参照してください。

マルチストリーム機能で接続する¶

Sora はデフォルトでマルチストリームを利用するので、特に設定は必要ありません。

接続例:

let config = Configuration(url: url,
                           channelId: channelId,
                           role: .sendrecv)

// ストリームが追加されたときに行う処理です。
config.mediaChannelHandlers.onAddStream = { [weak self] stream in
    ...
}

// ストリームが削除されたときに行う処理です。
config.mediaChannelHandlers.onRemoveStream = { [weak self] error in
    ...
}

Sora.shared.connect(configuration: config) {
    ...
}

マルチストリーム機能で接続すると、同一のチャネル ID に接続されているすべてのストリームが MediaChannel に追加されます。同一のチャネル ID のストリームが増減すると MediaChannel が保持するストリームも増減します。ストリームが追加されると MediaChannel のイベントハンドラ MediaChannelHandlers.onAddStreamHandler が、削除されると onRemoveStreamHandler が呼ばれます。

映像を描画するには、各ストリームにそれぞれ VideoRenderer をセットします。イベントハンドラを利用して映像ビューを用意するとよいでしょう。