# サイマルキャスト API


## RequestSimulcastRid

**x-sora-target**: Sora_20251217.RequestSimulcastRid

指定した視聴者が受信するストリームの `rid` をリクエストします。

* - キー
  - 型
* - channel_id
  - string
* - receiver_connection_id
  - string
* - sender_connection_id (オプション)
  - string
* - rid
  - string (none | r0 | r1 | r2)

- `r1` までしか配信されていない場合、 `r2` をリクエストすると `r1` を受信し始めます
- `none` をリクエストすると映像ストリームが配信されなくなります

```console
$ curl -sS \
    -X POST \
    http://127.0.0.1:3000/ \
    -H "x-sora-target: Sora_20251217.RequestSimulcastRid" \
    --json '{"channel_id":"sora","receiver_connection_id":"4EVK3MN5Z17GB62RE5TGD045ZM","sender_connection_id":"EKNQ103WRD4ZZ74B6TKRM9YK78","rid":"r1"}' \
    | jq .
{
    "channel_id": "sora",
    "receiver_connection_id": "4EVK3MN5Z17GB62RE5TGD045ZM",
    "rid": "r1",
    "sender_connection_id": "EKNQ103WRD4ZZ74B6TKRM9YK78"
}
```