Contenu principal

Cette page a été traduite par traduction automatique. Cliquez ici pour voir la version originale en anglais.

Publish to a Channel Feed

Publier un message pour mettre à jour plusieurs champs de canal simultanément avec MQTT

Sujet

channels/<channelID>/publish

Description

channels/<channelID>/publish met à jour le flux d’un canal en publiant un message sur le sujet spécifié. Remplacez <channelID> par votre identifiant de canal ThingSpeak. Pour en savoir plus sur la configuration de votre canal, consultez Propriétés du canal. Pour mettre à jour plusieurs paramètres simultanément, voir Paramètres de charge utile.

  • Ajoutez tous les Paramètres de charge utile nécessaires.

  • Définissez les messages PUBLISH pour avoir une valeur QoS de 0.

  • Définissez l'indicateur de connexion RETAIN sur 0 (désactivé).

  • Définissez l'indicateur de connexion CleanSession sur 1 (true).

Pour en savoir plus sur ces indicateurs, consultez la spécification MQTT v3.1.1.

Arguments d'entrée

développer tout

ID du canal pour la cible de publication, spécifié sous la forme d'un entier positif.

Paramètres de charge utile

Spécifiez les paramètres de charge utile facultatifs pour le message PUBLISH sous forme de chaîne avec des arguments Name=Value, séparés par &. Par exemple : field1=100&field2=50&lat=30.61&long=40.35 Si la chaîne de définition du paramètre contient des caractères spéciaux, elle doit être codée en URL (pourcentage) (application/x-www-form-urlencoded).

field1

Données à saisir dans le champ 1 d'un canal.

Par exemple : field1=100

fieldx

Données à saisir dans le champ x d'un canal. Assurez-vous que le champ est activé dans les paramètres du canal.

Par exemple : fieldx=100

x doit être inférieur ou égal à 8, le nombre de champs autorisés.

lat

Emplacement de votre canal sous forme de latitude.

Par exemple : lat=10.45

long

Emplacement de votre canal sous forme de longitude.

Par exemple : long=35.4

elevation

Altitude de votre canal à partir du niveau du sol en mètres.

Par exemple : elevation=100

status

Message d'état de votre canal.

Par exemple : status=Message

created_at

Date d'entrée du flux au format ISO 8601.

Par exemple : created_at=2014-12-31 23:59:59

Exemples

Configurez MQTT X pour envoyer un message PUBLISH pour mettre à jour le flux d’un canal.

Dans la boîte de dialogue New Connection, utilisez les paramètres de connexion suivants, ainsi que l'ID client, le nom d'utilisateur et le mot de passe dérivés lors de la création du MQTT device dans ThingSpeak :

Name: MyChanName
Client ID: ENTER_MQTT_DEVICE_CLIENT_ID
Host: mqtt://    mqtt3.thingspeak.com
Port: 1883
Username: ENTER_MQTT_DEVICE_USERNAME
Password: ENTER_MQTT_DEVICE_PASSWORD
Clean Session: true

Dans le volet Payload, utilisez les paramètres suivants :

Topic: channels/33301/publish
Payload: field1=45&field2=60&status=MQTTPUBLISH

Ce message PUBLISH publie une valeur de 45 à field1 et 60 à field2 du canal 33301, ainsi qu'un message d'état MQTTPUBLISH.