API para aplicaciones y servicios de terceros

Los desarrolladores de aplicaciones y servicios de terceros pueden aprovechar las potentes funciones de reproducción de vídeo de Infuse para reproducir, marcar y descargar vídeos utilizando esquemas de URL flexibles. También es compatible con x-callback , que permite volver a otra aplicación una vez finalizada una acción.

Plataformas disponibles: iPhone, iPad, Apple TV, Mac y Vision

Envío de vídeos a Infuse para su reproducción

Reproducir uno o varios vídeos y volver a otra aplicación al terminar

infuse://x-callback-url/play?url=https://files.firecore.com/infuse/sample-5s-360p.mp4&
filename=Inception-2010.mp4&
sub=https://files.firecore.com/infuse/example.srt&
url=https://files.firecore.com/infuse/mov_bbb.mp4&
filename=Mad-Men-S01-E01.mp4&
sub=https://files.firecore.com/infuse/example2.srt&
x-success=some-app://success&
x-error=some-app://error

Informes de éxito y error

x-success

some-app://success?lastPlayedUrl=https://files.firecore.com/infuse/sample-5s-360p.mp4&
progress=0.33

x-error

some-app://error?errorCode=100&
errorMessage=Unsupported%20content&
failedUrl=invalid_url1&
failedUrl=invalid_url2

Notas

• Admite entradas de url únicas o múltiples
• Los parámetros de subtítulo y nombre de archivo son opcionales
• Especificar un nombre de archivo puede ayudar a proporcionar metadatos precisos cuando se utiliza uno de los estilos de denominación de archivos recomendados
• Todas las URL se reproducen secuencialmente como una lista de reproducción temporal
• x-success no se llama para cada URL individual de la lista, sino una vez cuando finaliza la reproducción de la lista o cuando se cierra el reproductor (devuelve la última URL + progreso 0-1).
• x-error se llama una vez y devuelve URLs fallidas (inválidas o errores de reproducción)

Guardar enlaces en Infuse para su reproducción y/o descarga

Guardar (marcar) una o varias URL de vídeo para reproducirlas más tarde

infuse://x-callback-url/save?
url=https://files.firecore.com/infuse/sample-5s-360p.mp4&
filename=Inception-2010.mp4&
sub=https://files.firecore.com/infuse/example1.srt&
url=https://files.firecore.com/infuse/mov_bbb.mp4&
filename=Mad-Men-S01-E01.mp4&
sub=https://files.firecore.com/infuse/example2.srt&
download=0&
x-success=some-app://success&
x-error=some-app://error

Informes de éxito y error

x-success

some-app://success

x-error

some-app://error?errorCode=100&
errorMessage=Unsupported%20content&
failedUrl=invalid_url1&
failedUrl=invalid_url2

Notas

• Admite entradas de url únicas o múltiples
• Los parámetros de subtítulo y nombre de archivo son opcionales
• Especificar un nombre de archivo puede ayudar a proporcionar metadatos precisos cuando se utiliza uno de los estilos de denominación de archivos recomendados
• El parámetro de descarga puede utilizarse para iniciar la descarga de archivos para su reproducción sin conexión (0=sólo guardar enlace, 1=guardar enlace y descargar)
• El parámetro de descarga se aplica a toda la solicitud
• x-success no tiene parámetros
• x-error se invoca una vez y devuelve URLs fallidas (EG enlaces inválidos)

Codificación URL

Según la especificación x-callback-url, todos los valores de la cadena de consulta deben ser url-safe o estar codificados. Las URL sin codificar pueden funcionar en algunos casos, pero cuando utilice acciones con varios parámetros o URL con varias claves probablemente tendrá que codificar manualmente sus URL.

Ejemplos

URL sin codificar

http://192.168.162.100/Movies/movie.mkv

URL codificada

http%3A%2F%2F192.168.162.100%2FMovies%2Fmovie.mkv

Enlaces profundos a elementos de la biblioteca Infuse

Las aplicaciones pueden enlazarse directamente a elementos de la biblioteca Infuse utilizando los números de ID de TMDB correspondientes. Nota: Si un título no está presente en la biblioteca, se mostrará una página de marcador de posición con datos de la TMDB.

Enlace a una película

infuse://movie/{tmdb_id}

Enlace a una serie de televisión

infuse://series/{tmdb_id}

Enlace a una temporada de una serie de televisión

infuse://series/{tmdb_id}-{season_number}

Enlace a un episodio de una serie de televisión

infuse://series/{tmdb_id}-{season_number}-{episode_number}