zeroconf.publish()

类型 函数
返回值 用户数据
修订 版本 2024.3703
关键词 ZeroConf，网络，发布
另请参阅 zeroconf.unpublish()
zeroconf.unpublishAll()
zeroconf.*

概述

开始通过网络发布服务。这也会触发一个 PluginZeroConfEvent 事件，其 阶段 为 "published"（已发布）。

如果发布成功启动，将返回一个发布 ID。可以将此 ID 传递给 zeroconf.unpublish() 来取消发布该服务。

陷阱

如果失败，此函数将返回 nil。

语法

zeroconf.publish( params )
参数 (必填)

表。 包含新对象参数的表 — 有关详细信息，请参阅下一节。

参数参考

端口 (必填)

数字。 要发布的网络端口号。

类型 (可选)

字符串。 要发布的服务类型。这**必须**以下划线 (_) 开头，并以点分隔的协议结尾。有效的协议名称为 _tcp 和 _udp。默认类型为 _corona._tcp。

名称 (可选)

字符串。 这应该标识特定设备。传递空字符串（默认）将触发尝试生成唯一名称。

数据 (可选)

表。 可以将任意键值数据附加到已发布的服务。数据键和值都必须是 字符串。所有附加数据的总大小限制为 255 个字节。

域 (可选)

字符串。 用于浏览服务的域。默认为 "local"（本地）。空字符串表示所有可用域。除非您完全了解其用途，否则请忽略此键。