Google is committed to advancing racial equity for Black communities. See how.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Canais de dados

O padrão WebRTC também abrange uma API para enviar dados arbitrários por um RTCPeerConnection . Isso é feito chamando createDataChannel() em um objeto RTCPeerConnection , que retorna um objeto RTCDataChannel .

 const peerConnection = new RTCPeerConnection(configuration);
const dataChannel = peerConnection.createDataChannel();
 

O peer remoto pode receber canais de dados, ouvindo para o datachannel evento no RTCPeerConnection objeto. O evento recebido é do tipo RTCDataChannelEvent e contém uma propriedade de channel que representa o RTCDataChannel conectado entre os pares.

 const peerConnection = new RTCPeerConnection(configuration);
peerConnection.addEventListener('datachannel', event => {
    const dataChannel = event.channel;
});
 

Abrir e fechar eventos

Antes que um canal de dados possa ser usado para enviar dados, o cliente precisa aguardar até que seja aberto. Isso é feito ouvindo o evento open . Da mesma forma, há um evento de close para quando um dos lados fecha o canal.

 const messageBox = document.querySelector('#messageBox');
const sendButton = document.querySelector('#sendButton');
const peerConnection = new RTCPeerConnection(configuration);
const dataChannel = peerConnection.createDataChannel();

// Enable textarea and button when opened
dataChannel.addEventListener('open', event => {
    messageBox.disabled = false;
    messageBox.focus();
    sendButton.disabled = false;
});

// Disable input when closed
dataChannel.addEventListener('close', event => {
    messageBox.disabled = false;
    sendButton.disabled = false;
});
 

Mensagens

O envio de uma mensagem em um RTCDataChannel é feito chamando a função send() com os dados que queremos enviar. O parâmetro de data para esta função pode ser uma sequência, um Blob , um ArrayBuffer ou ArrayBufferView .

 const messageBox = document.querySelector('#messageBox');
const sendButton = document.querySelector('#sendButton');

// Send a simple text message when we click the button
sendButton.addEventListener('click', event => {
    const message = messageBox.textContent;
    dataChannel.send(message);
})
 

O ponto remoto receberá mensagens enviadas em um RTCDataChannel ouvindo o evento da message .

 const incomingMessages = document.querySelector('#incomingMessages');

const peerConnection = new RTCPeerConnection(configuration);
const dataChannel = peerConnection.createDataChannel();

// Append new messages to the box of incoming messages
dataChannel.addEventListener('message', event => {
    const message = event.data;
    incomingMessages.textContent += message + '\n';
});