Add and manage stream targets

Contents


About stream targets
Add a Wowza CDN target for HDS/HLS playback
Add a Wowza CDN target for HLS playback
Add a custom target
Add a Facebook Live target
View target details
Edit a target's setup
Edit an HLS stream target's properties
Configure geo-blocking for a Wowza CDN target
Configure token authorization for a Wowza CDN target
Copy a custom target
Delete a target

About stream targets


A stream target is a destination for a stream. Stream targets can be Wowza Streaming Cloud™ edge resources or custom, external destinations. Stream targets let you create more flexible, scalable streaming workflows. For example, you can use Wowza Streaming Cloud to transcode source video into adaptive bitrate output renditions, and then have an external CDN such as Limelight Networks deliver the stream rather than have Wowza Streaming Cloud deliver the content to viewers. Or, send source video from your encoder directly to a Wowza CDN target, bypassing the Wowza Streaming Cloud transcoder but using the Wowza CDN target to deliver the content. Or, broadcast a stream to Facebook with a Facebook Live target.

Note: You can add up to 10 stream targets in a three-hour period.

Add a Wowza CDN target for HDS/HLS playback


A Wowza CDN target for HDS/HLS playback receives the stream over RTMP at a Wowza CDN resource and makes it available for playback over Adobe HDS and Apple HLS. This type of target offers higher latency than a Wowza CDN HLS target but the broadest compatibility with players and devices.

  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. Click Add Target, select Wowza CDN - HDS/HLS, and then click Add.
  3. Specify the following:
  • Target Name – The Target Name is required but doesn't have to be unique, and it can't be longer than 255 characters.
  • Target Location – The geographic region where you're capturing the video that Wowza Streaming Cloud will transcode and deliver.
Note: The Target Location can't be changed after the target is created.
  1. Click Add.

Wowza Streaming Cloud generates a target and displays the target detail page, which shows the target's Adobe HDS Playback URL and Apple HLS Playback URL.

Add a Wowza CDN target for HLS playback


A Wowza CDN target for HLS playback receives and delivers the stream through a Wowza CDN resource over Apple HLS. This type of target has lower latency than a Wowza CDN HDS/HLS target and allows playback over iOS, Android, smart TVs, and HTML5-based players.

  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. Click Add Target, select Wowza CDN - HLS, and then click Add.
  3. Specify the Target Name.

The Target Name is required but doesn't have to be unique, and it can't be longer than 255 characters.

  1. (Optional) Select Yes, ingest the stream securely to send the stream securely from the Wowza Streaming Cloud transcoder to the Wowza CDN target. If selected, Wowza Streaming Cloud generates a key that secures the stream between the transcoder and the target
  2. (Optional) To send the stream to a grid-delivery provider, select Yes, enable CORS (cross origin resource sharing). CORS streams are compatible with providers such as Peer5, Viblast, and Streamroot, which implement a decentralized, peer-to-peer transport layer to manage and optimize globally distributed, high-capacity streaming. You can't change the CORS delivery option after the target is created. Viewer data in Wowza Streaming Cloud doesn't reflect viewership at grid-delivery destinations.

Wowza Streaming Cloud generates a target and displays the target detail page, which shows the target's Apple HLS Playback URL.

Add a custom target


Wowza Streaming Cloud can use the RTMP protocol to deliver streams to custom targets. The custom target can be a third-party CDN such as Akamai or Limelight Networks, or any RTMP destination or host, such as YouTube.

Note:  Look for the information you need to create a custom target in the ingestion settings provided by the target's software or documentation.
  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. Click Add Target, select Custom, and then click Add.
  3. On the Create a custom target page, specify the following:
  • Target Name – A short, descriptive identifier for the target that differentiates it from other targets in Wowza Streaming Cloud. A Target Name is required, doesn't have to be unique, and can't exceed 255 characters.
  • Provider – If the third-party CDN that you're using is listed, choose it from the pop-up menu. Otherwise, choose RTMP.
  • Primary URL – The RTMP address, without the preceding protocol and without a trailing slash (/), that the target uses to ingest a stream. For example, [target-domain-or-ip-address]/[EntryPoint]. For help determining the correct RTMP URL, see the destination's help or user guide.
  • Backup URL – (Optional) The backup RTMP address, without the preceding protocol and without a trailing slash (/), that the target uses to ingest a stream.
  • Stream Name – The name of the stream as defined in your target's ingestion settings.
