Adding a Zixi Source – OnAir

adding a zixi source – onair the onair source is a special variety of the zixi push source, designed to accept a live stream from the zixi on air pro docid 8mmlxna1om5bacjoa oic app for ios (available in the app store) once the source is created, you can email the configuration details to the device user, who will be able to click a link in the message to open the onair pro app and set up the connection automatically to add an onair source in the main navigation, click sources click + add the create new source selection window is displayed choose source type click on zixi the create zixi source window opens be sure to set the mode to push and the application to onair to get the correct fields in the info section, in the name field, type a logical name for the zixi source in the tags field, select one or more of the predefined tags from the drop down list tags are used for access control by selecting a tag, you are relating this source to that tag tags are associated with certain roles (through the users & roles screen), and roles, in turn, are associated with users and user groups if you would like to create a new tag, see creating a tag docid\ ypm9tw81ap6nq8stkv4rd in the events configuration profile field, select from the dropdown list the profile that you would like to apply to this source by default, the default profile is applied events profiles consist of a series of rules that determine precisely how various types of events are logged and what results they trigger the source's location is used to represent it in the proper position in the map display (see maps docid\ sfzm6jvorvuigo7x0dnue ) by default, the location is determined automatically based on the source's ip if you would like to manually set the location of the source (optional), use the following procedure click on the edit icon next to the location field a search box is shown below the location field enter identifying info for the location (e g street address, zip code, coordinates) search results are displayed below the search box as you type click on the desired location the selected location populates the location field check the use private ip checkbox if the device with the onair pro app is on a vpn with a private ip address, and enter that ip address in the location field in the ingest cluster field, select from the drop down list one of the available ingest clusters as the destination for the source in the target broadcaster/s field, select your broadcaster preferences either select a specific broadcaster to be used or specify your preference for using primary vs backup broadcasters, options are prefer primary broadcasters, primary broadcasters only, backup broadcasters only or prefer backup broadcasters for managed clusters, it is not recommended to select a specific broadcaster, as the broadcaster’s availability may not remain stable enter a source password if you want to require a password to allow a stream to connect to the source in the public output field, if you would like to allow access to the stream directly through a supported player, select the allow checkbox if you selected the allow checkbox, then enter a password in the password field to authenticate access to the stream (optional) under content analysis select one of the following options full select this option if you would like to enable full content analysis (cqa), including analysis of the stream's audio and video content, including audio levels, audio silence detection, frozen video detection, and more tr101 only select this option to perform tr101 analysis only (without video and audio content analysis) the analysis can be used to check the integrity of the ts and the most important elements of the stream the analysis includes priority 1 and 2 to learn more about tr101 analysis see tr 101 290 technical report https //www etsi org/deliver/etsi tr/101200 101299/101290/01 03 01 60/tr 101290v010301p pdf none no content analysis is enabled it is generally recommended to enable full content analysis unless it is causing technical problems if content analysis is disabled, the system won't detect errors in the video and audio content of the stream and won't generate warnings for such events to prevent the source from being accidentally deleted, check deletion protection if you would like to disable auto pull, select the disable auto pul l checkbox disabling auto pull will lock channels using this source to the source's ingest cluster and targets to the source's current active broadcaster this setting only applies to pass through channels if auto pull is enabled , in the auto pull latency \[ms] field, specify the maximum latency for auto pull actions the broadcaster will update the latency as required, by using the maximal defined latency and then reducing the latency gradually (default 1000 ms) if pull was selected in step 7 and the source is using aes encryption, in the decryption key field, enter the static key that was used for encryption in the webrtc playback section, select the desired playback method webrtc enables you to monitor the stream via web browsers and mobile applications with real time communication (rtc) webrtc needs to be activated independently for each source in zen master (by default it is disabled) select one of the following options disabled users will not be able to view this source using webrtc (default) pass through passes the stream through to webrtc without transcoding this option can only be used if the input stream is already in a webrtc compliant format (video h 264 codec with baseline or main profile and no b frames, audio opus codec) auto zen master automatically transcodes the stream using the optimal profile for each specific user in this option zixi broadcaster will decode the video, transforming it into raw frames, which will be passed to the webrtc library, where it will be re encoded for each individual user best quality however, if monitored by multiple users this can consume extensive resources 1080p/720p/480p/360p zen master transcodes the stream to a webrtc compliant profile with the specified resolution the transcoding is done by zixi broadcaster's transcoder this method requires a zixi broadcaster with x264 or nvidia for transcoding this method allows many users to monitor the stream without encoding separately for each individual user, which saves cpu capacity since there is only one stream version, it is recommended to encode to a low resolution and low bitrate so that the stream will be viewable by all users monitoring the stream in the initial state section, select the disabled checkbox if you would like to disable this source upon initial configuration select the muted checkbox if you would like to disable error/recovery notifications for this source upon initial configuration you can enable/unmute the source at any time if you would like to adjust the advanced settings, click advanced the advanced settings fields are displayed if you would like to track usage for this source, enter your billing code details see billing codes docid\ lalxj n928tegcpdpbirj note that billing codes are not supported for push sources until broadcaster v19+ if you would like to track auto pull usage separately, enter you auto pull billing code details for either or both billing codes, click the validate billing code button to verify that the code is valid traffic shaping is a network management technique used to control and optimize the flow of data check the box to enable it (this setting will be ignored for broadcasters earlier than v18 2) in the auto pull mtu field, specify the maximum transmission unit (largest data packet that a network connected device will accept) in bytes for the auto pull to set the detection of frozen video, in the frozen video minimal duration field, specify the default minimal duration in seconds of frozen video after which the broadcaster will trigger a frozen video alert default 10 seconds this setting is supported for broadcaster version 16 3 and higher to set the detection of blank video, in the blank video minimal duration field, specify the default minimal duration in seconds of blank video after which the broadcaster will trigger a blank video alert default 10 seconds this setting is supported for broadcaster version 16 3 and higher the ignore monitoring pids field prevents zen master from issuing alerts for empty audio streams if you wish to enable this, enter a comma delimited list of pid numbers that should not be monitored for null content click save emailing source details to be used on the device in the top right “kebab” icon, select config enter an email address to send the source configuration to your apple device click outside the input area and click send close the configuration window see zixi on air pro quick start docid\ ikourgntrfnzrllqiyqur for instructions on how to use the configuration information in the email in the on air pro app zixi broadcaster source configuration parameters table parameter description info name specify a name for the zixi source in zen master tags select one or more of the predefined tags from the drop down list tags are used for access control by selecting an tag, you are relating this source to that tag tags are associated with certain roles (through the users & roles screen), and roles, in turn, are associated with users and user groups if you would like to create a new tag, see creating a tag docid\ ypm9tw81ap6nq8stkv4rd events configuration profile select from the dropdown list the profile that you would like to apply to this source by default, the default profile is applied note events profiles consist of a series of rules that determine precisely how various types of events are logged and what results they trigger location (optional) the source's location is used to represent it in the proper position in the map display (see maps docid\ sfzm6jvorvuigo7x0dnue ) by default, the location is determined automatically based on the source's ip enter identifying info for the location (e g street address, zip code, coordinates) and select the desired location from the suggestions that are shown input mode to create a zixi broadcaster source, select the mode used for sending the source for onair, choose push application to create an onair source , select the onair radio button configuration ingest cluster select from the drop down list one of the available ingest clusters as the destination for the source target broadcaster/s specify which broadcaster/s within the cluster on which zen master can deploy the source either select a specific broadcaster to be used or specify your preference for using primary vs backup broadcasters options are prefer primary broadcasters, primary broadcasters only , backup broadcasters only or prefer backup broadcasters note for managed clusters, it is not recommended to select a specific broadcaster, as the broadcaster’s availability may not remain stable public output if you would like to allow access to the stream directly through a supported player, select the allow checkbox password (optional for public output) if you selected allow in the public output field, specify a password in this field to authenticate access to the stream content analysis select one of the following options full select this option if you would like to enable full content analysis (cqa), including analysis of the stream's audio and video content, including audio levels, audio silence detection, frozen video detection, and more tr101 only select this option to perform tr101 analysis only (without video and audio content analysis) the analysis can be used to check the integrity of the ts and the most important elements of the stream the analysis includes priority 1 and 2 to learn more about tr101 analysis see tr 101 290 technical report none no content analysis is enabled note it is generally recommended to enable full content analysis unless it is causing technical problems if content analysis is disabled, the system won't detect errors in the video and audio content of the stream and won't generate warnings for such events hide thumbnail select this option to hide the source's thumbnail from where it is displayed (e g , the preview pane, grids, etc ) disable auto pull if you would like to disable auto pull, select this checkbox note disabling auto pull will lock channels using this source to the source's ingest cluster and targets to the source's current active broadcaster this setting only applies to pass through channels auto pull latency \[ms] specify the maximum latency for auto pull actions the broadcaster will update the latency as required, by using the maximal defined latency and then reducing the latency gradually (default 1000 ms) webrtc playback select the desired playback method note webrtc enables you to monitor the stream via web browsers and mobile applications with real time communication (rtc) webrtc needs to be activated independently for each source in zen master (by default it is disabled) select one of the following options disabled users will not be able to view this source using webrtc (default) pass through passes the stream through to webrtc without transcoding this option can only be used if the input stream is already in a webrtc compliant format (video h 264 codec with baseline or main profile and no b frames, audio opus codec) auto zen master automatically transcodes the stream using the optimal profile for each specific user in this option zixi broadcaster will decode the video, transforming it into raw frames, which will be passed to the webrtc library, where it will be re encoded for each individual user note best quality however, if monitored by multiple users this can consume extensive resources 1080p/720p/480p/360p zen master transcodes the stream to a webrtc compliant profile with the specified resolution the transcoding is done by zixi broadcaster's transcoder note this method requires a zixi broadcaster with x264 or nvidia for transcoding this method allows many users to monitor the stream without encoding separately for each individual user, which saves cpu capacity since there is only one stream resolution, it is recommended to encode to a low resolution and low bitrate so that the stream will be viewable by all users monitoring the stream initial state disabled select this checkbox if you would like to disable this source upon initial configuration muted select this checkbox if you would like to disable error/recover notifications for this source upon initial configuration advanced billing codes if you would like to track usage for this source, enter your billing code details, see billing codes docid\ lalxj n928tegcpdpbirj (supported for broadcasters v14 8+) note that billing codes are not supported for push sources until broadcaster v19+ billing password enter the password that corresponds to this billing code auto pull billing code if you would like to track usage for this source when using auto pull connections, enter the billing code that corresponds to this stream the relevant billing can be obtained from the organization that received the billing code from zixi auto pull billing password enter the password that corresponds to this auto pull billing code mtu/auto pull mtu {bytes} specify the maximum transmission unit (largest data packet that a network connected device will accept) in bytes for the auto pull (for pull sources only ) frozen video minimal duration {seconds} specify the default minimal duration in seconds of frozen video after which the broadcaster will trigger a frozen video alert default 10 seconds this setting is supported for broadcaster version 16 3 and higher for existing sources, you may need to restart the source blank video minimal duration {seconds} specify the default minimal duration in seconds of blank video after which the broadcaster will trigger a blank video alert default 10 seconds this setting is supported for broadcaster version 16 3 and higher for existing sources, you may need to restart the source ignore monitoring pids ignore pids with empty audio streams to prevent false warnings enter a comma delimited list of pid numbers that should not be monitored for null content