# サイマルキャスト API

> **注意**
>
> この API は [実験的機能](EXPERIMENTAL.html) のため、正式版では仕様が変更される可能性があります。


## 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 の切り替えは無効化されます

```console
$ curl -sS \
    -X POST \
    http://127.0.0.1:3000/ \
    -H "x-sora-target: Sora_20251217.ChangeSimulcastAuto" \
    --json '{"channel_id":"sora","receiver_connection_id":"4EVK3MN5Z17GB62RE5TGD045ZM","rids":["r0","r1"]}' \
    | jq .
{
    "channel_id": "sora",
    "receiver_connection_id": "4EVK3MN5Z17GB62RE5TGD045ZM",
    "rids": [
        "r0",
        "r1"
    ]
}
```