Axis network cameras have built-in network connectivity for capturing and publishing live video to Wowza Streaming Engine™ media server software. Wowza Streaming Engine creates Axis source settings in a .stream file, which provides a method to re-stream the output from the Axis network camera to players. This article describes how to create connection settings to automatically configure Axis network cameras.
Connecting Axis network cameras Verifying the connection
Accessing Pan/Tilt/Zoom (PTZ) controls Changing the reconnect wait time
Customizing the stream URI
Connecting Axis network cameras
Use the procedures in this section to set up the Axis source for a live application in Wowza Streaming Engine, and to set up your Axis camera to distribute video to the live application.
Set up the Axis live source
- In Wowza Streaming Engine Manager, click Applications at the top of the page.
- In the contents panel, under the live application, click Sources (Live).
- In the Sources (Live) page, click Axis.
- Enter a name for the stream in Stream Name.
- The name value can't contain less-than (<), greater-than (>), colon (:), quotation (' and "), forward slash (/), backslash (), pipe (|), question mark (?), asterisk (*), double-dot (..), and tilde (~) characters.
- The stream name is used to create a stream file that replaces (aliases) the Axis camera's complex stream URI so that players can use the stream file name in playback URLs in place of the camera's complex stream name. Stream files are stored in an application's streaming file directory and have a .stream file name extension. You must enter a stream name value that creates a unique stream file name.
- Enter the camera's IP address in Camera IP Address. If your camera requires RTSP streaming authentication, add credentials in the following format:
- If your Axis network camera has PTZ capabilities and requires authentication, select the Enter user credentials for PTZ-capable cameras check box, and then enter your camera's PTZ User Name and PTZ Password. These credentials may differ from the camera's RTSP streaming credentials and are used to access the camera's PTZ controls from this application's Incoming Streams page. You can also edit these credentials in the application's Stream Files page after a connection is created. For more information, see Accessing Pan/Tilt/Zoom (PTZ) controls.
- Click Create Connection to connect to the stream. If the camera is offline, the stream file will try to connect to it every 3 seconds until it can establish a connection. For more information about how to change the connection retry interval, see Changing the reconnect wait time.
- If you've already set up your Axis camera to distribute video to the application, verify that the stream is published.
Set up the Axis camera
Make sure you have the latest firmware for your camera installed. Refer to your Axis camera documentation for details about how to operate your camera and adjust settings.
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.
- Click Stream Files for the live application, and then click the .stream file that's re-streaming your Axis camera output.
- Click Test Players in the upper-right corner of the stream file page.
The Test Players window that opens includes test players that are preconfigured to stream a live stream named myStream.stream over various streaming protocols. 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 Adobe HDS to play myStream.stream, click the Adobe HDS tab, and then 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:
- Play streams with the Adobe RTMP example player in Wowza Streaming Engine
- Play streams with Adobe HDS example player in Wowza Streaming Engine
- Play streams with the Silverlight example player in Wowza Streaming Engine
- Play streams with the MPEG-DASH example player in Wowza Streaming Engine
- Play Wowza Streaming Engine streams on Apple iOS devices
- Play Wowza Streaming Engine streams on RTSP/RTP players
Accessing Pan/Tilt/Zoom (PTZ) controls
In Wowza Streaming Engine 4.2 (and later), you can control your camera's PTZ features from within Wowza Streaming Engine Manager by launching the Pan/Tilt/Zoom Controller from the Incoming Streams page.
To access PTZ controls in your camera:
- In Wowza Streaming Engine Manager, create a connection from your live application to your camera and then verify that you are connected to the camera's stream.
- If you didn't enter your camera security credentials when creating the connection, edit these settings on the Stream Files page. In the live application's Stream Files page, click the Edit icon for the stream file connecting to your Axis camera, ensure the correct user credentials are entered into PTZ User Name and PTZ Password, and then click Save.
- In the contents panel for your live application, click Incoming Streams, and then click the Pan Tilt Zoom icon for the stream connecting to your Axis camera. A dialog box appears with camera controls and a preview of the camera feed. The preview image is a static capture that will refresh frequently. For more information on changing this refresh rate, see Specify per-stream settings in Wowza Streaming Engine .stream files.
Note: Different camera models implement the PTZ features in different ways. If your camera doesn't respond to these controls, it may not be supported at this time.
- To pan and tilt the camera, use the four-way cursor buttons. To return the camera to its default position, click the Reset button in the center. To zoom the camera in and out, use the magnifying glass buttons.
- Click Close to return to the Incoming Streams page.
Changing Pan/Tilt/Zoom settingsYou can customize how Wowza Streaming Engine connects to your camera's PTZ controls and change values such as connection timeouts and the preview refresh rate.
To access PTZ settings:
- In Wowza Streaming Engine Manager, click the Applications tab, and then Stream Files under the name of your application (such as live) in the contents panel.
- Click the Edit icon for the stream file in the list that will re-stream your Axis camera output.
- In the stream file's Properties tab, click Pan/Tilt/Zoom in the Quick Links bar.
For more information on each PTZ property, see Specify per-stream settings in Wowza Streaming Engine .stream files.
Changing the reconnect wait time
If the Axis camera is offline, the live application will try to connect to it every 3 seconds by default until it establishes a connection. To change how often the live application will try to connect to the camera, do the following:
- Click Stream Files for the live application in Wowza Streaming Engine Manager, and then click the name of the stream file in the list that will re-stream your Axis camera output.
- Click the Properties tab.
- In the Common section of the properties page, click Edit.
- To change the default reconnectWaitTime property value, select the Enabled check box for the property, type an alternate value (in milliseconds) in the property box, and then click Save. The following example shows that the property value has been changed to 10000 milliseconds (10 seconds).
Customizing the stream URI
To properly ingest a stream from your Axis camera, you may need to manually change the stream URI's appended syntax to either match your specific camera model or specify the RTSP ports. You can also modify the stream URI to pass API query strings to dynamically modify the stream.
To customize the stream URI:
- Click Stream Files for the live application in Wowza Streaming Engine Manager, and then click the Edit (pencil) icon for the name of the stream file in the list that will re-stream your Axis camera output.
- In Stream URI, change the rtsp://[camera-ip-address]/[camera-syntax] value as needed, and then click Save. Check SoleraTec's Axis IP Camera RTSP URLs listing to make sure the [camera-syntax] is correct for your camera model. (for example, /video1 or /axis-media/media.amp).
Note: API query string parameters can be added to the end of your stream URI to enable a specific codec (if supported) or to set a pre-configured stream profile (containing a set of predefined stream settings). For example, the following stream URI can be used to enable H.264 and a stream profile named wowza:
See your Axis camera's documentation for more information on creating stream profiles and supported codecs as these features can differ depending on the camera model.
- Click Return to Stream Files.
- Click the Connect icon for myStream.stream, and then click OK in the Connect a Stream File dialog box.
If you experience problems, try the following: