• How to use Apple QuickTime Broadcaster with Wowza Media Server (RTSP/RTP)

    Step-by-step instructions for using QuickTime Broadcaster live encoder with a Wowza™ media server (Flash Player version 9.0.115.0 or greater is required).

    Media server configuration

    1. Download and install Wowza media server software.

    2. Create a new Wowza media server application for live streaming (may already exist if examples installed).

      1. Create the folder [install-dir]/applications/live.

      2. Create the folder [install-dir]/conf/live.

      3. Copy the [install-dir]/conf/Application.xml file to [install-dir]/conf/live.

      4. Edit the newly copied Application.xml file and make following changes:

        • Change <Streams>/<StreamType> to:
          <StreamType>live</StreamType>
        • Set the <HTTPStreamers> property to:
          <HTTPStreamers>cupertinostreaming,smoothstreaming,sanjosestreaming</HTTPStreamers>
        • Set the <Streams>/<LiveStreamPacketizers> property to:
          <LiveStreamPacketizers>cupertinostreamingpacketizer,smoothstreamingpacketizer,sanjosestreamingpacketizer</LiveStreamPacketizers>
        • (For RTSP/RTP playback) Set the <RTP>/<Authentication>/<PlayMethod> to:
          <PlayMethod>none</PlayMethod>
        • (For Smooth Streaming only) Add the following property to the application-level <Properties> container at the bottom of the Application.xml file (be sure to get the correct <Properties> container - there are several in the Application.xml file):
          <Property>
          	<Name>smoothStreamingMediaMajorVersion</Name>
          	<Value>2</Value>
          	<Type>Integer</Type>
          </Property>
        • Add following properties to the <Streams>/<Properties> container (there are several <Properties> containers, be sure to add to the correct container):
          <Property>
          	<Name>sortPackets</Name>
          	<Value>true</Value>
          	<Type>Boolean</Type>
          </Property>
          <Property>
          	<Name>sortBufferSize</Name>
          	<Value>750</Value>
          	<Type>Integer</Type>
          </Property>
      5. (For Smooth Streaming only) Use a text editor to create the file [install-dir]/conf/clientaccesspolicy.xml with the following content (for more information, see Network Security Access Restrictions in Silverlight):
        <?xml version="1.0" encoding="utf-8"?>
        <access-policy>
          <cross-domain-access>
            <policy>
              <allow-from http-request-headers="*">
                <domain uri="*"/>
              </allow-from>
              <grant-to>
                <resource path="/" include-subpaths="true"/>
              </grant-to>
            </policy>
          </cross-domain-access>
        </access-policy>
      6. Edit the [install-dir]/conf/publish.password file and add a user name and password. The following is an example of the password file with the user name myUser and password myPassword:
        # RTP password file (format [username][space][password])
        #username password
        myUser myPassword
      7. Start the Wowza media server.

    Encoder configuration

    1. Download and install QuickTime Broadcaster.

    2. Start QuickTime Broadcaster.

    3. On the Audio tab, set the Compressor dropdown to MPEG-4 Audio.

    4. On the Video tab, set the Compressor dropdown to H.264.

    5. On the Network tab, make the following changes:

      1. Change the Transmission dropdown to Automatic Unicast (Announce).

      2. Change Host Name to [wowza-ip-address]:1935 (where [wowza-ip-address] is the IP address of the Wowza media server).

      3. Change File to live/myStream.sdp. The format of this field as it relates to Wowza media server is [application]/[application-instance]/[stream] (if [application-instance] is omitted, it defaults to _definst_).

      4. Enter the Username and Password, added to the conf/publish.password file above, to the appropriate fields.

    6. To broadcast to the Wowza media server, click the Broadcast button.

    Playback

    To play using Adobe Flash Player


    Wowza Media Server 3.5 and later
    Double-click [install-dir]/examples/LiveVideoStreaming/FlashRTMPPlayer/player.html, enter the information below, and then click the Connect button.

    Wowza Media Server 3.1.2 and earlier
    Double-click [install-dir]/examples/LiveVideoStreaming/client/live.html, enter the information below, and then click the Play button.
    Server: rtmp://[wowza-address]/live
    Stream: myStream.sdp

    To play on an iOS device


    Enter the following URL into the Safari web browser:
    http://[wowza-ip-address]:1935/live/myStream.sdp/playlist.m3u8

    To play using Microsoft Silverlight


    Wowza Media Server 3.5 and later
    Double-click [install-dir]/examples/LiveVideoStreaming/SilverlightPlayer/player.html, enter the information below, and then click the Connect button.

    Wowza Media Server 3.1.2 and earlier
    Double-click [install-dir]/examples/LiveVideoStreaming/clientSilverlight/Default.html, enter the information below, and then click the Play button.
    http://[wowza-address]:1935/live/myStream.sdp/Manifest

    To play on an RTSP/RTP player or device


    Enter the following URL into the RTSP/RTP player:
    rtsp://[wowza-address]:1935/live/myStream.sdp
    Notes:
    • [install-dir]:
      Windows (default): C:\Program Files\Wowza Media Systems\Wowza Media Server [version]
      OS X: /Library/WowzaMediaServer
      Linux: /usr/local/WowzaMediaServer

    • The default frame rate and keyframe rate are quite low, which may cause slow startup times. A frame rate of greater than 15 and a keyframe rate of two times the frame rate will produce higher quality video.

    • By default, QuickTime Broadcaster streams use UDP on ports 6970 - 9999. This can be a problem if you are streaming to a Wowza media server that's behind a firewall that blocks these ports. To resolve this issue, you can either open the UDP port range 6970 - 9999 on your firewall or check the Broadcast over TCP box to interleave the media traffic on TCP port 1935 (which should already be open for the Wowza media server).

    • You might not be able to use QuickTime Broadcaster to stream to the iPhone/iPod touch. It only supports the H.264 Main profile, which is too high for the iPhone/iPod touch. The Baseline profile is required. iPhone 3GS and newer devices support Baseline profile. For encoding guidelines, see How to find Apple iOS device supported profile and level information.

    • If you have problems getting either the audio or video to play in Flash, check the Flash Player version number (Flash Player version 9.0.115.0 or above is required).

      If you still have problems, do the following:

      1. Turn on Wowza media server debug logging (open the [install-dir]/conf/log4j.properties file in a text editor and change the log4j.rootCategory on the first line from INFO to DEBUG).

      2. Try the encoder several more times, then place your [install-dir]/logs folder along with screenshots of the encoder setup screens and the LiveVideoStreaming player screen into a compressed (zipped) folder. (See How to create a compressed zip file in Windows, OS X, and Linux.)

      3. Submit a Wowza Streaming Engine Technical Support Ticket. (Technical support is included with all active monthly subscriptions and maintenance and support contracts.) In the support ticket form, be sure to provide a detailed description of the problem and attach the zipped folder that has your logs folder and screenshots.

    Originally Published:10-01-2010.

    If you're having problems or want to discuss this article, post in our forum.