intel/scenescape-analytics

Scenescape分析服务

镜像概述

Scenescape分析微服务针对场景中跟踪的对象，完成区域、绊线和传感器分析，将生成的检测结果与事件发布给下游消费者。该服务负责处理上游跟踪器的未调节跟踪对象消息及原始传感器读数，通过数据关联输出调节后的检测结果、区域/绊线事件及传感器关联的对象状态。

核心功能

• 消费场景控制器或上游跟踪器的未调节跟踪对象消息（主题：scenescape/data/scene/{scene_id}/{thing_type}）及原始传感器读数（主题：scenescape/data/sensor/{sensor_id}）；
• 发布速率控制的调节检测结果，将所有对象类别聚合为每个场景一条消息；
• 生成区域/绊线事件（如进入/退出检测、停留时间跟踪）；
• 为跟踪对象标记其测量区域内环境与属性传感器的读数，输出传感器关联的对象状态；
• 场景控制器不具备传感器关联、调节输出或区域/绊线事件发布功能，此服务独家负责该类功能。

使用场景

• 智能监控场景中，分析跟踪对象的区域进出、停留时长；
• 结合环境传感器数据，为跟踪对象添加状态标签（如温度、湿度等）；
• 向下游服务提供标准化、速率可控的检测数据，支持后续分析或决策。

配置说明

（具体配置需参考官方文档，以下为通用示例）

1. 环境变量：设置场景ID、传感器ID等核心参数；
2. 消息队列连接：配置与上游消息源（如场景控制器）的连接信息；
3. 输出主题：指定检测结果与事件的发布主题。

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name scenescape-analytics \
  -e SCENE_ID=your_scene_id \
  -e SENSOR_ID=your_sensor_id \
  -e MESSAGE_BROKER_URL=mqtt://broker.example.com:1883 \
  docker.xuanyuan.run/intel/scenescape-analytics

文档与社区

• 概述与架构：https://github.com/open-edge-platform/scenescape/blob/main/docs/user-guide/microservices/analytics/analytics.md
• API参考：https://github.com/open-edge-platform/scenescape/blob/main/docs/user-guide/microservices/analytics/api-reference.md
• 问题反馈：通过https://github.com/open-edge-platform/scenescape/issues提交bug或功能请求
• 贡献指南：参考https://github.com/open-edge-platform/scenescape/blob/main/CONTRIBUTING.md参与贡献

许可证

本镜像基于https://www.apache.org/licenses/LICENSE-2.0许可。

来源与第三方声明

该分发包含受copyleft许可的组件，完整源代码可通过DockerHub的https://hub.docker.com/r/intel/scenescape-sources/tags镜像获取，详情见该镜像中的third-party-programs.txt文件。

免责声明

本容器镜像仅用于演示，不适合生产环境。如需Ubuntu基础层的扩展安全维护，可参考https://documentation.ubuntu.com/pro-client/en/docs/howtoguides/enable_in_dockerfile/（需重新构建镜像）。

Scenescape可能使用FFmpeg/GStreamer：

• FFmpeg：基于LGPL/GPL许可，详情见https://www.ffmpeg.org/legal.html，您需自行判断是否需额外许可；
• GStreamer：基于LGPL许可，详情见https://gstreamer.freedesktop.org/documentation/frequently-asked-questions/licensing.html，您需自行判断是否需额外许可。Intel不负责获取此类许可或承担相关费用。