マルチストリーム機能¶

概要¶

マルチストリームとは一つの PeerConnection の中で複数の映像や音声を動的に追加したり削除したりする仕組みです。 この機能を利用することで、複数の PeerConnection を管理せずに複数の映像や音声を使用できるようになります。

制限¶

• 配信側は音声 1 トラック、映像 1 トラック固定です
• 動的に配信側のトラックを追加したりするマルチトラックには対応していません

ブラウザ¶

Chrome、Firefox、Safari、Edge と主要ブラウザすべてでマルチストリームを利用できます。

シグナリング仕様¶

マルチストリームを利用する場合は、ユーザーが参加や離脱をするたびに SDP を交換する必要があります。

{
    "type": "connect",
    "role": "sendrecv",
    "channel_id": "sora"
}

{
    "type": "connect",
    "role": "sendrecv",
    "channel_id": "sora",
    "multistream": false
}

{
    "type": "re-offer",
    "sdp": ".."
}

{
    "type": "re-answer",
    "sdp": ".."
}

role¶

マルチストリームでは role に sendrecv と sendonly と recvonly を指定できます。

• sendrecv は配信と視聴を行います
• sendonly は配信のみを行います
• recvonly は視聴のみを行います

マルチストリームにおける映像ビットレート自動シェアリング機能¶

音声のビットレートには影響しません

マルチストリームでは複数の映像を大量に受信するため、 配信側の映像ビットレートを、参加している配信者全員でシェアする機能がデフォルトで有効になっています。

そのため、マルチストリームにおける video の bit_rate は、 非マルチストリームの bit_rate とは扱いが異なります。

例えば、 bit_rate を 1200 と指定した場合、 2 人で配信している場合はそれぞれ配信に 600 kbps ずつ使用します。 ここに 1 人が加わり 3 人になると、 1 人 400 kbps ずつ使用して配信するようになります。

また、ここに 5 人が加わり、合計で 8 人になると、 1 人 150 kbps ずつ使用して配信するようになります。

配信の合計のビットレートを指定するのが video の bit_rate です。

シーケンス図¶