参数说明

更新时间:

本文介绍云消息队列 MQTT 版云端Go SDK的参数说明。

公共参数

参数

说明

domain

云消息队列 MQTT 版实例的接入点。客户端通过接入点连接云消息队列 MQTT 版服务端。

使用云端SDK接入云消息队列 MQTT 版时,需要填写的接入点格式如下:

重要

仅实例地域属于中国内地的实例支持云端SDK接入。

  • 公网接入点MQTT实例ID-server-internet.mqtt.aliyuncs.com

  • VPC 接入点MQTT实例ID-server-internal.mqtt.aliyuncs.com

MQTT实例ID可在云消息队列 MQTT 版控制台实例详情页面的基础信息区域查看。

port

协议端口。端口和使用的协议必须匹配,云端SDK中,该参数值固定为5672。

instanceId

您在云消息队列 MQTT 版控制台创建的实例的ID。可在云消息队列 MQTT 版控制台实例详情页面查看。

accessKey

您在阿里云账号管理控制台中创建的AccessKey ID,用于身份认证。获取方式,请参见获取AccessKey

secretKey

您在阿里云账号管理控制台中创建的AccessKey Secret,用于身份认证。获取方式,请参见获取AccessKey。仅在Signature鉴权模式下需要设置。

消息发送

表 1. 消息发送参数

参数

说明

mqttTopic

云消息队列 MQTT 版的Topic,包括父级Topic和子级Topic。

其中父级Topic需要在云消息队列 MQTT 版控制台创建。子级Topic无需创建,直接在代码中定义。更多信息,请参见基本概念

重要

如果使用了未创建或未授权的Topic,会导致客户端鉴权失败,云消息队列 MQTT 版服务端断开客户端的连接。

消息订阅

表 2. 消息订阅参数

参数

说明

firstTopic

您在云消息队列 MQTT 版控制台创建的父级Topic。更多信息,请参见基本概念

重要
  • 如果使用了未创建或未授权的Topic,会导致客户端鉴权失败,云消息队列 MQTT 版服务端断开客户端的连接。

  • 由于云端SDK订阅消息一般用于云上应用进行消息汇总和分析等场景,因此,云端SDK订阅消息不支持设置子级Topic。

设备上下线事件

表 3. 设备上下线事件参数

参数

说明

gid

您在云消息队列 MQTT 版控制台创建的Group的ID。更多信息,请参见基本概念