SetWebStreamer
Top  Previous  Next

Description

Configures parameters of the RTSP web streaming.

Syntax


[VB]
objActiveGige.SetWebStreamer srcAddress, dstAddress, frameRate, quality[, tunnelOverHttp]


[C/C++]
HRESULT SetDestinationIP(BSTR srcAddress, BSTR dstAddress, float frameRate, short quality, bool tunnelOverHttp);


Data Types
[VB]

dstAddress: String
srcAddress: String
frameRate: Float
quality: Integer
tunnelOverHttp: Boolean


Parameters
[C/C++]

srcAddress [in]  
String specifying the source address of the web streaming in the following format: "xxx.xxx.xxx.xxx[:pppp/filename]", where  
   xxx.xxx.xxx.xxx - the IP address of the local network interface to be used for the web streaming (typically a local area interface)  
   pppp - the local source port to be used for the web streaming; if omitted, port 8554 will be used  
   filename - the file name assigned to the stream; if omitted, "ActiveUsb.sdp" will be used  
 
dstAddress [in]  
String specifying the IP address of a remote playback device. For the multicast streaming, use an address in the range 239.0.0.0 - 239.255.255.255  

frameRate [in]  
Floating point value specifying the frame rate limit for the web stream.  
 
quality [in]  
Integer value in the range 0-6 specifying the H.264 compression quality. The higher the quality is, the higher the streaming bandwidth will be.  
 
tunnelOverHttp [in]  
Enabling this boolean value will reroute the web streaming via HTTP ports 80, 8000 or 8080  


Return Values

S_OK  
Success  
E_FAIL  
Failure.  

Example

This VB example sets the web streamer's parameters and activates the streaming. The port number is omitted in the source address, so the default port 8554 is used:

sourceAddr=
"192.168.0.5/test.sdp"

destAddr=
"192.168.0.10"

streamFPS=15
streamQuality=4
ActiveUSB1.SetWebStreamer sourceAddr, destAddr, streamFPS, streamQuality
ActiveUSB1.Acquire=
True

ActiveUSB1.WebStream=
True


 

Remarks


The web streaming option allows you to automatically convert video outputted by the camera into the H.264 compression format and transmit it over the wireless or wired network using the RTSP protocol to a remote playback devices, such as PCs, tablets and smartphones. Use the SetWebStreamer method to configure parameters of the web streamer before turning the web streaming on.

When specifying the source address, make sure to use the IP address of a local interface connected to the same network on which your remote client device operates. The port number and/or filename can be omitted in the source address string, in which case default values will be used.

When specifying the destination address, use the intranet IP address of a remote device or network interface on a remote PC (you can look up IP addresses assigned to different devices on your network by accessing your router's web interface). If you want to multicast the web stream to all devices on your network, enter a multicast IP address such as 239.0.0.1

If the value of the frameRate parameter exceeds the camera's fps, the camera's fps will be used as the frame rate of the web video.

To watch a transmitted video on a remote playback device, use an RTSP/RTP client such as VLC Media Player or Fresh Video Player.

The following steps describe how to use VLC Media Player on a remote Windows-based client PC to display a web video stream transmitted by an ActiveUSB-based streaming application:
   
   - Run VLC media player on a client PC (the IP address of the client PC must be same as the destination address used in your streaming application).
   - Select Media -> Open Network Stream in the player's menu. The Open Media dialog box will be displayed.
   - In the Network URL field enter the full RTSP web address matching the source address used in your ActiveUSB-based application, for example:                rtsp://192.168.0.5:8554/test.asp
   - Click the Play button. Within a few seconds a decoded video should appear on the player's screen.