Service: Perception

This API is not yet officially released nor maintained.

The perception service allows getting, configuring and receiving updates of the perception configurations. Perception configurations specify the algorithms used for e.g. for background subtraction etc.

Table 1. Available methods
Method	Request	Response
Get	google.protobuf.Empty	PerceptionGetResponse
Set	PerceptionSetRequest	google.protobuf.Empty
Watch	google.protobuf.Empty	PerceptionWatchResponseStream
ListTemplates	google.protobuf.Empty	PerceptionListTemplatesResponse
ResetBackground	PerceptionResetBackgroundRequest	google.protobuf.Empty

Get

Get current perception configuration

Response

Response containing the current perception configuration

Table 2. Available fields in blickfeld.percept_pipeline.services.PerceptionGetResponse
Field	Type	Default	Unit
perception	config.Perception	-	-
perception	The current perception configuration

Set

Set the perception configuration

Request

Request for setting the perception configuration

Table 3. Available fields in blickfeld.percept_pipeline.services.PerceptionSetRequest
Field	Type	Default	Unit
template_name	string	-	-
template_name	Use a template to set the configuration, templates are predefined perception configurations
perception	config.Perception	-	-
perception	Use the specified configuration

Watch

Watch changes of perception configuration

Response Stream

Continuous response on perception configuration changes

Table 4. Available fields in blickfeld.percept_pipeline.services.PerceptionWatchResponse
Field	Type	Default	Unit
perception	config.Perception	-	-
perception	The current set perception configuration

ListTemplates

Return list of names for named templates

Response

Response containing perception configuration templates

Table 5. Available fields in blickfeld.percept_pipeline.services.PerceptionListTemplatesResponse
Field	Type	Default	Unit
named_templates	repeated NamedTemplatesEntry	-	-
named_templates	Mapping from a template name to the template itself. The template can be used to configure the perception algorithms for certain use-cases.

Named Templates Entry

Table 6. Available fields in blickfeld.percept_pipeline.services.PerceptionListTemplatesResponse.NamedTemplatesEntry
Field	Type	Default	Unit
key	string	-	-
value	config.Perception	-	-

ResetBackground

Resets the background of one, multiple or all devices

Request

Request to reset the background model of one, multiple or all devices

Table 7. Available fields in blickfeld.percept_pipeline.services.PerceptionResetBackgroundRequest
Field	Type	Default	Unit
fqdns	repeated string	-	-
fqdns	If the list is empty, the background models of all data sources are reset. If the background models of only specific devices should be rebuilt, the 'fqdn' of the respective devices has to be mentioned in the 'fqdns' list.