StreamInd SDK

简介

StreamInd SDK 是专为 IoT 设备快速接入云平台设计的轻量级框架。采用创新的 Signal-Directive 架构，让嵌入式设备具备认知能力，实现从传统的”数据流”到”认知流”的升级。

核心特性

⚡ 快速编译

预编译库：节省 3-5 分钟编译时间
开箱即用：ESP-IDF 组件即插即用
零配置：默认设置适配大多数场景

🔧 完整功能

WebSocket 通信：自动重连，断线续传
音频处理：OPUS 音频流实时编解码
指令系统：统一的 Directive 接收和执行
硬件控制：异步任务管理，硬件并发控制

🪶 轻量高效

低内存占用：优化的内存管理策略
高性能：关键路径零拷贝设计
快速启动：毫秒级连接建立

平台支持

硬件平台

ESP32 系列（ESP32、ESP32-S2、ESP32-S3、ESP32-C3 等）
推荐芯片：ESP32-S3（更高性能，更多内存）
Flash: 8MB 最低，16MB 推荐
PSRAM: 4MB 最低，8MB 推荐（ESP32-S3）

实战案例：星宝智能机器人基于 ESP32-S3 开发

软件要求

ESP-IDF: >= 5.0.0
编译器: Xtensa GCC 14.2.0+
C++ 标准: C++17

架构概览


┌─────────────────────────────────────┐
│       Cloud Platform (云平台)       │
│  WebSocket Server / Decision Engine │
└────────────────┬────────────────────┘
                 │
                 ↓ WebSocket
┌─────────────────────────────────────┐
│         StreamInd SDK (核心)        │
│  ├─ Signal Sending (信号发送)       │
│  ├─ Directive Receiving (指令接收)  │
│  ├─ Capability Registry (能力注册)  │
│  └─ Task Management (任务管理)      │
└────────────────┬────────────────────┘
                 │
                 ↓
┌─────────────────────────────────────┐
│      Hardware Adapters (适配器层)   │
│  音频 / 显示 / 传感器 / 电机...      │
└────────────────┬────────────────────┘
                 │
                 ↓
┌─────────────────────────────────────┐
│     Physical Hardware (物理硬件)     │
│  ESP32-S3 / 外设驱动 / 传感器模块    │
└─────────────────────────────────────┘

快速链接

快速开始 - 5 分钟完成集成
核心概念 - 理解 Signal-Directive 架构
API 参考 - 完整 API 文档
示例代码 - 实战示例

版本信息

当前版本：v1.0.0 (2025-12-20)

更新日志

v1.0.0 (2025-12-20) - 首次发布

✅ WebSocket 自动重连机制
✅ OPUS 音频流处理
✅ 指令接收和执行框架
✅ 硬件任务异步管理
✅ 能力注册系统
✅ 编译优化 (-O2)

获取帮助

GitHub: streamind/sdk
问题反馈: GitHub Issues
文档: 完整文档

许可证

本 SDK 采用 Apache License 2.0 许可证。