Skip to content

StreamingAPI: Physical-Level Sensor Streaming

StreamingAPI provides a streaming interface for Physical-level Sensor data, designed for Scenarios that require real-time processing of raw Sensor output — such as visual algorithm validation based on Camera Images, or perception algorithm testing based on Point Cloud data.

Unlike standard data APIs (e.g., GetObstacleList), StreamingAPI directly outputs raw frame data from physical Sensors. It features high data volume and high update frequency, does not rely on the frame sync mechanism, and is better suited for latency-sensitive real-time streaming Scenarios.

Prerequisites

Note

Before using StreamingAPI, you must attach the corresponding type of Physical-level Sensor (Camera or LiDAR) to the Ego Vehicle in the SimOne Scenario configuration. If no Sensor is attached, calls to the related APIs will return empty data.

Supported Data Formats

Data Type Supported Formats
Image RGB, JPEG, Segmentation (semantic segmentation), H.265
Point Cloud SimOne_Streaming_Point_Cloud (SimOne custom format)

API Quick Reference

For detailed parameter descriptions, refer to the C++ API Reference.

Name Event C++ API Python API
Physical-level Sensor Streaming Retrieve Image data in real time (Image formats include RGB/JPEG/Segmentation/H.265, etc.) GetStreamingImage SoGetStreamingImage
Set a real-time Image data update callback (Image formats include RGB/JPEG/Segmentation/H.265, etc.) SetStreamingImageUpdateCB SoApiSetStreamingImageUpdateCB
Retrieve Point Cloud data in SimOne_Streaming_Point_Cloud format in real time GetStreamingPointCloud SoGetStreamingPointCloud
Set a Point Cloud data update callback SetStreamingPointCloudUpdateCB SoApiSetStreamingPointCloudUpdateCB