Live sources and stream targets

Each incoming live stream received by q.air is referred to as a live source. Live sources are used by multiple q.air applications, e.g. to preview incoming streams or to schedule them in a rundown. Each playout output signal can also be routed internally and used again as a live source. Every live source is defined by a set of configuration properties (metadata), like e.g. the used protocol, the URL used to receive the stream or (if required) stream credentials. These configuration properties can e.g. be used to set up an external device or software that provides an incoming source stream to q.air.

The target for each outgoing live stream is referred to as a stream target. Similar to a live source each stream target is defined by a set of configuration properties (metadata), like e.g. the used protocol, the target URL or (if required) stream credentials. Stream targets can be used by multiple q.air applications, e.g. to schedule them in a rundown and defining which parts of the scheduled program should be streamed to downstream service providers or video platforms.

To manage, preview, monitor and route incoming and outgoing live streams (and in addition to the streaming capabilities described in section Streaming), q.air includes the q.air Stream Control application.

Accessing q.air Stream Control

  1. Open and sign in to the qibb go! Portal.

    The welcome screen is displayed.

  2. Depending on if you want to manage live sources or stream targets, click on the related actions App links icon in the corresponding tile:

    1. To manage live sources select Ingest related actions > Manage your live sources.

    2. To manage stream targets select Automation related actions > Manage your stream targets.

    The Stream Control user interface is opened in a new browser tab.

Manage live sources

Using the live sources overview

To access the live sources overview, in the navigation sidebar on the left select Live Sources > Overview.

The live sources overview is displayed.

Live source overview

Figure: Live source overview

In the Live Sources area all currently available live sources are listed with basic information (e.g. name, protocol, status, uptime, live bitrate and alerts). You can customize the columns to be displayed and manually trigger a list update, by using the corresponding buttons above the list.

To display only specific live sources, use the Filter area above the list. There you can e.g. search live sources by name, by status flags (connected, verified, etc.) or by protocol (RTMP, SRT, etc.).

Creating a live source

To create a live source, proceed as follows:

  1. In the navigation sidebar on the left select Live Sources > Overview.

  2. In the upper right, click Create Live Source.

    The Create A Live Source dialog is displayed.

  3. Enter a name for the live source and select the protocol to be used.

    Notice

    The name of the live source has to be unique.

    Create live source

    Figure: Create live source

  4. (Optional) Depending on the selected protocol, additional configuration properties may be displayed. Set the values as required.

    Notice

    If you select e.g. protocol RTMP the additional property On connect Authenticate is available. If you enable it the URL of the created live source (which has to be used to provide the source stream to q.air) will include user name and password for authentication.

  5. Click Confirm.

    The live source is created and added to the live sources list. It is also available in q.air Traffic as primary event and can be added to shows. In q.air Automation it is available under Media > Live, can be previewed and added to a rundown.

Notice

You can now configure your device/software/encoder that provides the actual source stream by using the configuration properties of the live source you created. To do this, select the newly created live source, copy the values of the corresponding configuration properties to the clipboard and paste them into your device/software settings. Afterwards start the stream. If everything is configured properly and the incoming stream is received correctly, the live source status changes from red (disconnected) to green (connected) and the preview can be started.

Previewing a live source

To preview a live source, proceed as follows:

  1. In the navigation sidebar on the left select Live Sources > Overview.

  2. In the live sources list click the name of the live source to be previewed.

    A preview player and detailed information about the live source are displayed at the top of the page.

  3. In the preview player click the Play icon.

    The preview starts.

    Live source preview

    Figure: Live source preview

  4. Use the player controls to e.g. trigger pause, play or fullscreen view.

Editing a live source

Notice

You can only edit the name of a live source. All other settings cannot be changed as they are automatically generated.

To edit a live source, proceed as follows:

  1. In the navigation sidebar on the left select Live Sources > Overview.

  2. In the live sources list click the name of the live source to be edited.

    A preview player and detailed information about the live source are displayed at the top of the page.

  3. Edit the name of the live source.

  4. Click Save.

    The changed live source configuration is saved.

Deleting a live source

To delete a live source, proceed as follows:

  1. In the navigation sidebar on the left select Live Sources > Overview.

  2. In the live sources list in the Action column activate the checkbox of the live source to be deleted.

  3. Click the Delete selected live source icon above the live sources list.

  4. Confirm the displayed dialog by clicking Confirm.

    The live source is deleted and removed from the live source list.

