Live stream over RTMP

Search…
RTMP, a streaming protocol supported by a majority of encoders, is supported by the VideoCoin Network. This guide describes creating a stream, sending data to the ingest, and observing the HLS output.
List available streaming profiles
Below is the endpoint to retrieve all existing output profiles. Determine which profile will best suit your desired output stream and note the id property:
1
$ curl -X GET https://console.videocoin.network/api/v1/profiles
2
​
3
{
4
    "items": [
5
        {
6
            "id": "190b9d72-208d-4fa2-90b7-5b203c0025d2",
7
            "name": "SD",
8
            "description": "SD",
9
            "is_enabled": true
10
        },
11
        {
12
            "id": "45d5ef05-efef-4606-6fa3-48f42d3f0b96",
13
            "name": "FullHD",
14
            "description": "FullHD",
15
            "is_enabled": true
16
        },
17
        {
18
            "id": "e53e377f-2621-4ef1-8004-7d782e9608eb",
19
            "name": "HD",
20
            "description": "HD",
21
            "is_enabled": true
22
        }
23
    ]
24
}
Copied!
Create the stream object
Create the stream and include the required name, input_type, output_type and profile_id values. profile_id is the value of the desired profile in the previous step. Note that this request requires authorization in the form of a Bearer token. See "API Authorization" for more:
1
$ curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' -d '{"name": "live", "input_type": "INPUT_TYPE_RTMP", "output_type": "OUTPUT_TYPE_HLS", "profile_id": "190b9d72-208d-4fa2-90b7-5b203c0025d2"}' https://console.videocoin.network/api/v1/streams
2
​
3
{
4
    "id": "3f18785d-b757-4f18-77e2-36680043fff6",
5
    "name": "live",
6
    "output_url": "https://streams.videocoin.network/3f18785d-b757-4f18-77e2-36680043fff6/index.m3u8",
7
    "stream_contract_id": "1959998627787229139",
8
    "stream_contract_address": "",
9
    "status": "STREAM_STATUS_NEW",
10
    "input_status": "INPUT_STATUS_NONE",
11
    "created_at": "2019-11-06T22:54:06.866402573Z",
12
    "updated_at": "2019-11-06T22:54:06.866452401Z",
13
    "ready_at": null,
14
    "completed_at": null,
15
    "rtmp_url": "rtmp://rtmp.console.videocoin.network:1935/live/3f18785d-b757-4f18-77e2-36680043fff6",
16
    "input_type": "INPUT_TYPE_RTMP",
17
    "output_type": "OUTPUT_TYPE_HLS"    
18
}
Copied!
Start preparation of the stream
Using the id value of the previous operation, begin running the stream to prepare its input and output destinations:
1
$ curl -X POST -H 'Authorization: Bearer <TOKEN>' https://console.videocoin.network/api/v1/streams/3f18785d-b757-4f18-77e2-36680043fff6/run
Copied!
Sending video over RTMP to the stream's ingest
The stream is not yet ready to receive video until its status property is equal to STREAM_STATUS_PREPARED. For more about the various values of a stream's status property, see the "List of stream statuses (status)" section in the "Streams" page:
1
$ curl -X GET -H 'Authorization: Bearer <TOKEN>' https://console.videocoin.network/api/v1/streams/3f18785d-b757-4f18-77e2-36680043fff6
2
​
3
{
4
    "id": "3f18785d-b757-4f18-77e2-36680043fff6",
5
    "name": "live",
6
    "output_url": "https://streams.videocoin.network/3f18785d-b757-4f18-77e2-36680043fff6/index.m3u8",
7
    "stream_contract_id": "1959998627787229139",
8
    "stream_contract_address": "0x548CEb2CD19Df313e2aA65c9301CBb9d264dBB8F",
9
    "status": "STREAM_STATUS_PREPARED",
10
    "input_status": "INPUT_STATUS_NONE",
11
    "created_at": "2019-11-06T22:54:07Z",
12
    "updated_at": "2019-11-06T22:54:15Z",
13
    "ready_at": null,
14
    "completed_at": null,
15
    "rtmp_url": "rtmp://rtmp.console.videocoin.network:1935/live/3f18785d-b757-4f18-77e2-36680043fff6",
16
    "input_type": "INPUT_TYPE_RTMP",
17
    "output_type": "OUTPUT_TYPE_HLS"
18
}
Copied!
The stream is now ready to receive video. Using the rtmp_url property of your stream, begin sending data to the stream with your encoder. Below uses ffmpeg as the encoder to accomplish this:
1
$ ffmpeg -re -f lavfi -i testsrc=rate=30 -c:v libx264 -b:v 1600k -preset ultrafast -b 900k -c:a libfdk_aac -b:a 128k -s 640x480 -x264opts keyint=60 -g 30 -pix_fmt yuv420p -f flv rtmp://rtmp.console.videocoin.network:1935/live/3f18785d-b757-4f18-77e2-36680043fff6
Copied!
Using HLS output of stream
The HLS output is not ready for use until the stream's status property is equal to STREAM_STATUS_READY:
1
$ curl -X GET -H 'Authorization: Bearer <TOKEN>' https://console.videocoin.network/api/v1/streams/3f18785d-b757-4f18-77e2-36680043fff6
2
​
3
{
4
    "id": "3f18785d-b757-4f18-77e2-36680043fff6",
5
    "name": "live",
6
    "output_url": "https://streams.videocoin.network/3f18785d-b757-4f18-77e2-36680043fff6/index.m3u8",
7
    "stream_contract_id": "1959998627787229139",
8
    "stream_contract_address": "0x548CEb2CD19Df313e2aA65c9301CBb9d264dBB8F",
9
    "status": "STREAM_STATUS_READY",
10
    "input_status": "INPUT_STATUS_ACTIVE",
11
    "created_at": "2019-11-06T22:54:07Z",
12
    "updated_at": "2019-11-06T22:54:15Z",
13
    "ready_at": "2019-11-06T22:58:15Z",
14
    "completed_at": null,
15
    "rtmp_url": "rtmp://rtmp.console.videocoin.network:1935/live/3f18785d-b757-4f18-77e2-36680043fff6",
16
    "input_type": "INPUT_TYPE_RTMP", 
17
    "output_type": "OUTPUT_TYPE_HLS"
18
}
Copied!
Once the stream is in STREAM_STATUS_READY state, use the output_url property with any HLS-compatible video player to view your stream's output:
1
$ ffplay https://streams.videocoin.network/3f18785d-b757-4f18-77e2-36680043fff6/index.m3u8
Copied!
Ending your stream
The stream will complete automatically if the encoder it is receiving data from has stopped. The stream can also be stopped manually as shown below:
1
$ curl -X POST -H 'Authorization: Bearer <TOKEN>' https://console.videocoin.network/api/v1/streams/3f18785d-b757-4f18-77e2-36680043fff6/stop
Copied!
​
File Transcoding
Live stream over WebRTC
Last modified 1yr ago
Copy link
Contents
List available streaming profiles
Create the stream object
Start preparation of the stream
Sending video over RTMP to the stream's ingest
Using HLS output of stream
Ending your stream
List available streaming profiles

Create the stream object

Start preparation of the stream

Sending video over RTMP to the stream's ingest

Using HLS output of stream

Ending your stream

​
