腾讯云云云对接接入
简介
腾讯云云云对接（tencentCloud）是联犀平台对接腾讯云物联网平台的云云对接协议，支持产品、设备同步与消息转发，已上云设备无需改动固件。
应用场景
- 存量腾讯云设备迁移：腾讯云 IoT 平台已有设备接入联犀
- 产品/设备同步：协议自动同步腾讯云侧产品与设备信息
前置条件
- 协议容器已部署：
protocol-tencent容器运行正常 - 腾讯云凭据：已开通腾讯云物联网开发平台，具备 SecretId/SecretKey、Region、ProjectID 等
产品配置
1. 创建产品
创建产品时选择协议 tencentCloud（传输协议 MQTT），创建后进入产品详情。
2. 协议配置参数（产品维度）
进入产品详情「设备接入」Tab，填写腾讯云凭据（配置页由 protocol-tencent 协议服务内嵌提供，保存到产品协议配置 protocolConf，对该产品下所有设备生效）：
| 字段 | 说明 |
|---|---|
secretID | 腾讯云 SecretId（必填，来自「访问管理 - API 密钥管理」，需具备 IoT Explorer 读写权限） |
secretKey | 腾讯云 SecretKey（必填） |
region | 地域（必填，如 ap-guangzhou，参考腾讯云地域列表） |
projectID | IoT Explorer 项目 ID（必填） |
token | 平台向腾讯云推送消息使用的 token（必填） |
协议进程据此连接腾讯云并同步数据。
若协议服务未运行或未提供配置页服务实例，该 Tab 会显示「配置页暂不可用（协议 tencentCloud 暂无可用的配置页服务实例，服务未启动或未提供配置页）」占位提示，此时凭据需通过产品协议配置（
protocolConf）方式设置；协议服务正常提供配置页后，可在该 Tab 页直接维护：
设备接入
云云对接模式下设备由腾讯云侧管理，无需在联犀侧单独创建设备。
设备详情「设备接入」Tab 展示「腾讯云 IoT Explorer 接入配置」卡片：设备维度不维护独立协议配置，页面仅展示产品 ID 与设备名称映射，并提示「云云对接配置在产品维度维护，请在产品详情『设备接入』页操作」，即凭据统一在产品维度配置，设备按产品级云云对接配置自动同步上下线、属性与指令：
若协议服务未提供配置页服务实例，设备页同样显示「配置页暂不可用」占位提示：
技术方案
接入架构
腾讯云物联网平台 ──SDK──> protocol-tencent 容器 ──MQTT/NATS──> 联犀平台- 协议进程以腾讯云凭据连接腾讯云物联网平台
- 消费设备消息（含云存事件）并转换为联犀标准物模型格式
- 联犀侧下发指令反向推送到腾讯云设备
消息流转
- 上行：腾讯云设备上报 → 协议消费 → 联犀物模型属性/事件
- 下行：联犀服务调用 → 协议转发 → 腾讯云设备
注意事项
- 凭据需有腾讯云物联网平台对应权限
- 支持产品/设备同步与云存事件（详见协议实现）
更新日志
2026/8/31 22:31
查看所有更新日志
2fc1c-于eb33f-于70dbb-于4ab8f-于
