Gestión de episodios¶
media.episodes.management
Un episodio vincula un evento con un stream y un tiempo del vídeo. media.episodes.management abarca gestión, almacenamiento y acceso a episodios; es una función por stream de la tarifa existente.
Central guarda el último estado del episodio y sus imágenes en PostgreSQL. El recolector recibe actualizaciones de los streamers; la API de gestión lee el historial guardado sin necesitar que el streamer de origen esté disponible. El payload de origen y las anotaciones externas de meta se guardan por separado.
Lectura¶
GET /central/api-v4/episodes devuelve una selección conjunta; GET /central/api-v4/episodes/{episode_id} lee un episodio. Los filtros de stream, tipo y tiempo se combinan con el filtro JSON meta. Siga next_cursor; el límite predeterminado es 100 y el máximo 1000. Offset está prohibido.
El acceso de espectadores usa /playback/v/{stream_name}/episodes en central y /streaming/v/{stream_name}/episodes en un streamer. Central sirve el historial guardado; el streamer, su ventana actual en memoria. Se aplican los permisos y tokens de reproducción habituales del stream. Leer episodios e imágenes no crea ni renueva una sesión de visualización.
Para ejemplos de creación, actualización de meta y búsqueda, consulte el manual de Optic. La retención se describe en Archivo de episodios.