Note:  When adding a custom Akamai target, the Stream Name must be in the format [stream_name]_[angle]_[bitrate]@[stream_id], for example, akamaistream_1_[bitrate]@12345. For help determining the Stream Name for other custom target providers, see the provider's documentation.
  • Target Username – Your username for RTMP authentication by the target.
  • Target Password – Your password for RTMP authentication by the target.
  • Adobe HDS Playback URL – (Optional) The web address that your target uses to playback Adobe HDS streams. You can include it here for informational purposes.
  • Apple HLS Playback URL – (Optional) The web address that your target uses to playback Apple HLS streams. You can include it here for informational purposes.
  • RTMP Playback URL – (Optional) The web address that your target uses to play RTMP streams. You can include it here for informational purposes.
  1. Click Add.
    Wowza Streaming Cloud generates the target and displays the target detail page, which shows all of the specified playback URLs.

Add a Facebook Live target


Wowza Streaming Cloud can send streams to Facebook to be broadcast with the Facebook Live Video publishing tool.

  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. Click Add Target, select Facebook Live, and then click Add.
  3. On the Create a Facebook Live target page, specify the following:
  • Target Name – A short, descriptive identifier for the target that differentiates it from other targets in Wowza Streaming Cloud. A Target Name is required, doesn't have to be unique, and can't exceed 255 characters.
  • Video Destination – The location where you want to post the stream on Facebook. Choose your Timeline, a Page you manage, a group you belong to, or an event that you're hosting.
Notes:
  • The Video Destination can't be changed after the target is created.
  • You must have the appropriate permission on Facebook to post to a Page, group, or event. If the destination you want isn't in the menu, check the permissions for your Facebook account and Wowza Streaming Cloud app.
  • Title – A title to appear with the stream on Facebook. It must be a UTF-8 string and can be up to 255 characters. Emojis are not supported.
  • Description – A description to appear with the stream on Facebook. It must be a UTF-8 string. Emojis are not supported.
  • Privacy – If you're streaming to a Timeline, you can specify the Facebook privacy setting that determines who can watch your stream on Facebook: just you (Only me), Friends, Friends of Friends, or all Facebook users (Public).
  • Stream continuously to Facebook – Enables Facebook's continuous live video streaming mode. Select Stream continuously to Facebook if your broadcast will be longer than 90 minutes.
  • Stream 360 – Allows you to deliver a stream captured with a 360-degree camera system that adds Facebook's 360 metadata to the video file.
  1. Click Add.

Wowza Streaming Cloud generates the target and displays the target detail page, which includes details about when the target expires.

Most Facebook Live targets expire 60 days from when you authorized your Facebook account to connect to the target. If the target has expired or become invalid, renew it by editing the target and saving your changes.

View target details


  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. Select a target in the Stream Targets panel.
Note: Targets that were created through the live stream workflow appear in the Stream Targets panel as [Live stream name] / Stream Target.
  • The Setup tab of all target detail pages displays the details you need to configure Wowza Streaming Cloud to connect to the target and to play the stream from the target. The details that appear depend on the type of target you're viewing.

A Connection Code appears if the target uses a video source, such as Wowza Streaming Engine, that's passing a stream or group of transcoded, adaptive bitrate streams through Wowza Streaming Cloud to the target. The Connection Code can be used by the encoder when you configure it to send the video source to Wowza Streaming Cloud.

Facebook Live stream targets display a target expiration date. Most Facebook Live targets expire 60 days from when you authorized your Facebook account to connect to the target.

If the target expires or becomes invalid, renew it by editing the target and saving your changes.

Transcoders Using This Target indicates which transcoders are configured to use this target. If the transcoder was created through the live stream workflow, (Live Stream) appears after the transcoder name. Click a transcoder name to view or edit it. To add a transcoder or change which transcoders use this target, add or edit a transcoder. See the user guide topic Add a transcoder or Edit a transcoder's settings, outputs, or targets.

Edit a target's setup


  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. Select a target in the Stream Targets panel, and then click Edit.
  3. On the Setup tab, click Edit.
  4. Depending on the type of target you selected, do the following:
  • Wowza CDN – HDS/HLS target – Change the Target Name.
  • Wowza CDN – HLS – Change the Target Name.
  • Custom stream target – Change the Target Name, Provider, Primary URL, Backup URL, or other options.
  • Facebook Live stream target – Change the Target Name, Title, Description, or Privacy option.
  1. Click Save.

Edit an HLS stream target's properties