Manage stream targets

Using the stream targets overview

To access the stream target overview, in the navigation sidebar on the left select Stream Targets > Overview.

The stream target overview is displayed.

Stream target overview

Figure: Stream target overview

In the Stream Targets area all currently available stream targets and jobs are listed with basic information (e.g. name, type, source and status). You can customize the columns to be displayed and manually trigger a list update, by using the corresponding buttons above the list.

To display only specific stream targets, use the Filter area above the list. There you can e.g. search stream targets by name, by type (YouTube, Generic, etc.) or active status.

You can display and edit the details of each stream target, by clicking on the corresponding stream target name.

Creating a static routing stream target

A static routing stream target enables you to permanently stream any live source to any valid target, without having to schedule it in a rundown.

To create a static routing stream target, proceed as follows:

  1. In the navigation sidebar on the left select Stream Targets > Static Routing.

  2. In the upper right, click Add.

    The Create A Stream Target dialog is displayed.

  3. Select the protocol to be used.

    Depending on the selected protocol, different configuration properties are displayed.

  4. Set all configuration properties as required.

    Static routing stream target properties

    Figure: Static routing stream target properties

  5. Click Confirm.

    The static routing stream target is created and added to the stream targets list with status inactive (red).

    Static routing stream target created

    Figure: Static routing stream target created

  6. Select the live source to be used via the Source dropdown menu.

    If the source stream is valid and running, preview playback starts automatically.

  7. Right next to Source click the Save source stream icon.

    The source of the static routing stream target is saved. If source and target are valid and the stream is running the status changes to active (green).

    Active static routing stream target

    Figure: Active static routing stream target

    Notice

    To preview the live source, in the preview player click the Play icon and use the player controls to e.g. trigger a fullscreen preview.

Editing a static routing stream target

To edit a static routing stream target, proceed as follows:

  1. In the navigation sidebar on the left select Stream Targets > Static Routing.

  2. Look for the target to be edited and in the bottom left of the corresponding tile click the View and edit metadata icon.

    Open static routing stream target settings

    Figure: Open static routing stream target settings

    The target settings are displayed.

  3. Change the settings as required.

    Update static routing stream target settings

    Figure: Update static routing stream target settings

  4. Confirm your changes, by clicking Update.

    The changed static routing stream target settings are saved.

Editing a social media or generic stream job

In the following a YouTube stream job is used as example for managing stream jobs. The same approach applies to generic stream jobs.

To edit a stream job, proceed as follows:

  1. To get an overview of all available YouTube stream jobs, in the navigation sidebar on the left select Stream Targets > Social Media.

  2. Look for the stream job to be edited and in the bottom left of the corresponding tile click the View and edit configuration data icon.

    Open stream job settings

    Figure: Open stream job settings

    The target settings are displayed.

  3. Change the settings as required.

    Update stream job settings

    Figure: Update stream job settings

  4. Confirm your changes, by clicking Update.

The stream job settings are updated.

Deleting a stream target

To delete a stream target, proceed as follows:

  1. In the navigation sidebar on the left select Stream Targets > Overview.

  2. In the stream targets list in the Action column activate the checkbox of the stream target to be deleted.

  3. Click the Delete selected stream target icon above the live sources list.

  4. Confirm the displayed dialog by clicking Confirm.

    The stream target is deleted and removed from the stream targets list.

Synchronizing stream targets between Wowza and q.air

Under certain conditions (e.g. because of special customer requirements regarding the stream format or certain stream properties) it may not be possible to create a stream target via the default mechanism provided by q.air Stream Control. In this case the corresponding stream target has to be created manually via the Wowza Manager UI. Afterwards it can be synchronized with q.air via Stream Control and can then be used like a "regular" stream target.

To synchronize stream targets, proceed as follows:

  1. In the navigation sidebar on the left select Stream Targets > Overview.

  2. In the upper right, click Sync.

    All stream targets that were created via the Wowza Manager UI and can be synchronized are listed.

  3. Select one or more stream targets to be synchronized.

    Synchronize stream targets

    Figure: Synchronize stream targets

  4. Click Confirm.

    The selected stream targets are synchronized with q.air and can afterwards be used like "regular" stream targets.


Last update: 2021-04-12