サイマルキャスト API

注意

この API は 実験的機能 のため、正式版では仕様が変更される可能性があります。

ChangeSimulcastAuto

x-sora-target:

Sora_20251217.ChangeSimulcastAuto

指定した視聴者が受信するストリームの rid を視聴者の環境に合わせたものを配信するように変更します。

変更する際に自動で切り替わる rid のリストを指定します。

キー	型
channel_id	string
receiver_connection_id	string
sender_connection_id (オプション)	string
rids	string[none | r0 | r1 | r2, ...]

• rids に指定したリストの中から視聴者の環境に合わせた rid で映像ストリームが配信されます

• rids に [] を指定すると自動で rid の切り替えは無効化されます

$ http POST 127.0.0.1:3000/ \
  x-sora-target:Sora_20251217.ChangeSimulcastAuto \
  channel_id=sora \
  receiver_connection_id=4EVK3MN5Z17GB62RE5TGD045ZM \
  rids:='["r0", "r1"]' \
  -vvv


HTTP/1.1 200 OK
access-control-allow-headers: Origin, X-Requested-With, Content-Type, Accept, x-sora-target
access-control-allow-methods: POST, OPTIONS
access-control-allow-origin: http://127.0.0.1:5000
Content-Length: 135
content-type: application/json
Date: Mon, 01 Dec 2025 02:41:00 GMT
server: Cowboy

{
    "channel_id": "sora",
    "receiver_connection_id": "4EVK3MN5Z17GB62RE5TGD045ZM",
    "rids": [
        "r0",
        "r1"
    ]
}

コンテンツ

• サイマルキャスト API
  • ChangeSimulcastAuto