# 非推奨 サイマルキャスト API


## RequestRtpStream

**x-sora-target**: Sora_20201005.RequestRtpStream

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

* - キー
  - 型
* - channel_id
  - string
* - recv_connection_id
  - string
* - send_connection_id (オプション)
  - string
* - rid
  - string (r0 | r1 | r2)

- `r1` までしか配信されていない場合、 `r2` をリクエストすると `r1` を受信し始めます

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


## ResetRtpStream

**x-sora-target**: Sora_20201005.ResetRtpStream

指定した視聴者が受信する RTP ストリームの rid をリセットします。

* - キー
  - 型
* - channel_id
  - string
* - recv_connection_id
  - string
* - send_connection_id (オプション)
  - string

```console
$ curl -sS \
    -X POST \
    http://127.0.0.1:3000/ \
    -H "x-sora-target: Sora_20201005.ResetRtpStream" \
    --json '{"channel_id":"sora","recv_connection_id":"4EVK3MN5Z17GB62RE5TGD045ZM","send_connection_id":"EKNQ103WRD4ZZ74B6TKRM9YK78"}' \
    | jq .
{
    "channel_id": "sora",
    "recv_connection_id": "4EVK3MN5Z17GB62RE5TGD045ZM",
    "send_connection_id": "EKNQ103WRD4ZZ74B6TKRM9YK78"
}
```