API per applicazioni e servizi di terze parti

Gli sviluppatori di applicazioni e servizi di terze parti possono sfruttare le potenti funzioni di riproduzione video di Infuse per riprodurre, inserire nei preferiti e scaricare video utilizzando schemi URL flessibili. È disponibile anche il supporto per x-callback , che consente di tornare a un'altra applicazione al termine di un'azione.

Piattaforme disponibili: iPhone, iPad, Apple TV, Mac e Vision

Invio di video a Infuse per la riproduzione

Riprodurre uno o più video e tornare a un'altra applicazione una volta terminati

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

Segnalazione dei successi e degli errori

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

Note

• Supporta voci di url singole o multiple
• I parametri Sottotitolo e Nome file sono facoltativi.
• Specificare un nome di file può aiutare a fornire metadati accurati quando si utilizza uno degli stili di denominazione dei file consigliati
• Tutti gli URL vengono riprodotti in sequenza come una playlist temporanea.
• x-success non viene richiamato per ogni singolo URL dell'elenco, ma una sola volta quando la riproduzione della playlist termina o quando il lettore viene chiuso (restituisce l'ultimo URL + il progresso 0-1).
• x-error viene richiamato una volta e restituisce gli URL falliti (errori non validi o di riproduzione).

Salvataggio dei link in Infuse per la riproduzione e/o il download

Salvare (segnalibro) uno o più URL video da riprodurre in seguito

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

Segnalazione dei successi e degli errori

x-success

some-app://success

x-error

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

Note

• Supporta voci di url singole o multiple
• I parametri Sottotitolo e Nome file sono facoltativi.
• Specificare un nome di file può aiutare a fornire metadati accurati quando si utilizza uno degli stili di denominazione dei file consigliati
• Il parametro Download può essere utilizzato per iniziare a scaricare i file per la riproduzione offline (0=salva solo il link, 1=salva il link e scarica).
• Il parametro Download si applica all'intera richiesta
• x-success non ha parametri
• x-error viene richiamato una volta e restituisce gli URL falliti (link non validi di EG).

Codifica URL

Secondo la specifica x-callback-url, tutti i valori delle querystring devono essere url-safe o codificati. Gli URL non codificati possono funzionare in alcuni casi, ma quando si utilizzano azioni con più parametri o URL con più chiavi, probabilmente sarà necessario codificare manualmente gli URL.

Esempi

URL non codificato

http://192.168.162.100/Movies/movie.mkv

URL codificato

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

Collegamento profondo agli elementi della libreria Infuse

Le applicazioni possono collegarsi direttamente agli elementi della libreria Infuse utilizzando i numeri ID TMDB appropriati. Nota: se un titolo non è presente nella biblioteca, verrà visualizzata una pagina segnaposto con i dati TMDB.

Collegamento a un film

infuse://movie/{tmdb_id}

Collegamento a una serie TV

infuse://series/{tmdb_id}

Collegamento a una stagione della serie TV

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

Collegamento a un episodio della serie TV

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