Wowza Streaming Cloud provides advanced properties that you can use to customize and optimize Apple HLS stream targets. The properties can be set for Wowza CDN HLS stream targets and for custom stream targets whose Provider is Akamai HLS Push. There aren't any advanced properties for Adobe HDS, Adobe HDS / Apple HLS, or RTMP stream targets.

  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. Select an Apple HLS stream target in the Stream Targets panel.
  3. Click the Properties tab and then click Edit.
  4. Select Enabled for any property and then specify the value you want to use for it.
  • HLS segment duration – Reduces the duration of the time-based audio and video chunks that Wowza Streaming Cloud delivers to the target. The HLS segment duration can be 2, 4, 6, 8, or 10 seconds. The default is 10 seconds. A lower (shorter) duration can reduce latency but may affect playback on some older devices.
Caution: For most HLS stream targets, the segment duration doesn't need to be enabled or changed. Edit it only if viewers experience unacceptably long latency.
  • Send stream to target over SSL – Determines whether Wowza Streaming Cloud sends the stream from the transcoder to the target by using SSL (HTTPS). By default, Send stream to target over SSL is False and the stream is sent over HTTP.
  • Play over SSL – If True, Wowza Streaming Cloud sends the stream from the target to the player using SSL. By default, Play over SSL is disabled and Relative playlists are used instead. If enabled, Play over SSL overrides the Relative playlists option and players must play the stream over HTTPS.
  • Relative playlists – Determines whether a stream's playlist contains relative or absolute paths. Relative paths allow the viewer to play the stream over HTTP or HTTPS, whichever way their browser connects to the stream target. The default, True, means that relative playlists are enabled.
  1. Click Save.

Configure geo-blocking for a Wowza CDN target


Wowza Streaming Cloud allows you to restrict where Wowza CDN targets can be accessed so that you can control where your stream can be watched. By default, geo-blocking is disabled — your stream can be viewed anywhere and everywhere. When you add a Wowza CDN target, Wowza Streaming Cloud automatically creates a Geo-blocking tab of the target's detail page where you can see and configure geo-blocking settings.

  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. In the Stream Targets panel, select a Wowza CDN target.
  3. Click the Geo-blocking tab of the target's detail page and then click Edit.
  4. Specify the type of geo-blocking you'd like to enable:
  • Allow streaming only to the following locations – Permits streaming only at specified locations.
  • Do not allow streaming to the following locations – Prohibits streaming at specified locations.
  1. Specify affected Locations:
  • Click a location in the left list box to select it, and then click the right-pointing arrow to add it to the list of affected locations on the right.
  • Click a location in the right list box to select it, and then click the left-pointing arrow to remove it from the list of affected locations.
  1. (Optional) To allow streaming at IP addresses even if they're within a geo-blocked location, enter one or more IP addresses in the Geo-blocking Override Whitelist field. Separate addresses using commas; don't include any spaces. The Geo-blocking Override Whitelist field supports Classless Inter-Domain Routing (CIDR) notation for defining subnet masks.
  2. Click Save.
Note: You can block or whitelist a total of 30 locations and IP addresses, in any combination.

Configure token authorization for a Wowza CDN target


Wowza Streaming Cloud can secure Wowza CDN targets with token authorization. Token authorization protects streams by ensuring that they are accessed only by viewers who have the token. It prevents playback URLs from being shared by unauthorized links or player hijacking attacks.

Token authorization is disabled by default. To use it, enable it and create a trusted shared secret, sometimes called a secret key or a password, to share with Wowza Streaming Cloud. Then, generate temporary query parameters to test the authorization.

  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. In the Stream Targets panel, select a Wowza CDN target.
  3. Click the Authorization tab of the target's detail page and then click Edit.
  4. Select Enabled.
  5. Enter a Trusted Shared Secret or click Generate Random Password.

Trusted shared secrets must be composed of hexadecimal characters (the digits 0 through 9 and/or the letters a through f). The length of the secret must be an even number of characters between 2 and 32.

  1. Click Save.

After authorization is enabled, generate sample query parameters to test it.

  1. On the Authorization tab of the stream target detail page, click Generate Query Parameters.

Wowza Streaming Cloud generates a string of parameters that temporarily grant access to the protected stream target's playback URLs. The parameters are active for 10 minutes.

Copy a custom target


  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. Select a custom target in the Stream Targets panel.
  3. Click Copy, and then click OK in the confirmation dialog.

Delete a target


You can only delete a target that isn't associated with a transcoder or a live stream.

  1. Click Advanced on the menu bar, and then click Stream Targets.
  2. Select a target in the Stream Targets panel.
  3. Click Delete Target, and then click OK in the confirmation dialog.