API voor apps en services van derden

Ontwikkelaars van apps en diensten van derden kunnen gebruik maken van de krachtige videoweergavefuncties van Infuse om video's af te spelen, van bladwijzers te voorzien en te downloaden met behulp van flexibele URL-schema's. Ondersteuning voor x-callback is ook beschikbaar, wat het mogelijk maakt om terug te keren naar een andere app zodra een actie is voltooid.

Beschikbare platforms: iPhone, iPad, Apple TV, Mac en Vision

Infuse-versie: 8.4.7 (of hoger)

Video's naar Infuse sturen om af te spelen

Een of meer video's afspelen en terugkeren naar een andere app als je klaar bent

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

Succes- en foutrapportage

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

Opmerkingen

• Ondersteunt enkelvoudige of meervoudige url-invoer
• De parameters voor ondertitel, bestandsnaam en positie zijn optioneel
• Het opgeven van een bestandsnaam kan helpen bij het leveren van nauwkeurige metagegevens wanneer een van de aanbevolen bestandsnaamgevingsstijlen wordt gebruikt
• Als je een positie opgeeft (uitgedrukt als een geheel getal in seconden), wordt de video vanaf die positie gestart of hervat
• Alle URL's worden achtereenvolgens afgespeeld als een tijdelijke afspeellijst
• x-success wordt niet voor elke afzonderlijke URL in de lijst aangeroepen, maar slechts één keer wanneer het afspelen van de afspeellijst is voltooid of wanneer de speler wordt gesloten. Geeft de laatste URL + positie (in seconden) weer.
• x-error wordt één keer aangeroepen en retourneert mislukte URL's (ongeldige of weergavefouten)

Koppelingen opslaan in Infuse voor afspelen en/of downloaden

Een of meer video-URL's opslaan (bookmarken) om later af te spelen

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

Succes- en foutrapportage

x-success

some-app://success

x-error

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

Opmerkingen

• Ondersteunt enkelvoudige of meervoudige url-invoer
• Ondertitel- en bestandsnaamparameters zijn optioneel
• Het opgeven van een bestandsnaam kan helpen bij het leveren van nauwkeurige metagegevens wanneer een van de aanbevolen bestandsnaamgevingsstijlen wordt gebruikt
• Download parameter kan worden gebruikt om te beginnen met het downloaden van bestanden voor offline afspelen (0=alleen link opslaan, 1=link opslaan en downloaden)
• Downloadparameter geldt voor het hele verzoek
• x-succes heeft geen parameters
• x-error wordt één keer aangeroepen en retourneert mislukte URL's (EG ongeldige links)

URL-codering

Volgens de x-callback-url specmoeten alle querystringwaarden url-veilig of gecodeerd zijn. Ongecodeerde URL's kunnen in sommige gevallen werken, maar als je acties met meerdere parameters of URL's met meerdere sleutels gebruikt, moet je waarschijnlijk handmatig je URL's coderen.

Voorbeelden

Ongecodeerde URL

http://192.168.162.100/Movies/movie.mkv

Gecodeerde URL

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

Deep Linking naar Infuse-bibliotheekitems

Apps kunnen direct linken naar items in de Infuse-bibliotheek met behulp van de juiste TMDB ID-nummers. Opmerking: Als een titel niet aanwezig is in de bibliotheek, wordt een tijdelijke pagina met TMDB-gegevens weergegeven.

Link naar een film

infuse://movie/{tmdb_id}

Link naar een tv-serie

infuse://series/{tmdb_id}

Link naar een seizoen van een tv-serie

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

Link naar een aflevering van een tv-serie

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

Optioneel

Voeg de parameter ?play toe aan het einde van een deep link om het afspelen van het gekoppelde bibliotheekitem automatisch te starten.

Voorbeeld

infuse://movie/1327819?play