|
|
|
|
|
WebSocketClientConnecte (Fonction) En anglais : WebSocketClientConnect Permet d'établir une connexion non sécurisée (ws://) avec un serveur de Websocket. Une fois la connexion ouverte, le websocket se comporte comme un socket classique, il est donc possible d'utiliser les fonctions SocketLit, SocketEcrit, SocketFerme ou SocketExiste. Remarques : - Cette fonction possède deux syntaxes. Une syntaxe de connexion synchrone (avec un timeout et une valeur de retour) ainsi qu'une syntaxe asynchrone (avec une procédure callback).
- Avec un socket créé par la fonction WebSocketClientConnecte, la fonction SocketChangeModeTransmission n'aura aucun effet. Le socket fonctionne forcement en mode SocketSansMarqueurFin.
- La fonction WebSocketClientConnecteSSL permet d'établir une connexion sécurisée SSL (wss://) avec un serveur de Websocket.
// Se connecte au serveur de websocket en mode SYNCHRONE // ws://monserveur.com/WW_WebsocketServeur SI WebSocketClientConnecte("wbsocket", "monserveur.com", 80, "/WW_WebsocketServeur") ALORS // Envoie une chaîne au serveur d'echo SI SocketEcrit("wbsocket","Bonjour le monde !") ALORS // Récupère la réponse du serveur sMsg est une chaîne = SocketLit("wbsocket", Vrai) ToastAffiche("réponse du serveur : " + sMsg) FIN FIN // Se connecte au serveur de websocket en mode ASYNCHRONE // ws://192.168.100.1/MonProjetServeurWebSocket WebSocketClientConnecte("client", WebSocketClientConnecte_Callback, ... "192.168.100.1", 80, "MonProjetServeurWebSocket")  PROCÉDURE INTERNE WebSocketClientConnecte_Callback(nEvénement, sMessage) SELON nEvénement CAS SocketOuverture SocketEcrit("client", "Envoi message depuis le navigateur.") CAS SocketMessage Info("Réception d'un message serveur : " + sMessage) CAS SocketFermeture Info("Fermeture du socket", sMessage) CAS SocketErreur Erreur("Erreur du socket") FIN FIN Syntaxe
Etablir une connexion en mode asynchrone Masquer les détails
WebSocketClientConnecte(<Nom du socket> , <Procédure WLangage> , <Adresse du serveur> [, <Port> [, <Chemin> [, <Protocoles>]]])
<Nom du socket> : Chaîne de caractères Nom à donner à la connexion ouverte sur le socket. Ce nom sera utilisé dans toutes les fonctions socket. <Procédure WLangage> : Nom de procédure Cette procédure est appelée une fois que la connexion au serveur a été effectuée. Cette procédure permet par exemple d'envoyer un message au serveur à l'aide de la fonction SocketEcrit. Pour plus de détails sur cette procédure, consultez Paramètres de la procédure utilisée par la fonction WebSocketClientConnecte. ATTENTION : la procédure est appelée dans le thread principal de l'application :- Il est possible d'accéder aux champs de l'UI depuis la procédure.
- Le traitement ne doit pas être trop long au risque de bloquer l'utilisateur.
<Adresse du serveur> : Chaîne de caractères Adresse du poste serveur. Cette adresse peut être donnée sous la forme :- adresse IP au format XXX.XXX.XXX.XXX (par exemple 125.5.110.100).
- URL contenant le nom du serveur (par exemple www.pcsoft.fr). Cette syntaxe est conseillée.
<Port> : Entier optionnel Numéro de port du socket. Par défaut, ce paramètre correspond à 443 (port du HTTPS). <Chemin> : Chaîne de caractères optionnelle Chemin vers l'éventuel répertoire virtuel du serveur. Par défaut ou si ce paramètre vaut chaîne vide (""), ce chemin correspondra à "/". <Protocoles> : Chaîne de caractères optionnelle Liste des protocoles que doit supporter le serveur pour établir la connexion (par exemple : "mqtt,soap"). Dans cette liste, les différents protocoles sont séparés par une virgule (","). Une liste (non exhaustive) des protocoles peut être trouvée ici : https://www.iana.org/assignments/websocket/websocket.xml Classification Métier / UI : Code métier Composante : wd300com.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|