# 延迟发布

EMQX 的延迟发布功能可以实现按照用户配置的时间间隔延迟发布 PUBLISH 报文的功能。当客户端使用特殊主题前缀 $delayed/{DelayInteval} 发布消息到 EMQX 时,将触发延迟发布功能。

延迟发布主题的具体格式如下:

$delayed/{DelayInterval}/{TopicName}
1
  • $delayed: 使用 $delayed 作为主题前缀的消息都将被视为需要延迟发布的消息。延迟间隔由下一主题层级中的内容决定。
  • {DelayInterval}: 指定该 MQTT 消息延迟发布的时间间隔,单位是秒,允许的最大间隔是 4294967 秒。如果 {DelayInterval} 无法被解析为一个整型数字,EMQX 将丢弃该消息,客户端不会收到任何信息。
  • {TopicName}: MQTT 消息的主题名称。

例如:

  • $delayed/15/x/y: 15 秒后将 MQTT 消息发布到主题 x/y
  • $delayed/60/a/b: 1 分钟后将 MQTT 消息发布到 a/b
  • $delayed/3600/$SYS/topic: 1 小时后将 MQTT 消息发布到 $SYS/topic

延迟发布功能由 emqx_mod_delayed 内置模块提供,此功能默认关闭,支持动态启停,可在【模块】选项中点击启用,请参见 modules 命令