Multistream
A multistream facilitates the simultaneous broadcast of a source stream, along
with its transcoded renditions, to various RTMP/RTMPS destinations like Twitch,
Facebook Live, and YouTube Live. This feature ensures that users can maximize
their audience reach across multiple platforms with a single streaming session.
When setting up a multistream, users have the option to utilize the Livepeer
Studio Dashboard, directly interfaces with Livepeer Studio API, or the Livepeer
Studio SDKs. These offer comprehensive management tools to configure, modify, or
delete specific multistream targets linked with individual streams. It’s
important to note that configurations are stream-specific; hence, they don’t
automatically transfer when generating new streams.
The essential parameters for setting up a target include a name, the ingest URL,
and, if relevant, adding a stream key. Users can also specify which rendition
profile they intend to dispatch to the target.
After creating a multistream target, it can be toggled as active/inactive. Also,
both the dashboard and API provide options for editing or deleting these
targets. To initiate multistreaming, the multistream target needs to be linked
to a stream.
Monitoring
For performance monitoring and understanding stream health, Studio offers real-time indicators through its dashboard and API, showing whether a multistream target is currently active or offline. The status updates might experience a slight delay before the stream’s live status gets mirrored on the destination platform. In Studio’s “Health” tab, users can obtain a detailed view of the ingest rate for the active source stream.Webhooks
Additionally, Livepeer has three webhooks to monitor multistream targets:multistream.connected: Indicates a successful connection to the multistream target and confirms the stream’s live status on the corresponding service.multistream.error: Flags issues during the connection process, suggesting potential configuration errors or problems with the destination platform.multistream.disconnected: Notifies users when a stream concludes and multistreaming to a particular target has also ended.