Skip to content

Latest commit

 

History

History
31 lines (28 loc) · 6.81 KB

LiveStream.md

File metadata and controls

31 lines (28 loc) · 6.81 KB

# LiveStream

Properties

Name Type Description Notes
id string Unique identifier for the Live Stream. Max 255 characters. [optional]
created_at string Time the Live Stream was created, defined as a Unix timestamp (seconds since epoch). [optional]
stream_key string Unique key used for streaming to a Mux RTMP endpoint. This should be considered as sensitive as credentials, anyone with this stream key can begin streaming. [optional]
active_asset_id string The Asset that is currently being created if there is an active broadcast. [optional]
recent_asset_ids string[] An array of strings with the most recent Asset IDs that were created from this Live Stream. The most recently generated Asset ID is the last entry in the list. [optional]
status \MuxPhp\Models\LiveStreamStatus [optional]
playback_ids \MuxPhp\Models\PlaybackID[] An array of Playback ID objects. Use these to create HLS playback URLs. See Play your videos for more details. [optional]
new_asset_settings \MuxPhp\Models\CreateAssetRequest [optional]
passthrough string Arbitrary user-supplied metadata set for the asset. Max 255 characters. [optional]
audio_only bool The live stream only processes the audio track if the value is set to true. Mux drops the video track if broadcasted. [optional]
embedded_subtitles \MuxPhp\Models\LiveStreamEmbeddedSubtitleSettings[] Describes the embedded closed caption configuration of the incoming live stream. [optional]
generated_subtitles \MuxPhp\Models\LiveStreamGeneratedSubtitleSettings[] Configure the incoming live stream to include subtitles created with automatic speech recognition. Each Asset created from a live stream with `generated_subtitles` configured will automatically receive two text tracks. The first of these will have a `text_source` value of `generated_live`, and will be available with `ready` status as soon as the stream is live. The second text track will have a `text_source` value of `generated_live_final` and will contain subtitles with improved accuracy, timing, and formatting. However, `generated_live_final` tracks will not be available in `ready` status until the live stream ends. If an Asset has both `generated_live` and `generated_live_final` tracks that are `ready`, then only the `generated_live_final` track will be included during playback. [optional]
reconnect_window float When live streaming software disconnects from Mux, either intentionally or due to a drop in the network, the Reconnect Window is the time in seconds that Mux should wait for the streaming software to reconnect before considering the live stream finished and completing the recorded asset. Max: 1800s (30 minutes). If not specified directly, Standard Latency streams have a Reconnect Window of 60 seconds; Reduced and Low Latency streams have a default of 0 seconds, or no Reconnect Window. For that reason, we suggest specifying a value other than zero for Reduced and Low Latency streams. Reduced and Low Latency streams with a Reconnect Window greater than zero will insert slate media into the recorded asset while waiting for the streaming software to reconnect or when there are brief interruptions in the live stream media. When using a Reconnect Window setting higher than 60 seconds with a Standard Latency stream, we highly recommend enabling slate with the `use_slate_for_standard_latency` option. [optional] [default to 60]
use_slate_for_standard_latency bool By default, Standard Latency live streams do not have slate media inserted while waiting for live streaming software to reconnect to Mux. Setting this to true enables slate insertion on a Standard Latency stream. [optional] [default to false]
reconnect_slate_url string The URL of the image file that Mux should download and use as slate media during interruptions of the live stream media. This file will be downloaded each time a new recorded asset is created from the live stream. If this is not set, the default slate media will be used. [optional]
reduced_latency bool This field is deprecated. Please use `latency_mode` instead. Latency is the time from when the streamer transmits a frame of video to when you see it in the player. Set this if you want lower latency for your live stream. See the Reduce live stream latency guide to understand the tradeoffs. [optional]
low_latency bool This field is deprecated. Please use `latency_mode` instead. Latency is the time from when the streamer transmits a frame of video to when you see it in the player. Setting this option will enable compatibility with the LL-HLS specification for low-latency streaming. This typically has lower latency than Reduced Latency streams, and cannot be combined with Reduced Latency. [optional]
simulcast_targets \MuxPhp\Models\SimulcastTarget[] Each Simulcast Target contains configuration details to broadcast (or "restream") a live stream to a third-party streaming service. See the Stream live to 3rd party platforms guide. [optional]
latency_mode string Latency is the time from when the streamer transmits a frame of video to when you see it in the player. Set this as an alternative to setting low latency or reduced latency flags. [optional]
test bool True means this live stream is a test live stream. Test live streams can be used to help evaluate the Mux Video APIs for free. There is no limit on the number of test live streams, but they are watermarked with the Mux logo, and limited to 5 minutes. The test live stream is disabled after the stream is active for 5 mins and the recorded asset also deleted after 24 hours. [optional]
max_continuous_duration int The time in seconds a live stream may be continuously active before being disconnected. Defaults to 12 hours. [optional] [default to 43200]
srt_passphrase string Unique key used for encrypting a stream to a Mux SRT endpoint. [optional]
active_ingest_protocol string The protocol used for the active ingest stream. This is only set when the live stream is active. [optional]

[Back to Model list] [Back to API list] [Back to README]