1
0
mirror of https://github.com/node-red/node-red.git synced 2023-10-10 13:36:53 +02:00

Update 10-mqtt.html

This commit is contained in:
xuyu0v0 2023-07-10 18:17:10 +08:00 committed by GitHub
parent b705b456ff
commit 38c09ada39
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -11,7 +11,7 @@
limitations under the License. limitations under the License.
--> -->
<script type="text/x-red" data-help-name="mqtt in"> <script type="text/html" data-help-name="mqtt in">
<p>连接到MQTT代理并订阅来自指定主题的消息。</p> <p>连接到MQTT代理并订阅来自指定主题的消息。</p>
<h3>输出</h3> <h3>输出</h3>
<dl class="message-properties"> <dl class="message-properties">
@ -23,14 +23,51 @@
<dd>QoS服务质量0, 最多一次; 1, 最少一次; 2, 只一次。</dd> <dd>QoS服务质量0, 最多一次; 1, 最少一次; 2, 只一次。</dd>
<dt>retain <span class="property-type">布尔值</span></dt> <dt>retain <span class="property-type">布尔值</span></dt>
<dd>值为true时表示消息已保留且可能是旧的。</dd> <dd>值为true时表示消息已保留且可能是旧的。</dd>
<dt class="optional">responseTopic <span class="property-type">字符串</span></dt>
<dd><b>MQTTv5</b>: 消息的 MQTT 响应主题</dd>
<dt class="optional">correlationData <span class="property-type">Buffer</span></dt>
<dd><b>MQTTv5</b>: 消息的关联数据</dd>
<dt class="optional">contentType <span class="property-type">字符串</span></dt>
<dd><b>MQTTv5</b>: 有效负载的内容类型</dd>
<dt class="optional">userProperties <span class="property-type">object</span></dt>
<dd><b>MQTTv5</b>: 消息的任何用户属性</dd>
<dt class="optional">messageExpiryInterval <span class="property-type">数值</span></dt>
<dd><b>MQTTv5</b>: 消息的过期时间,以秒为单位</dd>
</dl> </dl>
<h3>详细</h3> <h3>详细</h3>
<p>订阅主题可以包括MQTT通配符+:一个级别,#:多个级别)。</p> <p>订阅主题可以包括MQTT通配符+:一个级别,#:多个级别)。</p>
<p>使用该节点您首先需要建立与MQTT代理的连接。通过单击铅笔图标来进行配置。</p> <p>使用该节点您首先需要建立与MQTT代理的连接。通过单击铅笔图标来进行配置。</p>
<p>如有需要几个MQTT节点输入或输出可以共享相同的代理连接。</p> <p>如有需要几个MQTT节点输入或输出可以共享相同的代理连接。</p>
<h4>动态订阅</h4>
可以将节点配置为动态控制 MQTT 连接及其订阅。 启用后,节点将有一个输入,并且可以通过向其传递消息来控制。
<h3>输入</h3>
<p>这些仅在节点配置为动态订阅时适用。</p>
<dl class="message-properties">
<dt>action <span class="property-type">字符串</span></dt>
<dd>节点应执行的操作的名称。 可用的操作有: <code>"connect"</code>,
<code>"disconnect"</code>, <code>"subscribe"</code><code>"unsubscribe"</code>.</dd>
<dt class="optional">topic <span class="property-type">字符串|object|数组</span></dt>
<dd>对于<code>"subscribe"</code><code>"unsubscribe"</code> 操作,该属性提供了主题。 它可以设置为:<ul>
<li>包含主题过滤器的字符串</li>
<li>包含<code>topic</code><code>qos</code>属性的对象</li>
<li>用于处理多个主题的字符串或对象数组</li>
</ul>
</dd>
<dt class="optional">broker <span class="property-type">broker</span> </dt>
<dd>对于<code>"connect"</code> 操作,此属性可以覆盖任何单独的代理配置设置,包括: <ul>
<li><code>broker</code></li>
<li><code>port</code></li>
<li><code>url</code> - 覆盖代理/端口以提供完整的连接url</li>
<li><code>username</code></li>
<li><code>password</code></li>
</ul>
<p>如果设置了此属性并且代理已连接,则会记录错误,除非它设置了 <code>force</code> 属性 - 在这种情况下,它将与代理断开连接,应用新设置并重新连接。</p>
</dd>
</dl>
</script> </script>
<script type="text/x-red" data-help-name="mqtt out"> <script type="text/html" data-help-name="mqtt out">
<p>连接到MQTT代理并发布消息。</p> <p>连接到MQTT代理并发布消息。</p>
<h3>输入</h3> <h3>输入</h3>
<dl class="message-properties"> <dl class="message-properties">
@ -42,9 +79,20 @@
<dt class="optional">qos <span class="property-type">number</span></dt> <dt class="optional">qos <span class="property-type">number</span></dt>
<dd>QoS服务质量0, 最多一次; 1, 最少一次; 2, 只一次。默认值为0。</dd> <dd>QoS服务质量0, 最多一次; 1, 最少一次; 2, 只一次。默认值为0。</dd>
<dt class="optional">retain <span class="property-type">布尔值</span></dt> <dt class="optional">retain <span class="property-type">布尔值</span></dt>
<dd>设置为<code>true</code>来将消息保留在代理上。默认值为<code>false</code></dd> <dd>设置为true来将消息保留在代理上。默认值为false。</dd>
<dt class="optional">responseTopic <span class="property-type">字符串</span></dt>
<dd><b>MQTTv5</b>: 消息的 MQTT 响应主题</dd>
<dt class="optional">correlationData <span class="property-type">Buffer</span></dt>
<dd><b>MQTTv5</b>: 消息的关联数据</dd>
<dt class="optional">contentType <span class="property-type">字符串</span></dt>
<dd><b>MQTTv5</b>: 有效负载的内容类型</dd>
<dt class="optional">userProperties <span class="property-type">object</span></dt>
<dd><b>MQTTv5</b>: 消息的任何用户属性</dd>
<dt class="optional">messageExpiryInterval <span class="property-type">数值</span></dt>
<dd><b>MQTTv5</b>: 消息的过期时间,以秒为单位</dd>
<dt class="optional">topicAlias <span class="property-type">数值</span></dt>
<dd><b>MQTTv5</b>: 要使用的 MQTT 主题别名</dd>
</dl> </dl>
<h3>详细</h3> <h3>详细</h3>
<p><code>msg.payload</code>用作已发布消息的有效载荷。如果包含Object则会在发送之前将其转换为JSON字符串。如果它包含二进制buffer则消息将按原样发布。</p> <p><code>msg.payload</code>用作已发布消息的有效载荷。如果包含Object则会在发送之前将其转换为JSON字符串。如果它包含二进制buffer则消息将按原样发布。</p>
@ -52,9 +100,28 @@
<p>同样可以在节点中配置QoS和保留值或者如果保留空白则分别由<code>msg.qos</code><code>msg.retain</code>设置。要清除先前存储在代理中的主题,请设置保留标志并向该主题发布空消息。</p> <p>同样可以在节点中配置QoS和保留值或者如果保留空白则分别由<code>msg.qos</code><code>msg.retain</code>设置。要清除先前存储在代理中的主题,请设置保留标志并向该主题发布空消息。</p>
<p>该节点需要与要配置的MQTT代理的连接。通过单击铅笔图标进行配置。</p> <p>该节点需要与要配置的MQTT代理的连接。通过单击铅笔图标进行配置。</p>
<p>如果需要几个MQTT节点输入或输出可以共享相同的代理连接。</p> <p>如果需要几个MQTT节点输入或输出可以共享相同的代理连接。</p>
<h4>动态控制</h4>
节点共享的连接可以动态控制。 如果节点收到以下控制消息之一,它也不会发布消息负载。
<h3>输入</h3>
<dl class="message-properties">
<dt>action <span class="property-type">字符串</span></dt>
<dd>节点应执行的操作的名称。 可用的操作有:<code>"connect"</code><code>"disconnect"</code>.</dd>
<dt class="optional">broker <span class="property-type">broker</span> </dt>
<dd>对于<code>"connect"</code>操作, 此属性可以覆盖任何单独的代理配置设置,包括: <ul>
<li><code>broker</code></li>
<li><code>port</code></li>
<li><code>url</code> - 覆盖代理/端口以提供完整的连接url</li>
<li><code>username</code></li>
<li><code>password</code></li>
</ul>
<p>如果设置了此属性并且代理已连接,则会记录错误,除非它设置了 <code>force</code> 属性 - 在这种情况下,它将与代理断开连接,应用新设置并重新连接。</p>
</dd>
</dl>
</script> </script>
<script type="text/x-red" data-help-name="mqtt-broker"> <script type="text/html" data-help-name="mqtt-broker">
<p>与MQTT代理的连接设置。</p> <p>与MQTT代理的连接设置。</p>
<p>创建与代理的连接设置。可以在<code>MQTT In</code><code>MQTT Out</code>节点中重复利用这些设置。</p> <p>创建与代理的连接设置。可以在<code>MQTT In</code><code>MQTT Out</code>节点中重复利用这些设置。</p>
<p>如果未为该节点设置客户端ID并且设置了会话初始化则将生成一个随机客户端ID。设置客户端ID时请确保它对于连接目标处的代理是唯一的。</p> <p>如果未为该节点设置客户端ID并且设置了会话初始化则将生成一个随机客户端ID。设置客户端ID时请确保它对于连接目标处的代理是唯一的。</p>