サイマルキャスト機能¶

概要¶

サイマルキャスト (Simulcast) 機能は配信時に 1 つの RTCPeerConnection から複数種類のエンコードした映像を配信する機能です。詳細は Sora ドキュメントサイマルキャスト機能をご確認ください。

サイマルキャストを有効にする¶

シグナリング接続時に Configuration.simulcastEnabled プロパティを true に設定します。視聴時に受信する映像を Configuration.simulcastRequestRid または Configuration.simulcastRid で指定可能です。

注釈

Sora 2025.2.0 より、シグナリング接続時に視聴するサイマルキャスト映像の指定先として Configuration.simulcastRequestRid が追加されました。これに伴い既存の Configuration.simulcastRid は非推奨になり、 2027 年 12 月リリース予定の Sora では利用できなくなります。

サイマルキャストの Configuration 設定例¶

ビットレートや解像度が低い場合、 3 段階の画質の切替ができないことがあります。詳細は Sora ドキュメント現時点でのサイマルキャストの仕様をご確認ください。

// 接続の設定を行います。
let config = Configuration(url: soraURL,
                           channelId: soraChannelId,
                           role: role)

// サイマルキャストの有効化
config.simulcastEnabled = true

// サイマルキャスト受信時の映像を指定
// Sora 2025.2.x 以降を利用の場合は simulcastRequestRid を指定
config.simulcastRequestRid = .r0

// Sora 2025.1.x 以前を利用の場合は simulcastRid のみが指定可能
config.simulcastRid = .r0

// 動画のコーデックを指定します
config.videoCodec = .vp8

// 十分な解像度、ビットレートを指定しないとサイマルキャストの映像が 3 本になりません
config.videoBitRate = 15000

// 解像度、フレームレートの設定
config.cameraSettings = CameraSettings(resolution: .hd1080p, frameRate: 30)