Zixi Broadcaster/ZEC v18 Docum...
...
Zixi Broadcaster User Guide
Adaptive Groups
Creating New Adaptive Groups
3 min
to create a new adaptive group in the zixi broadcaster administrative screen, click the adaptive tab click add group the adaptive live streams group window is displayed in the group name field, enter the unique string as the adaptive group's name under streamid , select a stream from the drop down list to create an adaptive bitrate enter the desired bitrate\[kbps] for that stream in the adjacent field to stream id click + add stream to add as many streams as you want to include in the group and repeat steps 4 and 5 for every stream that is added to the group select one or more protocols with that will be supported for this adaptive group the zixi protocol option enables devices using the zixi sdk to view the stream using the zixi protocol select send distinct audio/video elementary streams if the input streams include multiple audio/video channels to enable multiple separate audio/channels channels in the adaptive group specify the hls/dash segment/chunk duration and count (see details in the table below) specify the duration to keep recorded files for \[minutes] if the file is left as blank, the system will use the global settings specified in the settings > live protocols screen in the hls dvr maximum recording duration field in the file name template field, specify the file name pattern that zixi will use to generate when saving the recorded content click ok the new adaptive group is created and appears on the adaptive screen parameter description group name specifies the unique identifier for this group stream id select an input stream from the drop down list bitrate \[kbps] specify the bitrate for the selected stream protocols select one or more protocols that will be supported for this adaptive group zixi hls (enables devices using the zixi sdk to view the stream using the zixi protocol), hls, cmaf (dash + fmp4) send distinct audio/video elementary streams select this checkbox if the input streams include multiple audio/video channels to enable multiple separate audio/video channels channels in the adaptive group note be sure to check this box if you are enabling drm for these streams hls over multicast select this checkbox to enable multicasting of the adaptive stream (requires multicast to be enabled in the settings) fast playback select this setting to enable low latency hls delivery the enable hls fast playback on the settings > live protocols screen must be enabled only the ts segments version of the hls stream will be available for adaptive streaming, not the fragmented mp4 (fmp4) version when enabled, the following playback urls will be available http //\<server url> 7777/playback m3u8?stream=\<adaptive group name> http //\<server url> 7777/\<adaptive group name> m3u8 convert cea 708 to webvtt extracts closed caption from video elementary stream and converts it to webvtt format this feature is currently available for hls only and there is no support to styling/placement, just text hls segment duration \[sec] specify the duration in seconds of each segment/chunk in the hls playlist you can specify sub second durations (e g 0 5) (default 6 seconds) hls segments count specify the number of segments in the hls playlist dash segment duration \[sec] specify the duration in seconds of each segment/chunk in the dash adaptive group you can specify sub second durations (e g 0 5) (default 6 seconds) dash segments count specify the number of segments in the dash adaptive group recording keep recorded files for \[minutes] specifies the maximum time for storing the recording if the file is left as blank, the system will use the global settings specified in the settings > live protocols screen in the hls dvr maximum recording duration field file name template specify the file name pattern that zixi will use to generate when saving the recorded content a separate file will be generated for each recording up to the time specified in the max recorded file duration parameter (see above) after this duration a new file will be generated the file name pattern can include any string and up to three variables listed below only the %t=hh mm ss timestamp is mandatory you can change the order of these variables and add text as long as you maintain the legitimate structure of the file in linux and windows %g = group name – optional %n = sequence number – optional %t=hh mm ss timestamp mandatory advanced mode the fields in the table below are optional and available only in advanced mode to enter advanced mode add the url parameter ?advanced=1 to the zixi broadcaster url in your browser and press enter/return to reload the page note the advanced mode settings are generally intended for advanced users and special cases if you do not understand the settings, you should probably accept the default values you will then see a number of additional input parameters advanced mode parameters parameter description don't synchronize disable automatic synchronization between audio and video streams during the transcoding process drop first segment for hls workflows, this can help ensure smoother playback by eliminating non keyframe segments that might cause decoding issues mmt select this checkbox to enable mpeg media transport (mmt) protocol instead of the zixi protocol compress zixi requires selecting zixi as the protocol select this checkbox to compress the stream before transmitting it the compression reduces bitrate if there are redundancies in the stream, like null packets and also optimizes the elementary stream if possible nothing is taken out of the stream it is 100% identical to the source on the receive side having compression on not only reduces bitrate, but also improves resiliency packets are less likely to get dropped, and it leaves more headroom for error correction (fec/arq) max segments in folder specify the maximum segments before zixi starts to delete old segment when new ones are ready this setting is relevant for dvr 0 – unlimited adjust va timestamps in many cases in transport streams the video timestamp arrives ahead of the audio timestamps, since video decoding requires more time select this option to adjusts the order of packets, so all timestamps will be monotonically increased the adjustment of the video and audio timestamps will bring them closer together note that this feature will modify the order of packets and will increase memory usage segment on scte 35 scte 35 markers found in the source input will be used to segment the stream and the #ext x cue in/#ext x cue out tags will be added to the manifest select the tag that will be used to segment the stream from the scte 35 tag field below dash binary format for scte 35 use binary representation rather than xml for scte 35 messages in dash duration attribute in cue out the #ext x cue out tag can be printed out to the playlist in two formats #ext x cue out\ duration=\<duration in seconds> #ext x cue out \<duration in seconds> when the duration attribute in cue out option selected the first format is used, and when it is not selected, the second format is used don't add ext x cue in select this option to remove the ext x cue in tag, which indicates where to back to the program, from the playlist scte 35 tag select the ad marker tag that will be used to segment the stream ext x cue – cue in and cue out ad markers ext x daterange with ext x daterange ad marker tags, you use scte35 out attributes to specify the timing of the ad avail ext x cue and ext x daterange – zixi will use both ad marker tags to segment ascending order select this option to order the master playlist in ascending order by bitrate drop unaligned segments select this option to have zixi detect unalignment between segments of different bitrates in case unalignment is detected, the unaligned segments will be dropped and will not be recorded to dvr additional segment delay normally zixi maintains segment data in memory until it reaches the size of a chunk when selecting this option, additional data held in memory (size of segment duration) will be used to try to sync between different streams that are not synced (e g one of the bitrate versions is delayed by up to the duration of half a segment) single stream webvtt in case there is several streams in adaptive group, by selecting this option, only the subtitles of the first stream will be used for entire group if the checkbox is not selected, zixi broadcaster will create separate webvtt files for each individual stream multiserver sync select this option to use the absolute system clock time to segment the stream in order to be able to synchronize the stream segmentation between multiple zixi broadcaster servers the absolute time is determined by the multiple of the value set in the hls segment duration i e if segment duration is 6 sec then the segmentation occurs when the seconds in the system time indicate one of the multiples of 6 0s, 6s, 12s for example, if the hls segment duration is set to 6 seconds and the adaptive group was added at 12 01 03 without multi server sync the first segmentation will be at 12 01 09 and then at 12 01 15… etc with multi server sync – the first segmentation will be at 12 01 06, 12 01 12 etc ext x program date time source the ext x program date time is an hls tag that specifies the "real world" clock in stream none – disabled sei pic timing the "real world clock" is extracted from the sei (supplemental enhancement information) messages in the mpeg ts stream one of the messages is "pic timing", which is based on the real world clock packet arrival – the tag includes the utm clock of the machine time when the first packet in this segment has arrived to zixi broadcaster this tag is printed on every 5th segment only segments between ext x program date time tags drm enable drm on the streams for this group note drm is supported by broadcaster v18 or later and requires that you have ir deto or another external drm provider user name username for your drm service password password for your drm service url place the license url from the drm provider here this is the url end playback devices submit their requests for access to the decryption license broadcast writes this in the adaptive manifest output kid is a 128 bit value in uuid format given by your drm provider that uniquely identifies a specific content encryption key (cek) the kid is essential for associating encrypted content with its corresponding decryption key content id an identifier in the drm provider that holds the drm business rules fairplay laurl the license acquisition url used in apple fairplay drm (digital rights management) it is the endpoint where a video player requests a decryption key to unlock protected content