# RTP 転送 API

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

指定したチャネル ID の配信している映像または音声の RTP を指定した IP アドレスとポートに送信します。

## 注意

- サイマルキャストの映像配信には対応していません


## StartForwardingRtp

**x-sora-target**: Sora_20170814.StartForwardingRtp

指定したチャネルの RTP の転送を開始します。

* - キー
  - 型
* - channel_id
  - string
* - connection_id
  - string
* - ip_address
  - string
* - audio_port
  - integer
* - video_port
  - integer

```console
$ curl -sS \
    -X POST \
    http://127.0.0.1:3000/ \
    -H "x-sora-target: Sora_20170814.StartForwardingRtp" \
    --json '{"channel_id":"sora","connection_id":"3X0W1C23KS1TQAAYMKA9TXJS4G","ip_address":"127.0.0.1","audio_port":60001,"video_port":60003}' \
    | jq .
{
    "sdp": "v=0\r\no=- 0 0 IN IP4 0.0.0.0\r\ns=-\r\nt=0 0\r\nm=audio 60001 RTP/SAVPF 109\r\nc=IN IP4 127.0.0.1\r\na=rtpmap:109 opus/48000/2\r\nm=video 60003 RTP/SAVPF 120\r\nc=IN IP4 127.0.0.1\r\na=rtpmap:120 VP9/90000\r\na=fmtp:120 max-fs=12288;max-fr=60\r\n"
}
```


## StopForwardingRtp

**x-sora-target**: Sora_20170814.StopForwardingRtp

指定したチャネルの RTP の転送を停止します。

* - キー
  - 型
* - channel_id
  - string
* - connection_id
  - string

```console
$ curl -sS \
    -X POST \
    http://127.0.0.1:3000/ \
    -H "x-sora-target: Sora_20170814.StopForwardingRtp" \
    --json '{"channel_id":"sora","connection_id":"3X0W1C23KS1TQAAYMKA9TXJS4G"}' \
    | jq .
{
    "channel_id": "sora",
    "connection_id": "3X0W1C23KS1TQAAYMKA9TXJS4G"
}
```