Creating New Adaptive Groups

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 if the adaptive group will be used as the input for a tams output docid\ gw6mto1mu738enod19nr8 , you must enter the ids for the video and audio flows, which are in the form of uuids you must also select hls as at least one of the outputs select send distinct audio/video elementary streams 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 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 if the video has cea 708 captions, check the box to convert these to webvtt captions for broadcaster v18 8 or later, you can also specify the placement of the captions line % 0 100 definition specifies the vertical position of the cue box range 0–100 (as a percentage of the video height) meaning 0% positions the cue at the top of the video frame 100% positions the cue at the bottom of the frame if omitted, the cue defaults to near the bottom (depending on browser defaults) position % 0 100 definition specifies the horizontal position of the cue box’s anchor point range 0–100 (as a percentage of the video width) meaning 0% aligns the cue box with the left edge of the video 100% aligns it with the right edge intermediate values shift the cue horizontally across the video align left, middle, right definition defines the text alignment or anchor point within the cue box accepted values left – the cue box’s left edge is anchored to the specified position middle – the cue box’s center is anchored to the specified position right – the cue box’s right edge is anchored to the specified position meaning controls how the text block aligns relative to the position value 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 field is left 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 parameters table 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 the value should be the sum of the video and audio bitrates plus a small amount to account for streaming overhead for transcoded sources, zen master automatically sets a default value that can be adjusted manually for sources in which either the video, audio, or both are not transcoded, the user must manually input the value based on the actual bitrates of the source it is important to enter an accurate value since it will be included in the hls/dash manifest video tams flow uuid if this group will be output to a tams system, this uuid is required see adding tams outputs docid\ gw6mto1mu738enod19nr8 and tams and zixi docid\ xb6n9zunccgoddabrvsba audio tams flow uuid if this group will be output to a tams system, this uuid is required see adding tams outputs docid\ gw6mto1mu738enod19nr8 and tams and zixi docid\ xb6n9zunccgoddabrvsba 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 for broadcaster v18 8 or later , there are also placement options for the captions line % 0 100 definition specifies the vertical position of the cue box range 0–100 (as a percentage of the video height) meaning 0% positions the cue at the top of the video frame 100% positions the cue at the bottom of the frame if omitted, the cue defaults to near the bottom (depending on browser defaults) position % 0 100 definition specifies the horizontal position of the cue box’s anchor point range 0–100 (as a percentage of the video width) meaning 0% aligns the cue box with the left edge of the video 100% aligns it with the right edge intermediate values shift the cue horizontally across the video align left, middle right definition defines the text alignment or anchor point within the cue box accepted values left – the cue box’s left edge is anchored to the specified position middle – the cue box’s center is anchored to the specified position right – the cue box’s right edge is anchored to the specified position meaning controls how the text block aligns relative to the position value 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 discussed 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 settings 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 ext x cue & ext oatcls scte35 the ext oatcls scte35 marker tag includes the base 64 encoded scte payload 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 – default no #ext x program date time tags written to playlists system time each rendition's segmenter reads the wall clock independently per segment can produce small (10 20ms) drift across variants sei timecode derives pdt from sei picture timing in the source bitstream note always writes pdt on every segment regardless of the "segments between ext x program date time tags" value requires sei pic timing to survive through to the segmenter (will not work if the stream is transcoded, as the transcoder strips sei during re encode) packet arrival – uses packet arrival time affected by "segments between" setting (see notes docid\ i8deswrqtzabwg4zowckw below) segmentation time (new in v19) calculates pdt as (current pts first pts) + group creation time produces identical pdt values across all renditions since they share the same base time recommended for workflows requiring consistent pdt (e g ssai / dynamic ad insertion) (see notes docid\ i8deswrqtzabwg4zowckw below) segments between ext x program date time tags configure the the frequency in which the ext x program date time tags will appear in the manifest by specifying the number of segments between each ext x program date time tag 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 https //irdeto com/video entertainment/drm solution content protection? gl=1 jfrji0 up mq ga mjg2nzc0odk0lje3nduyndywmdq ga gmswg3kmbn mtc0nti0njawmy4xljeumtc0nti0nju1nc4wljauma ga gm5bfb2cc0 mtc0nti0njawnc4xljeumtc0nti0nju1nc4wljauma 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 target tag the hls tag to modify (e g , ext x stream inf, ext x media ) free form text, case sensitive see sample use case for custom tags docid\ i8deswrqtzabwg4zowckw target filter optional key value filter to target specific instances of a tag (e g , type=subtitles ) if omitted, the attribute is applied to all instances of the target tag case sensitive attribute key the attribute name to add (e g , language ) free form text, case sensitive attribute value the value for the attribute (e g , eng ) free form text, case sensitive notes this setting is ignored when "sei timecode" is selected — pdt is always written on every segment in that mode it is respected for "packet arrival" and "segmentation time" modes best practice note for customers using ssai or requiring consistent pdt across renditions, recommend "segmentation time" with "segments between pdt tags" set to 1 sample use case for custom tags adding language="eng" to subtitle tracks target tag ext x media tag filter type=subtitles attribute key language attribute value eng result language="eng" is added to both subtitle tracks; the audio track is unchanged