Amazon Interactive Video Service (IVS) is an AWS service that allows you to create an HTTP Live Stream (HLS) from an RTMP stream. Make sure to read about the additional pricing for this AWS service. In this article I will show you how to use Amazon IVS to publish your Dolby.io conferences to the world.
Login into your AWS management console, search for IVS and create a new channel. Select the region in which you want to deploy the IVS service. As a best practice, select the region that is the closest to where the conference is going to be created.
- Provide a name for this channel.
- Select Custom configuration.
- Select the Standard channel type, as our mixer is generating a 1080p resolution stream.
- Select the Video latency that fits your use case.
- Click Create channel at the bottom of the page.
Within a few seconds, the channel is set up and ready to receive your conference stream.
In the Stream configuration, copy the Ingest server as well as the Stream key.
During your conference, you will need to make a REST API call to the Dolby API using the URL of the RTMP endpoint:
POST /v1/api/conferences/mix/{conference_id}/live/start HTTP/1.1
Host: session.voxeet.com
Authorization: Basic base64(CONSUMER_KEY + ":" + CONSUMER_SECRET)
Content-Type: application/json
{
"uri": "rtmps://123456789012.global-contribute.live-video.net:443/app/{stream_key}"
}A few seconds after calling the API, you will be able to see the live stream starting on the preview player.
In the Playback configuration section, get the Playback URL and provide it to your end user for them to watch the live stream.
If you need to stop the live stream before the conference ends, call the following API:
POST /v1/api/conferences/mix/{conference_id}/live/stop HTTP/1.1
Host: session.voxeet.com
Authorization: Basic base64(CONSUMER_KEY + ":" + CONSUMER_SECRET)
Content-Type: application/json
