Conexiones entre pares

RTCPeerConnection es la interfaz central de la API de WebRTC. Representa la conexión entre el par local y el remoto, y proporciona todas las funciones y los eventos necesarios para establecer la conexión.

Cómo establecer una conexión de pares

Las aplicaciones que implementan la funcionalidad de WebRTC suelen depender en gran medida de la interfaz RTCPeerConnection. Desde el lado de la persona que llama (es decir, el par que inicia una conexión), el proceso para establecer una conexión suele ser el siguiente:

  1. Crea una instancia de RTCPeerConnection nueva con la configuración de ICE adecuada.
  2. Crea una descripción de SDP local con RTCPeerConnection.createOffer().
  3. Establece la descripción del SDP local con RTCPeerConnection.setLocalDescription().
  4. Transfiere (con un servicio de señalización) la descripción del SDP local al par remoto.
  5. Registra un objeto de escucha para los eventos icecandidate en el RTCPeerConnection.
  6. Para cada evento icecandidate, transfiérelo (con un servicio de señalización) al par remoto.
  7. Espera una descripción de SDP remota entrante del servicio de señalización y configúrala con RTCPeerConnection.setRemoteDescription().
  8. Espera a que lleguen candidatos ICE remotos del servicio de señalización y agrégalos con RTCPeerConnection.addIceCandidate().

En el lado del destinatario, el proceso es un poco diferente.

  1. Crea una instancia de RTCPeerConnection nueva con la configuración de ICE adecuada.
  2. Espera una descripción de SDP remota entrante del servicio de señalización y configúrala con RTCPeerConnection.setRemoteDescription().
  3. Llama a RTCPeerConnection.createAnswer() para crear una respuesta para la descripción del SDP remoto.
  4. Transfiere (con un servicio de señalización) la respuesta al par remoto.
  5. Registra un objeto de escucha para los eventos icecandidate en el RTCPeerConnection.
  6. Para cada evento icecandidate, transfiérelo (con un servicio de señalización) al par remoto.
  7. Espera a que lleguen candidatos ICE remotos del servicio de señalización y agrégalos con RTCPeerConnection.addIceCandidate().

El desafío con esta API es que la mayoría de estas operaciones son asíncronas, lo que a menudo complica la implementación real de una aplicación de WebRTC. Muchas de las funciones devuelven un Promise que se debe resolver antes de que pueda continuar el siguiente paso del proceso.

Se recomienda que, cuando se implemente una aplicación con esta API, el desarrollador use async y await en lugar de registrar objetos de escucha (con Promise.then()), ya que esto facilita la comprensión del código. Considera el siguiente ejemplo:

function createAndSendOffer(peerConnection, signallingService) {
    peerConnection.createOffer()
                  .then(offer => {
                      signallingService.send({
                          type: 'offer',
                          data: offer
                      });
                  });
}

Cuando escribimos el código anterior con async y await, obtenemos lo siguiente:

async function createAndSendOffer(peerConnection, signallingService) {
    const offer = await peerConnection.createOffer();
    signallingService.send({
        type: 'offer',
        data: offer
    });
}