Envia uma mensagem de texto para um servidor websocket, cuja conexão foi estabelecida com o bloco Conectar-se a Websocket.

Figura 1 - Bloco Enviar Mensagem por Websocket

Compatibilidade

• Bloco servidor: cronapi.net.WebSocket.send()

Retorno

O bloco não possui retorno.

Parâmetros

Websocket

Objeto com a referência de conexão criada com o bloco Conectar-se a Websocket.

• Posição: 1
• Inglês: Websocket
• Tipo: Objeto / Object
• Exemplo: retorno do bloco Conectar-se a Websocket

Mensagem

Mensagem que será enviada para o Servidor Websocket.

• Posição: 2
• Inglês: Message
• Tipo: Texto / Text
• Exemplo: "Minha mensagem para o servidor Websocket!"

Exemplo

No exemplo abaixo, estamos utilizando o serviço do PieHost que possui um servidor WebSocket de testes e uma ferramenta de envio de mensagem, que dispara a mensagem enviada para todos os clientes conectados ao servidor. Acesse o site e crie uma conta para obter a chave de API que será utilizada para configurar o bloco.

Após criar a conta, acesse a aba "PieSocket" (destaque 1 da figura 2) e, em seguida, dê um nome ao cluster que será utilizado (2). Role até o final da página e clique em "create cluster".

Figura 2 - Criando o cluster

Após criar o cluster, clique em API Keys (destaque 1 da figura 2.1).

Figura 2.1 - Obtendo a chave da API

Role a página até o final e clique no botão Teste Online, isso fará com que a ferramenta de testes do PieSocket seja exibida com a chave da API colada na caixa de texto. Em seguida, clique em "Connect". Como mostra a figura 2.2, copie a chave exibida no campo de texto e cole no parâmetro "Servidor" do bloco da função da figura 2.3.

Figura 2.2 - Ferramenta de envio de mensagem do PieSocket.

A função da figura 2.3 conecta-se ao servidor PieSocket e gera um objeto com a referência da conexão na variável "ws", o conteúdo dessa variável será usado nos blocos Enviar Mensagem por Websocket e Fechar Websocket. Essa função deve ser associada ao evento Ao Clicar de um componente botão inserido em uma view.

Figura 2.3 - Função que inicia a conexão e se comunica com o servidor

Feita a conexão, o bloco Conectar-se a Websocket fica aguardando a resposta do servidor para executar as ações definidas nas entradas de comando do bloco:

• Servidor: endereço do servidor Websocket.
• Ao Conectar: após a conexão com o servidor WebSocket ser estabelecida com sucesso, o bloco Enviar Mensagem por Websocket é acionado automaticamente. Ele utiliza o objeto de conexão (variável "ws") para transmitir ao servidor o conteúdo armazenado na variável "msg". Essa ação inicia a comunicação bidirecional em tempo real, garantindo que os dados sejam enviados imediatamente após a confirmação de uma conexão estável.
• Ao Receber Mensagem: toda mensagem recebida do servidor executará essa entrada de comando. Neste exemplo estamos imprimindo no console todas as mensagens recebidas até que o conteúdo da mensagem seja "Fechar", aí o bloco Fechar Websocket será chamado e fechará a conexão com o servidor.
• Ao Apresentar Erro: se um erro ocorrer, o usuário será notificado do erro.

Execute a aplicação e acione o botão contendo a função da figura 2.3.

Figura 2.4 - Acionando a função

Após o acionamento do botão, a mensagem contida na variável "msg" é disparada e exibida na ferramenta do PieSocket. 

Figura 2.5 - Mensagem recebida no servido enviada da função da figura 2.3