スポットライト機能

スポットライト機能の詳細は Sora のドキュメント を参照してください。

スポットライト機能を有効にする

スポットライト機能を有効するには SoraMediaOption.enableSpotlight() を実行します。 スポットライト機能を有効にすると、同時に サイマルキャスト機能 とマルチストリームが有効になります。

例:

val option = SoraMediaOption().apply {

    // 映像の配信 (受信なら enableVideoDownstream)
    enableVideoUpstream(egl.eglBaseContext)

    // スポットライト機能の設定
    val spotlight = SoraSpotlightOption()

    // サイマルキャスト rid
    spotlight.simulcastRid = SimulcastRid.R0

    // 最大アクティブ配信数
    spotlight.spotlightNumber = 3

    // スポットライト機能を有効にする
    enableSpotlight(spotlight)

    // 映像コーデックは VP8 または H.264
    videoCodec = SoraVideoOption.Codec.VP8

    // 高画質に対応するためにビットレートを高めに指定する
    videoBitrate = 5000

}

// 高画質に対応するためにカメラの解像度を高めに指定する
capturer?.changeCaptureFormat(1920, 1080, 30)

スポットライトレガシー機能を有効にする

重要

スポットライトレガシー機能は 2021 年 12 月に廃止が予定されています。

スポットライトレガシー機能を有効にするには、サーバ側でスポットライトレガシー機能を有効にしてから Sora.usesSpotlightLegacy プロパティに true を指定します。

サーバ側でスポットライトレガシー機能が無効になっているとシグナリングに失敗します。 事前にサーバの設定を確認してください。

例:

// スポットライトレガシー機能を有効にする
Sora.usesSpotlightLegacy = true

// スポットライトの設定
val option = SoraMediaOption().apply {
  ...
}