- Introduction to Video
- Stream video files
- Start live streaming
- Configure broadcast software
- Live streaming from your app
- Reduce live stream latency
- Manage Stream Keys
- Stream recordings of live streams
- Live streaming FAQs
- Stream live to 3rd party platforms
- Use a custom domain for live streaming
- Handle live stream disconnects
- Stream simulated live
- Debug live stream issues
- Add your own live captions
- Add auto-generated live captions
- Build real-time video experiences
- Make API requests
- Play your videos
- Enable static MP4 renditions
- Download for offline editing
- Embed videos for social media
- Listen for webhooks
- Secure video playback
- Create clips from your videos
- Get images from a video
- Create timeline hover previews
- Adjust audio levels
- Add watermarks to your videos
- Add subtitles to your videos
- Minimize processing time
- Upload files directly
- Autoplay your videos
- Synchronize video playback
- Integrate with your CMS
Manage stream keys
Learn how to manage stream keys and enable/disable access to go live.
In this guide:
When live streaming, a stream key is used by a broadcaster to receive a live stream for a Mux account. Stream keys, by nature, are private and should be handled with care. This means that access to the stream key should be reserved for the broadcaster and hidden from end users.
Single live stream configurations are great for when only one stream will ever be active at a time, or for disposable, single-use live streams.
For example, if you are hosting a conference where the agenda is a back-to-back track of speakers, a single live stream is used in this scenario.
Creating multiple live stream configurations are implemented in situations where multiple live streams are expected. Some reasons you might choose this live stream configuration would include—
- Multiple concurrent streams that overlap in when they go live
- User generated content where going live can happen at any time and there is no established schedule
Concurrent live streams
When working with multiple streams that can overlap in realtime, use multiple live stream configurations. Each live stream configuration can be tied to each live stream event.
For example, if you are hosting different concurrent events, each event would need an individual live stream configuration created.
If you want to control the ability to accept a live stream, you can use the enable live streamAPI and disable live streamAPI API endpoints. These endpoints can be called based on your business logic from your CMS/backend to control your content creator's ability to go live.
User generated content
If your solution allows your users to go live at any time, a live stream configuration for each potential content creator will need to be created. As you will see in the following, the Mux live stream configuration id
will be tied to each content creator using your service.
When provisioning your user as a content creator, create a live streamAPI configuration that will be used solely by this content creator. The data.id
response value needs to be stored within your CMS so that it can be used to deliver the live stream to end users when the content creator goes live. A live stream configuration created for a content creator can be reused by that content creator over their life span.
The data.stream_key
value could also be stored in the CMS in case the content creator wants to recall the stream key at a later time.
Another option is to pass through the stream key to the content creator at provision time without storing the stream key. A common use-case that we support is for the ability to reset the stream key for a given live stream configuration. To do this, Mux offers a reset stream keyAPI API.
Reset stream key
If a stream key needs to be reset for a live stream configuration because it was lost or compromised, the reset stream keyAPI can be used to regenerate the stream key.
Complete live stream
Typically, when a content creator has end their live stream session by stopping a stream, Mux will wait for the duration configured for the live stream's reconnect_window
before making it available as an on-demand asset.
To make a live stream available immediately, you can signal live stream completeAPI to immediately make the live stream available as an on-demand asset.
Enable live stream
To enable a live stream configuration so that it is able to receive an RTMP session, call the enable live streamAPI API endpoint.
Disable live stream
Should you want to disable a live stream configuration so that it no longer accepts RTMP sessions, the disable live streamAPI is used to achieve this use case.