Sinalização — REST

Use a API de sinalização do OpenTok para enviar texto e dados aos clientes conectados a uma sessão do OpenTok.

Uma vez que os terminais dos clientes estejam conectados a uma sessão por meio dos SDKs de cliente da OpenTok, os desenvolvedores podem optar por enviar sinais aos clientes conectados a partir do servidor do aplicativo, em vez de entre os próprios terminais dos clientes. Ao contrário dos recursos de moderação do SDK do JS, a única função da API REST para moderação é oferecer a opção de remover uma conexão de uma sessão.

Este tópico inclui as seguintes seções:

Envio de um sinal para um cliente específico em uma sessão

Envie uma solicitação HTTP POST para o signal recurso de um ID de conexão específico, para um cliente conectado à sessão:

SESSION_ID=SOMESESSIONID CONNECTION_ID=SOMECONNECTIONID API_KEY=123456 # Replace with a JSON web token -- # see /opentok/rest/#authentication: JWT=jwt_token DATA='{"type":"foo","data":"bar"}' curl -v \ -H "Content-Type: application/json" \ -X POST \ -H "X-OPENTOK-AUTH:${JWT}" \ -d "${DATA}" \ https://api.opentok.com/v2/project/${API_KEY}/session/${SESSION_ID}/connection/${CONNECTION_ID}/signal

Envio de um sinal para todos os clientes em uma sessão

Nos dois exemplos de sinal abaixo, o corpo da solicitação será usado para encaminhar tanto o type e data campos. Estes correspondem aos parâmetros de tipo e de dados passados aos manipuladores de sinal do cliente.

Envie uma solicitação HTTP POST para o signal recurso da sessão:

SESSION_ID=SOMESESSIONID API_KEY=123456 # Replace with a JSON web token -- # see /opentok/rest/#authentication: JWT=jwt_token DATA='{"type":"foo","data":"bar"}' curl -v \ -H "Content-Type: application/json" \ -X POST \ -H "X-OPENTOK-AUTH:${JWT}" \ -d "${DATA}" \ https://api.opentok.com/v2/project/${API_KEY}/session/${SESSION_ID}/signal