Menú Cerrar

Usa la API de Vimeo Live

Este artículo contiene información sobre cómo recuperar detalles sobre eventos en vivo usando la API de Vimeo Live. Hay más detalles disponibles en la referencia de la API.

En este articulo:

Recuperar detalles de un evento recurrente

Durante un evento en vivo, recomendamos incrustar el contenedor del evento en lugar del clip individual subyacente para garantizar que el mismo código incrustado seguirá funcionando al desconectarse/reconectarse.

Use la API para recuperar el contenedor de eventos por ID:

https://api.vimeo.com/live_events/{event_id}

A partir de la respuesta, recupere el código iframe incrustable de incrustar:html

¿Está activado el chat? "chat_enabled" verdadero/falso

Si es verdadero, «chat_embed_code» contiene el código iframe insertable.

Si no recibe una respuesta por ID, la ID puede estar asociada con un evento de una sola vez. Consulte «Recuperar detalles de un videoclip individual o un evento único».

Algunos detalles del contenedor de eventos que puede necesitar saber para su aplicación:

  • «privacidad de transmisión» refleja el nivel de privacidad
  • «incrustar» : «público» , «lista blanca» o «privado». Private no será incrustado por socios
  • «stream_password» refleja la contraseña de la transmisión
  • «insignias» contiene información sobre el clip para informar al jugador:

    • «en vivo» nos dice «transmisión»: verdadero/falso o archivado verdadero/falso
    • «vod» nos dice si es vod o no.

La documentación detallada está disponible en la referencia de la API .

Después del evento: clips dentro de eventos recurrentes

Después del evento, la inserción del reproductor mostrará una de estas tres cosas:

  • El último clip VOD de la sesión anterior
  • Un mensaje de que la (siguiente) transmisión aún no ha comenzado
  • Un nuevo evento, si el evento recurrente se usa para transmitir nuevamente.

La visualización confiable del clip de VOD apropiado requerirá incrustar el clip individual frente al evento. Obtenga la ID y los datos del clip individual de la respuesta de la API de eventos.

El evento recurrente contiene dos objetos relevantes. El objeto al que se hace referencia depende de cuándo está recuperando los datos.

  • live_clips – (después de la transmisión). Una matriz de todos los clips de video completos del evento, que contiene la identificación del video y la marca de tiempo de la época en que se transmitió el evento. 
  • streamable_clip – (antes/durante la transmisión). Este es el clip activo antes/durante una transmisión. La identificación y el código de inserción corresponden al clip individual durante la transmisión, así como al VOD resultante.

Después de que se detiene una transmisión, la información de su clip se mueve a la matriz live_clips, y streamable_clip cambiará, conteniendo la información para el siguiente clip que se transmitirá.

Recuperar detalles de clips de video individuales o un evento único

Puede acceder a un videoclip directamente por ID. Este método se utiliza para acceder a los detalles de un evento único o VOD individual. La ID y la inserción no cambiarán cuando Live se convierta a VOD.

Detalles de un video clip individual:

https://api.vimeo.com/videos/{video_id}
  • «enlace» es la URL
  • «incrustar» contiene propiedades de inserción para el clip
  •  «html» es la fuente de iframe para el clip
  • «insignias» contiene información sobre el clip para informar al jugador:
  • «en vivo» nos dice «transmisión»: verdadero/falso o archivado verdadero/falso
  • «vod» nos dice si es vod o no.
  • «chat_embed_code» es un código de inserción para el chat. Puede heredarse si se trata de un evento en vivo recurrente (RLE).
  • «chat_enabled» es verdadero/falso. Puede heredarse si se trata de un evento en vivo recurrente (RLE).
  • «en vivo» contiene información para la transmisión e incluirá información sobre el contenedor de eventos principal, si corresponde

Los detalles están disponibles en la referencia de la API.