Esta función requiere un plan de Vimeo Enterprise.
Este artículo contiene información sobre la recuperación de detalles sobre eventos en vivo utilizando la API de Vimeo Live. Encontrarás más detalles en Referencia de API.
En este artículo:
- Recuperar detalles para un evento recurrente
- Después del evento: Clips dentro de los eventos recurrentes
- Recuperar detalles de los clips de video individuales o de un evento único
Recuperar detalles para un evento recurrente
Durante un evento en vivo, se recomienda insertar el contenedor del evento en lugar del clip individual subyacente para garantizar que el mismo código de inserción siga funcionando tras desconectar/reconectar.
Utiliza la API para recuperar el contenedor de eventos por identificación:
https://api.vimeo.com/live_events/{event_id}
De la respuesta, luego recupera el código iframe insertable de embed:html
¿Está habilitado el chat? "chat_enabled" verdadero/falso
Si es cierto, "chat_embed_code" contiene el código iframe incrustable.
Si no recibes una respuesta por identificación, la identificación puede estar asociada a un evento único. Consulta "Recuperar detalles para un videoclip individual o un evento único".
Algunos detalles del contenedor de eventos que puedes necesitar conocer para tu aplicación:
- "stream privacy" refleja el nivel de privacidad
- "embed": "public","whitelist" o "private". Si es privado, no será insertable por parte de los socios
- "stream_password" refleja la contraseña de la transmisión
- "badges" contiene información sobre el clip para informar al reproductor:
- "live" indica "transmisión":verdadero/falso o archivado verdadero/falso
- "vod" indica si es vod o no.
Encontrarás documentación detallada en Referencia de API.
Después del evento: Clips dentro de los eventos recurrentes
Después del evento, el reproductor insertado mostrará una de estas tres cosas:
- el último clip VOD de la sesión anterior;
- un mensaje de que la (siguiente) transmisión no ha comenzado todavía;
- un nuevo evento, si el evento recurrente se utiliza para volver a transmitirse.
Para poder mostrar de forma fiable el clip de VOD adecuado, será necesario insertar el clip individual en función del evento. Obtén la ID y los datos del clip individual a partir de la respuesta de la API de eventos.
El evento recurrente contiene dos objetos relevantes. El objeto de referencia depende del momento en que se recuperan los datos.
- live_clips - (después de la transmisión). Un conjunto de todos los clips de video completados del evento, que contiene la ID del video y la marca de tiempo de la época en que se transmitió el evento.
- streamable_clip (antes de la transmisión/durante esta). Este es el clip activo antes de la transmisión o durante esta. La id y el código de inserción corresponden al clip individual durante la transmisión, así como para el VOD resultante.
Después de que se detiene una transmisión, su información de clip se mueve en la selección live_clips, y cambiará streamable_clip que contendrá la información del siguiente clip para la transmisión.
Recuperar detalles de los clips de video individuales o de un evento único
Puedes acceder a un clip de video directamente por la identificación. Este método se utiliza para acceder a los detalles de un evento de una sola vez o un VOD individual. La ID y el código de inserción no cambiarán cuando el video en vivo se convierta en VOD.
Detalles de un clip de video individual:
https://api.vimeo.com/videos/{video_id}
- "link" es la url
- "embed" contiene las propiedades de incrustación para el clip
- " html" es la fuente de iframe para el clip
- "badges" contiene información sobre el clip para informar al reproductor:
- "live" indica "transmisión":verdadero/falso o archivado verdadero/falso
- "vod" indica si es vod o no.
- "chat_embed_code" es el código de inserción del chat. Puede ser heredado si el evento en vivo es recurrente (RLE).
- "chat_enabled" es verdadero/falso. Puede ser heredado si el evento en vivo es recurrente (RLE).
- "live" contiene información para la transmisión, e incluirá información sobre el contenedor del evento padre, si lo hubiera.
Los detalles están disponibles en Referencia de API.