API til tredjepartsapps og -tjenester

Udviklere af tredjepartsapps og -tjenester kan udnytte Infuses avancerede funktioner til videoafspilning til at afspille, markere med bogmærker, downloade og overvåge afspilningsstatus 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

Infuse-version: 8.4.7 (eller nyere)

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&
position=0&
filename=Inception-2010.mp4&
sub=https://files.firecore.com/infuse/example.srt&
url=https://files.firecore.com/infuse/mov_bbb.mp4&
position=6&
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/mov_bbb.mp4&
position=8

x-error

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

Noter

• Understøtter enkelte eller flere url-indgange
• Parametrene for undertekst, filnavn og placering er valgfri
• At angive et filnavn kan hjælpe med at give nøjagtige metadata, når man bruger en af de anbefalede filnavngivningsstile
• Hvis du angiver en positionsværdi (udtrykt som et heltal i sekunder), vil videoen starte/fortsætte fra den angivne position
• Alle URL'er afspilles sekventielt som en midlertidig afspilningsliste
• x-success udløses ikke for hver enkelt URL på listen, men kun én gang, når afspilningen af afspilningslisten slutter, eller når afspilleren lukkes. Returnerer den seneste URL + position (i sekunder).
• 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}

Valgfrit

Føj parameteren ?play til slutningen af et dybt link for automatisk at starte afspilningen af det linkede biblioteksemne.

Eksempel

infuse://movie/1327819?play

Status for det, der afspilles lige nu

Infuse kan gøre en skrivebeskyttet »Now Playing«-tjeneste tilgængelig på det lokale netværk, så andre apps kan se, hvad der lige nu afspilles – uanset kilden (NAS, Plex, Jellyfin osv.). Dette gør det muligt for andre tredjepartsapps eller -tjenester at hente oplysninger om, hvad der afspilles i Infuse på et givet tidspunkt.

Bemærk: Funktionen er som standard deaktiveret, men kan aktiveres i Infuse > Indstillinger > Afspilning > API for »Afspiller nu«. Kræver Infuse 8.5.9 eller nyere.

Opdagelse

Endepunkt

GET /nowplaying
HTTP/1.1, unencrypted, Connection: close
200 + JSON body; 400 malformed request; 404 any other method/path

Svarfelter

Eksempel

{
  "state": "playing" | "paused" | "idle",
  "positionSeconds": double | null,
  "durationSeconds": double | null,
  "item": {
    "kind": "movie" | "episode",
    "tmdbID": string | null,
    "imdbID": string | null,
    "tvdbID": string | null,
    "season": int | null,
    "episode": int | null,
    "title": string | null,
    "seriesTitle": string | null
  } | null
}

Varefelter