Main Content

Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version 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 un flux du 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 (off).

  • 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 de caractère 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 caractère 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'une canal.

Par exemple: field1=100

fieldx

Données à saisir dans le champ x d'une 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

twitter

Nom d'utilisateur de votre compte Twitter® lié à l'application ThingTweet.

Par exemple: twitter=nohans

tweet

Mise à jour du message d'état de votre compte Twitter.

Par exemple: tweet=Tweet from my channel

created_at

Date de saisie 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 un flux du canal.

Dans la boîte de dialogue Nouvelle connexion, 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, accompagné d'un message d'état MQTTPUBLISH.