Service: Camera

This API is not yet officially released nor maintained.

Service for what a camera sees, as the other services here serve the pipeline’s other output.

Finding a camera and aiming it are the percept_pipeline Camera service’s.

Table 1. Available methods
Method	Request	Response
Stream	CameraStreamRequest	CameraStreamResponseStream

Stream

A camera’s live video, for as long as the caller keeps the stream open.

The first message carries the format to configure a decoder with; the pictures follow, starting at a keyframe, so something can be shown at once. The format is sent again whenever it changes, and is followed by a keyframe. The encoded video is the camera’s own, passed on without being decoded or encoded again; every viewer of a camera shares the one stream the device receives from it.

Request

A request to receive a stream of a camera’s video.

Table 2. Available fields in blickfeld.percept_processing.services.CameraStreamRequest
Field	Type	Default	Unit
camera	percept_pipeline.config.DataSource.Camera	-	-
camera	The camera to stream video from, described as the data source describes one. A camera that is configured is recognised by its `serial_number` and served from the stream the pipeline already receives from it; one that is not needs its connection filled in and is served from a stream opened for this call alone.

Response Stream

One message of a camera’s video stream.

Table 3. Available fields in blickfeld.percept_processing.services.CameraStreamResponse
Field	Type	Default	Unit
video	data.Camera.Video	-	-
video	The format the pictures that follow are encoded in, or one of those pictures.