腾讯云云云对接接入
约 885 字大约 3 分钟
设备接入第三方协议腾讯云云云对接
2026-08-20
简介
腾讯云云云对接(tencentCloud)是联犀平台对接腾讯云物联网平台的云云对接协议,支持产品、设备同步与消息转发,已上云设备无需改动固件。
应用场景
- 存量腾讯云设备迁移:腾讯云 IoT 平台已有设备接入联犀
- 产品/设备同步:协议自动同步腾讯云侧产品与设备信息
前置条件
- 协议容器已部署:
protocol-tencent容器运行正常 - 腾讯云凭据:已开通腾讯云物联网开发平台,具备 SecretId/SecretKey、Region、ProjectID 等
1. 创建联犀企业账号
- 在腾讯云物联网开发平台选择实例和项目,记录腾讯云项目 ID及地域,例如
ap-guangzhou。 - 在腾讯云访问管理中准备有权访问该项目的 API 密钥。
- 在联犀进入「设备接入 → 协议配置 → 企业级」,打开腾讯云云云对接的「配置详情」,填写 SecretId、SecretKey、地域、腾讯云项目 ID 和用于 HTTP 转发鉴权的 Token。Token 在两侧保持一致。
SecretKey 和 Token 保存后会隐藏,修改其他字段时留空可保留原值。新建云账号使用企业级;已有历史项目账号按原项目归属读取。
2. 配置腾讯云规则引擎
请部署管理员确认腾讯云可访问且能转发至腾讯云网关的 HTTPS 域名。在腾讯云项目进入「数据流转 → 规则引擎」,创建规则、筛选产品及消息类型,并选择「数据转发到第三方服务(Forward)」作为动作。使用下面的接收路径,开启鉴权 Token,填写和联犀配置一致的值,然后启用规则。
https://<网关公网域名>/api/v1/protocol/cloud/tencent/rule/notify/<企业编码>/<腾讯云项目ID>「数据开发 → 自定义推送」的签名头和消息格式与此接收接口不同。控制台图示见腾讯云官方规则引擎指南和第三方服务转发与验签。
3. 绑定产品并验证
选择 tencentCloud 协议。在联犀产品详情「设备接入」选择对应企业账号,填写腾讯云产品 ID,并核对它与联犀产品的映射。设备详情用于确认设备及产品映射。
用一台测试设备上报,核对规则转发结果、网关日志和联犀物模型。若规则已启用仍没有数据,检查公网转发路径、Token、规则筛选条件、云端产品 ID 和企业账号绑定。
技术方案
接入架构
腾讯云物联网平台 ──SDK──> protocol-tencent 容器 ──MQTT/NATS──> 联犀平台- 协议进程以腾讯云凭据连接腾讯云物联网平台
- 消费设备消息(含云存事件)并转换为联犀标准物模型格式
- 联犀侧下发指令反向推送到腾讯云设备
消息流转
- 上行:腾讯云设备上报 → 协议消费 → 联犀物模型属性/事件
- 下行:联犀服务调用 → 协议转发 → 腾讯云设备
注意事项
- 凭据需有腾讯云物联网平台对应权限
- 支持产品/设备同步与云存事件(详见协议实现)
更新日志
2026/11/10 05:37
查看所有更新日志
ae9e0-docs(设备接入): 更新多协议接入流程与配置范围于2fc1c-Merge #36 into master from docs/user-facing-cleanup于eb33f-Merge #35 into master from docs/third-party-protocols-update于70dbb-Merge #34 into master from docs/third-party-protocols-update于4ab8f-Merge #25 into master from docs/third-party-protocols于
