Set up live streaming using an RTSP/RTP-based encoder in Wowza Streaming Engine

Configure Wowza Streaming Engine™ media server software to recieve an encoded live stream from an RTSP/RTP-based source and play the live stream over all supported streaming protocols.

Configure the live streaming application


Live streams are configured and managed in live applications in Wowza Streaming Engine. You can configure a live application in Wowza Streaming Engine Manager or by setting properties in the application's XML configuration file. Both methods produce the same result; editing Application.xml is the only option if you use Wowza Media Server™ software.

Configure the live application in Wowza Streaming Engine Manager

This example uses the default live application that installs with Wowza Streaming Engine.

You can use Wowza Streaming Engine Manager with the latest version of most web browsers that support HTML5 and Cascading Style Sheets level 3 (CSS 3). We recommend Google Chrome.

  1. In Wowza Streaming Engine Manager, click the Applications tab at the top of the page and then select the live application in the contents panel.

Start by enabling playback over all supported protocols: Adobe HDS, Adobe RTMP, Apple HLS, Microsoft Smooth Streaming, MPEG-DASH, and RTSP/RTP.

  1. On the Setup tab of the live application page, make sure all Playback Types are selected. If necessary, click Edit, select them all, and then click Save.


     

Note: Every time you edit an application's configuration, Wowza Streaming Engine prompts you to restart the application. However, you can wait until all changes are completed before you restart.

Next, disable playback authentication.

  1. In the contents panel, click Playback Security, and then click Edit.

     
  2. Under Client restrictions, select No client restrictions, and then click Save.


     
    Note: For more information about securing playback connections from live applications, see Playback security options.

Next, enable source authentication for the encoder.

  1. In the contents panel, click Source Security, and then click Edit.

  1. On the Source Security page, under RTSP Sources, select Require password authentication.
  2. Under Client Restrictions, select No client restrictions.

  3. Click Save and then restart the application.

    The application runs whenever Wowza Streaming Engine is running.
     
    Note: For more information about securing source connections to live applications, see Configure security using Wowza Streaming Engine Manager.

You're almost done. To finish, configure the source user name and password to publish to the application.

  1. Click Server in the menu bar, click Source Authentication in the contents panel, and then click Add Source.

  1. Enter a Source User Name and Password, and then click Add.

Configure the live application in XML

This section shows you how to configure the live application by editing the Application.xml configuration file in a text editor. If you configured the live application in Wowza Streaming Engine Manager, skip this section.

  1. Navigate to [install-dir]/conf/live and open Application.xml in a text editor.
     
  2. In the <Streams> container element, make sure the <StreamType> property is live. The XML looks like this:
    <Streams>
        ...
        <StreamType>live</StreamType>  
        ...
    </Streams>
    
  3. Set the <HTTPStreamers> property for all supported HTTP streaming protocols. The XML looks like this:
    <HTTPStreamers>cupertinostreaming,smoothstreaming,sanjosestreaming,mpegdashstreaming</HTTPStreamers>
  4. Set the <LiveStreamPacketizers> property for HDS, HLS, Microsoft Smooth Streaming, and MPEG-DASH streaming. The XML looks like this:
    <Streams>
        ...
        <LiveStreamPacketizers>cupertinostreamingpacketizer,smoothstreamingpacketizer,sanjosestreamingpacketizer,mpegdashstreamingpacketizer</LiveStreamPacketizers>
        ...
    </Streams>
    
  5. In the <RTP> container element, make sure playback authentication is disabled by setting the <PlayMethod> property to none. The XML looks like this:
    <RTP>
        <Authentication>
            ...
            <PlayMethod>none</PlayMethod>
        </Authentication>
        ...
    </RTP>
  6. Save your changes and close Application.xml.
  7. Navigate to [install-dir]/conf/ and open publish.password in a text editor.
  8. Add a source user name and password to control RTSP/RTP source access. Following is an example of the file with the source name publisherName and a password:
    # Publish password file (format [username][space][password])
    # username password
    publisherName [password]
  9. Save your changes and close publish.password.
  10. Restart Wowza Streaming Engine or Wowza Media Server.

Publish the source stream to Wowza Streaming Engine


In your encoder, enter the following application connection settings, and then click Publish or Start:

  • Server URL – rtsp://[wowza-ip-address]:1935/live
  • Stream Name – myStream
  • User – publisherName
  • password – [password]
Note: See the documentation for your source encoder for help configuring it.

To verify that the stream is published, click Incoming Streams for the live application in Wowza Streaming Engine Manager, and then click the stream name. Uptime, network throughput, and other information about the published stream appear on the page.

Test playback


In Wowza Streaming Engine Manager, click Test Players in the upper-right corner of the live application page.

Each tab in the Test Players window either hosts a test player that can play the live stream, or provides instructions for playing the live stream. The test players are preconfigured to stream the default live stream myStream.

For example, to test playback of the default stream myStream over Adobe HDS, make sure the encoder is sending a stream to the live application in Wowza Streaming Engine and that Adobe Flash is enabled in the browser you're using. Then, click the Adobe HDS tab and click Start.

You can also test your live stream by using the test players online on our Wowza Test Players webpage, or by using the example players that install with Wowza Streaming Engine at [install-dir]/examples/. For more information, see any of these articles:

Troubleshooting


RTSP/RTP

RTSP/RTP streaming is used to stream to Android and BlackBerry mobile devices. Android devices used to support Adobe Flash player, but don't any more. Newer Android devices support Apple HLS. HLS works best on Android 4.0 devices and above.

To stream to RTSP/RTP, be sure that UDP ports 0-65535 are open and mapped to the Wowza Streaming Engine server.

Note: To configure Wowza Streaming Engine for RTSP/RTP streaming, follow the instructions in Troubleshoot RTSP/RTP playback.

Force output to MPEG-TS for set-top boxes

When using RTSP/RTP to stream out content, you can force the output to MPEG-TS, which is required by many set-top boxes. For more information, see Generate and control MPEG-TS output for set-top boxes.

Change the AAC packetization method

Wowza Streaming Engine can use the mpeg4-generic or mp4a-latm (3gpp) packetization method to output AAC audio. The default packetization method is mpeg4-generic.

Configure mp4a-latm packetization using Wowza Streaming Engine Manager

  1. Click the Applications tab and then select your live application in the contents panel.
     
  2. On the live application page Properties tab, click Custom in the Quick Links bar or scroll to the bottom of the page.
     
    Note: Access to the Properties tab is limited to administrators with advanced permissions. For more information, see Manage credentials.
  3. In the Custom area, click Edit.
     
  4. Click Add Custom Property, specify the following settings in the Add Custom Property dialog box, and then click Add:
     
    • Path – Select /Root/Application/RTP.
       
    • Name – Enter audioPacketizerAAC.
       
    • Type – Select String.
       
    • Value – Enter com.wowza.wms.rtp.packetizer.RTPPacketizerMPEG4LATM.
  5. Click Save, and then restart the live application to apply the changes. 

Configure mp4a-latm packetization in XML

  1. Navigate to [install-dir]/conf/[application] and open Application.xml in a text editor.
  2. Add the audioPacketizerAAC property to the <RTP> container element. The XML looks like this:
    <RTP>
        ...
        <Properties>
            <Property>
                <Name>audioPacketizerAAC</Name>
                <Type>String</Type>
                <Value>com.wowza.wms.rtp.packetizer.RTPPacketizerMPEG4LATM</Value>
            </Property>
        </Properties>
    <RTP>
  3. Restart Wowza Streaming Engine or Wowza Media Server.

More resources