How do users configure a stream on the Sarix cameras series?

Issue

How do users configure a stream on the Sarix cameras series?

Product Line

Pelco Cameras

Environment

Sarix Camera

Cause

Manual configuration of Sarix stream

Resolution

Configuring a Sarix IP camera's stream:

Note
You should use this service in conjunction with the QueryOptions and GetAllCurrentConfiguration action. Specifically, users will need to use the current configuration as a starting point using the GetAllCurrentConfiguration action. Please refer to Determining possible valid stream configuration values for more information.

Warning: This is an advanced camera function. Changing a stream's configuration may result in a difficult to resolve problem that may require resetting a camera's configuration. Please refer to the Pelco Device Control URL and Pelco Device Port Number entries, in the getting started section, for important details about the code sample.

One of the main features of Sarix's stream configuration service (and any future product supporting this service) is that it will list all possible settings including possible valid values for these settings. This will also take into account possible values for one setting in relation to other settings that are interdependent. For example if the resolution and framerate settings are set above a certain threshold, then the sign setting will only allow a false value

Note: For many situations, using the StreamConfiguration service for determining valid configuration settings and applying them is more than likely an iterative process. e.g.

  1. User queries possible valid settings.
  2. User makes a configuration change.
  3. User queries possible valid settings for other settings to change.
  4. User makes a configuration change.
  5. User queries possible valid settings for other settings to change.
  6. User makes a configuration change.
  7. ...The cycle repeats until the user has no more settings to change...
     

To configure a stream, do the following:

  1. Create a new instance of the class that acts as a representative of the stream configuration web service
  2. Retrieve the desired stream's current configuration. Please refer to Determining possible valid stream configuration values given desired configuration values for details.

Warning: Retrieving the IP camera's current configuration is required, since this needs to be resent along with any new changes to configuration. This ensures any current settings that you would like to maintain are not reset to factory default values.

  1. Make a SaveAllSettings request using the StreamID instance and StreamSetting instance as parameters. The streamSetting instance should be the result of iteratively calling the QueryAllOptions action as described in the Determining possible valid stream configuration values given desired configuration values entry.

Note: Users must submit all configuration settings, even settings that do not change in value. Failure to do so will result in the Sarix IP camera rejecting the SaveAllSettings request. Furthermore, if the Sarix IP camera determines that the combination of setting values is invalid, it will also reject the SaveSettings request.

C# Example:

 

For configuring contrast, saturation, and brightness settings ONLY

Note: The current line of ID and IX series of Sarix cameras still uses the camera configuration service for certain settings. For details, lease refer to the Contrast, Saturation, and Brightness entry within the stream configuration issues section. It is not recommended to use the camera configuration service for any settings other than contrast, saturation, and brightness

  1. If you have not already done so, please refer to the getting started section.
  2. Account for the HTTP 100-continue header. Failure to do so will result in an error since Sarix IP cameras will not respond with a "100 (Continue)".
  3. Initialize an instance of the class that acts as a representative of the camera configuration web service.
  4. Retrieve the IP camera's current configuration 

Warning: Retrieving the IP camera's current configuration is required, since this needs to be resent along with any new changes to configuration. This ensures any current settings users would like to retain are not reset to factory default values.
 

  1. Change the contrast, saturation, and brightness settings.
  2. Make a SetConfiguration request using the camera configuration instance as the parameter.
     

C# Example: