• How to connect the Wowza GoCoder encoding app to Wowza Streaming Engine

    Wowza GoCoder™ is an RTSP-based mobile live stream encoding app for Apple iOS and Android devices. If you're running Wowza Streaming Engine™ Manager on one of these devices that has the GoCoder app, you can automatically configure the app with live application connection settings to publish a stream from Wowza GoCoder to a live application in a Wowza Streaming Engine media server. If you're running Streaming Engine Manager on the local server computer or on a remote computer, you can send the connection settings for a live application to an email app on the device and launch GoCoder with the prescribed settings by clicking the URL in the email message.

    Contents


    Authenticating the live source connection
    Connecting the Wowza GoCoder encoding app
    Verifying the connection
    Playing the stream

    Authenticating the live source connection


    By default, Wowza Streaming Engine requires that RTMP-based and RTSP-based encoders provide a source user name and password before they can connect to live applications and publish a live stream. This section describes how to create a source account and manage source authentication for the Wowza GoCoder app in Wowza Streaming Engine Manager.

    Creating source accounts

    A source account is used to authenticate incoming connections from encoders and cameras to live applications in Wowza Streaming Engine. You can create and store multiple source accounts for the Streaming Engine instance. For information about how to manage authentication settings for source connections to live applications, see Managing source authentication settings.

    To create a source account


    1. In the Server contents panel, click Source Authentication, and then click Add Source.



    2. Add Source User Name and Password information, and then click Add. The source name and password values are case-sensitive and can only contain alphanumeric, period (.), underscore (_), and hyphen (-) characters.

    Managing source authentication settings

    By default, Wowza Streaming Engine requires that RTMP-based and RTSP-based sources provide a source user name and password for a source account to secure the connection to live applications. This section describes how to manage the source security settings for the RTSP-based Wowza GoCoder encoding app.

    To manage source security settings


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



    2. In the Source Security page, under RTSP Sources, configure security options to manage connections from RTSP-based sources, and then click Save.



      • The Require password authentication option is selected by default for each source type. To use this option, you must create a source account on the Source Authentication page in Streaming Engine Manager to require that sources supply a matching source user name and password for the source account to connect to the live application.

      • The Open option enables sources to connect to the live application without providing a source user name and password.

      • The Publishing not allowed option blocks all connection attempts from sources to the live application.

    Connecting the Wowza GoCoder encoding app


    The Sources (live) page for live applications in Wowza Streaming Engine Manager enables you to configure and deliver connection settings for the application to Wowza GoCoder. The GoCoder app can then load the live application connection settings in order to connect to the application automatically.

    If you're running Wowza Streaming Engine Manager on an Apple iOS or Android mobile device that has the GoCoder app, you can automatically configure the app with the live application connection settings to publish a stream from Wowza GoCoder to a live application. If you're running Streaming Engine Manager on the local server computer or on a remote computer, you can send the connection settings for a live application to an email app on the device and launch GoCoder with the prescribed settings by clicking the URL in the email message.

    Note: These methods overwrite existing connection settings in the GoCoder configuration.

    To configure the Wowza GoCoder encoding app


    1. In the live application contents panel, click Sources (live).



    2. In the Sources (live) page, click Wowza GoCoder.



    3. If necessary, adjust the application connection settings for the live application from their default values.



      • The Server IP Address and Port values are the default streaming host port settings (IP address and port) for the virtual host (VHost). By default, Wowza Streaming Engine uses TCP port 1935 for all forms of streaming. To change streaming host port settings for the VHost, go to the Virtual Host Setup page in the manager.

      • The Stream Name is the name of the incoming live stream and defaults to myStream automatically. Change this value if desired.

      • In Source User Name, select the name of a source account. If the live application requires that incoming RTSP connections be authenticated with a password (the default setting), the GoCoder settings will use the source user name and password for this account to connect. If the live application doesn't require that incoming RTSP connections be authenticated, the selected source account isn't used. For more information about how to manage secure source connections, see Managing source authentication settings.

    4. Configure the GoCoder app with the application connection settings by using one of the following options:

      • If you configured the application connection settings on your device that has Wowza GoCoder installed, click the the Auto-configure GoCoder button for your device (click Auto-configure GoCoder for iOS on your Apple iOS device or Auto-configure GoCoder for Android on your Android device).



        -OR-

      • If you're using the manager on the local server computer or on a remote computer, send the connection information to an email app on your device.



        Open the email message on your device and click the URL in the message to launch GoCoder with the application connection settings. For details about the URL parameters, see URL configuration method.

        Notes:
        • The built-in Gmail client for Android doesn't support the email configuration method. You must use a different email client if you send the URL in an email message.

        • For security reasons, the Source Authentication information isn't included in the email message. You must still manually enter this information in your GoCoder Login settings.
    5. Tap the Encode button to automatically connect to the live application in Wowza Streaming Engine.

    6. Verify that the stream is published.

    Verifying the connection


    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.




    The information page for the stream displays the uptime, network throughput, and other information about the published stream.



    Playing the stream


    To play the stream, click Test Players in the upper-right corner of the information page. The Test Players window that opens includes test players that are preconfigured to stream a live stream named myStream in various streaming formats. Each tab in the Test Players window either hosts a test player that you can use to play the live stream or provides instructions for playing the live stream. For example, to use the Adobe HDS protocol to play myStream, click the Adobe HDS tab, and then click Start.



    The test players are also online on our Wowza Test Players webpage.

    Example players

    You can also use example players that are included with Wowza media server software or downloaded from the Wowza website to play the stream. For more information, see the following articles:



    Originally Published: 09-11-2014.
    Updated: For Wowza Streaming Engine 4.2 on 06-22-2015

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