API til tredjepartsapps og -tjenester

Udviklere af tredjepartsapps og -tjenester kan udnytte Infuses kraftfulde videoafspilningsfunktioner til at afspille, bogmærke og downloade videoer ved hjælp af fleksible URL-skemaer. Understøttelse af x-callback er også tilgængelig, hvilket gør det muligt at vende tilbage til en anden app, når en handling er afsluttet.

Tilgængelige platforme: iPhone, iPad, Apple TV, Mac og Vision

Afsendelse af videoer til Infuse til afspilning

Afspil en eller flere videoer, og vend tilbage til en anden app, når du er færdig

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

Rapportering af succes og fejl

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

Noter

• Understøtter enkelte eller flere url-indgange
• Parametre for undertekst og filnavn er valgfrie
• At angive et filnavn kan hjælpe med at give nøjagtige metadata, når man bruger en af de anbefalede filnavngivningsstile
• Alle URL'er afspilles sekventielt som en midlertidig afspilningsliste
• x-success kaldes ikke for hver enkelt URL på listen, men én gang, når afspilningen af afspilningslisten slutter, eller når afspilleren lukkes (returnerer sidste URL + fremskridt 0-1).
• x-error kaldes én gang og returnerer mislykkede URL'er (ugyldige eller afspilningsfejl)

Gemme links i Infuse til afspilning og/eller download

Gem (bogmærke) en eller flere video-URL'er til senere afspilning

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

Rapportering af succes og fejl

x-success

some-app://success

x-error

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

Noter

• Understøtter enkelte eller flere url-indgange
• Parametre for undertekst og filnavn er valgfrie
• At angive et filnavn kan hjælpe med at give nøjagtige metadata, når man bruger en af de anbefalede filnavngivningsstile
• Download-parameter kan bruges til at begynde at downloade filer til offlineafspilning (0=kun gemme link, 1=gemme link og downloade)
• Download-parameter gælder for hele anmodningen
• x-success har ingen parametre
• x-error kaldes én gang og returnerer mislykkede URL'er (EG ugyldige links)

URL-kodning

I henhold til x-callback-url spec, skal alle querystring-værdier være url-sikre eller kodede. Ukodede URL'er kan fungere i nogle tilfælde, men når du bruger handlinger med flere parametre eller URL'er med flere nøgler, bliver du sandsynligvis nødt til manuelt at kode dine URL'er.

Eksempler

Ukodet URL

http://192.168.162.100/Movies/movie.mkv

Kodet URL

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

Deep linking til Infuse-bibliotekselementer

Apps kan linke direkte til elementer i Infuse-biblioteket ved hjælp af de relevante TMDB-id-numre. Bemærk: Hvis en titel ikke findes i biblioteket, vises en pladsholderside med TMDB-data.

Link til en film

infuse://movie/{tmdb_id}

Link til en tv-serie

infuse://series/{tmdb_id}

Link til en sæson af en tv-serie

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

Link til et afsnit af en tv-serie

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