Analytics
Analytics service implementation.
Analytics
Bases: ONVIFService
Analytics service client.
| Property | Details |
|---|---|
| First introduced | ONVIF Release 2.41 (December 2013) |
| Binding name | AnalyticsEngineBinding (ver20/analytics/wsdl/analytics.wsdl) |
| Operations | analytics.wsdl |
| Specification | Analytics.xml |
GetServiceCapabilities()
Returns the capabilities of the analytics service.
The result is returned in a typed answer.
GetSupportedAnalyticsModules(ConfigurationToken)
List all analytics modules that are supported by the given VideoAnalyticsConfiguration.
CreateAnalyticsModules(ConfigurationToken, AnalyticsModule)
Add one or more analytics modules to an existing VideoAnalyticsConfiguration.
The available supported types can be retrieved via GetSupportedAnalyticsModules, where the Name of the supported AnalyticsModules correspond to the type of an AnalyticsModule instance.
Pass unique module names which can be later used as reference. The Parameters of the analytics module must match those of the corresponding AnalyticsModuleDescription.
Although this method is mandatory a device implementation may not support adding modules. Instead it can provide a fixed set of predefined configurations via the media service functions GetCompatibleVideoAnalyticsConfigurations and GetAnalyticsConfigurations.
The device shall ensure that a corresponding analytics engine starts operation when a client subscribes directly or indirectly for events produced by the analytics or rule engine or when a client requests the corresponding scene description stream. An analytics module must be attached to a Video source using the media profiles before it can be used. In case differing analytics configurations are attached to the same profile it is undefined which of the analytics module configuration becomes active if no stream is activated or multiple streams with different profiles are activated at the same time.
DeleteAnalyticsModules(ConfigurationToken, AnalyticsModuleName)
Remove one or more analytics modules from a VideoAnalyticsConfiguration referenced by their names.
GetAnalyticsModules(ConfigurationToken)
List the currently assigned set of analytics modules of a VideoAnalyticsConfiguration.
GetAnalyticsModuleOptions(ConfigurationToken, Type=None)
Return the options for the supported analytics modules that specify an Option attribute.
ModifyAnalyticsModules(ConfigurationToken, AnalyticsModule)
Modify the settings of one or more analytics modules of a VideoAnalyticsConfiguration.
The modules are referenced by their names. It is allowed to pass only a subset to be modified.
GetSupportedMetadata(Type=None)
This method provides a computer readable description of the metadata that the selected analytics modules can generate.
The type parameter allows to select a single analytics module. By default the output shall relate to all analytics modules that exist in the device.
The response shall provide a sample XML frame. The sample frame shall include all potentially generated elements by the selected analytics modules. Note that this e.g. does not need to include all possible class type enumerations.