マルチストリーム機能¶

概要¶

マルチストリームとは、1 つのピア接続で複数のストリームを管理する機能です。この機能を利用して、1 つの接続で送信と受信の両方を行うことができます。

詳細は Sora ドキュメントのマルチストリーム機能をご確認ください。

マルチストリーム機能の利用¶

注意

Android SDK はマルチストリームをデフォルトで利用する設定になっていないため、マルチストリームを利用する場合は明示的にマルチストリームを指定する必要があります。今後はデフォルトでマルチストリームを利用する仕組みに変更する予定です。

送受信を指定¶

SoraMediaOption にて映像または音声の送信と受信両方を指定した場合は自動的にマルチストリーム機能が有効となります。

val option = SoraMediaOption().apply {

    // 音声の送受信をおこなっているためマルチストリームが自動的に有効になります
    enableAudioUpstream()
    enableAudioDownstream()

}

送信のみを指定¶

送信のみを指定した場合はマルチストリーム機能を有効にするために明示的に SoraMediaOption.enableMultistream() を実行する必要があります。

val option = SoraMediaOption().apply {

    // 映像と音声の受信のみを指定した場合マルチストリーム機能は有効となリません
    enableVideoUpstream()
    enableAudioUpstream()

    // 明示的にマルチストリーム機能を有効にします
    enableMultistream()

}

受信のみを指定¶

受信のみを指定した場合はマルチストリーム機能を有効にするために明示的に SoraMediaOption.enableMultistream() を実行する必要があります。

val option = SoraMediaOption().apply {

    // 映像と音声の受信のみを指定した場合マルチストリーム機能は有効となリません
    enableVideoDownstream()
    enableAudioDownstream()

    // 明示的にマルチストリーム機能を有効にします
    enableMultistream()

}