Skip to content

Publicación WebRTC por WHIP

WHIP envía vídeo y audio de un codificador a Agora por WebRTC. Esta guía utiliza el stream studio; después de publicar, puede verlo por WHEP.

Prepare el stream

  1. En Streams, cree o abra studio. En Fuentes, añada una entrada Publish y guarde.
  2. En Layout, localice el streamer que ejecuta el stream. WHIP necesita su dirección HTTP(S) accesible.
  3. Configure un token de publicación permitido en auth.publish_tokens mediante central, o autorice la publicación con el backend. Entregue el token al emisor. Los permisos de publicación y reproducción son independientes.

Compruebe la red

Puede dejar vacíos los puertos WebRTC del streamer: el servicio elige un puerto UDP libre. Si la red limita los puertos entrantes, configure uno fijo, por ejemplo 5005, y permita UDP desde el codificador y los espectadores. Un proxy HTTPS no transporta por sí solo los medios UDP.

Detrás de NAT, los candidatos ICE deben anunciar una dirección accesible para el cliente. La selección automática de puerto no añade una dirección pública ni TURN. Consulte la referencia de red de Sapsan.

Conecte el emisor

En OBS Studio, abra Settings → Stream y configure:

  • Service: WHIP.
  • Server: https://streamer.example.com/streaming/whip/studio.
  • Bearer Token: el token de publicación.

Los campos se describen en la guía de OBS. Sustituya streamer.example.com por la dirección del streamer receptor. Si un proxy termina HTTPS, debe reenviar /streaming/whip/ a ese streamer.

Seleccione vídeo H.264 y audio Opus e inicie la transmisión. AV1 también está disponible si lo admiten el emisor y los espectadores. Utilice una sola codificación de vídeo; el servidor no construye una escalera ABR a partir de simulcast WHIP.

Verifique la publicación

Abra la ficha del stream: la entrada Publish debe recibir datos, y la información multimedia debe mostrar vídeo y, si se transmite audio, Opus. Después, conecte un reproductor WHEP.

Un stream acepta un emisor WHIP activo. Detenga la transmisión antes de cambiar de emisor. Tras una desconexión, el emisor debe reconectarse; se aplican las reglas de respaldo.

Si falla la conexión

Síntoma Comprobación
403 Token y permiso de publicación.
404 Nombre del stream, estado y streamer elegido.
409 Entrada Publish guardada y libre; otro emisor puede estar utilizándola.
400 o 415 SDP y códecs: vídeo H.264/AV1 y audio Opus.
501 en PATCH Desactive Trickle ICE y reinicio ICE: el servicio acepta SDP inicial completo.
HTTP funciona, pero no llegan medios Acceso UDP y dirección ICE del streamer.

Referencia

Contrato WHIP y limitaciones.