API für Anwendungen und Dienste von Drittanbietern

Entwickler von Anwendungen und Diensten von Drittanbietern können die leistungsstarken Videowiedergabefunktionen von Infuse zum Abspielen, Setzen von Lesezeichen und Herunterladen von Videos mit flexiblen URL-Schemata nutzen. Unterstützung für x-callback ist ebenfalls verfügbar und ermöglicht die Rückkehr zu einer anderen Anwendung, sobald eine Aktion abgeschlossen ist.

Verfügbare Plattformen: iPhone, iPad, Apple TV, Mac und Vision

Senden von Videos an Infuse zur Wiedergabe

Ein oder mehrere Videos abspielen und nach Abschluss zu einer anderen Anwendung zurückkehren

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

Erfolgs- und Fehlerberichte

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

Anmerkungen

• Unterstützt einzelne oder mehrere Url-Einträge
• Die Parameter Untertitel und Dateiname sind optional
• Die Angabe eines Dateinamens kann helfen, genaue Metadaten bereitzustellen, wenn einer der empfohlenen Dateinamensstile verwendet wird
• Alle URLs werden nacheinander als temporäre Wiedergabeliste abgespielt
• x-success wird nicht für jede einzelne URL in der Liste aufgerufen, sondern einmal, wenn die Wiedergabe der Wiedergabeliste endet oder wenn der Player geschlossen wird (gibt die letzte URL + Fortschritt 0-1 zurück).
• x-error wird einmal aufgerufen und liefert fehlgeschlagene URLs (ungültige oder Wiedergabefehler)

Speichern von Links in Infuse zur Wiedergabe und/oder zum Herunterladen

Speichern (Lesezeichen) einer oder mehrerer Video-URLs zur späteren Wiedergabe

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

Erfolgs- und Fehlerberichte

x-success

some-app://success

x-error

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

Anmerkungen

• Unterstützt einzelne oder mehrere Url-Einträge
• Die Parameter Untertitel und Dateiname sind optional
• Die Angabe eines Dateinamens kann helfen, genaue Metadaten bereitzustellen, wenn einer der empfohlenen Dateinamensstile verwendet wird
• Der Download-Parameter kann verwendet werden, um das Herunterladen von Dateien für die Offline-Wiedergabe zu starten (0=nur Link speichern, 1=Link speichern und herunterladen)
• Download-Parameter gilt für die gesamte Anfrage
• x-success hat keine Parameter
• x-error wird einmal aufgerufen und liefert fehlgeschlagene URLs (EG ungültige Links)

URL-Kodierung

Gemäß der x-callback-url specsollten alle Querystring-Werte url-safe oder kodiert sein. Unkodierte URLs können in einigen Fällen funktionieren, aber wenn Sie Aktionen mit mehreren Parametern oder URLs mit mehreren Schlüsseln verwenden, müssen Sie wahrscheinlich Ihre URLs manuell kodieren.

Beispiele

Unverschlüsselte URL

http://192.168.162.100/Movies/movie.mkv

Kodierte URL

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

Deep Linking zu Infuse Library-Elementen

Anwendungen können über die entsprechenden TMDB-ID-Nummern direkt mit Elementen in der Infuse-Bibliothek verknüpft werden. Hinweis: Wenn ein Titel nicht in der Bibliothek vorhanden ist, wird eine Platzhalterseite mit TMDB-Daten angezeigt.

Link zu einem Film

infuse://movie/{tmdb_id}

Link zu einer TV-Serie

infuse://series/{tmdb_id}

Link zu einer TV-Serien-Staffel

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

Link zu einer TV-Serienepisode

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