API pour les applications et services tiers

Les développeurs d'applications et de services tiers peuvent exploiter les puissantes fonctions de lecture vidéo d'Infuse pour lire, mettre en signet et télécharger des vidéos à l'aide de schémas d'URL flexibles. La prise en charge de x-callback est également disponible, ce qui permet de revenir à une autre application une fois qu'une action a été effectuée.

Plateformes disponibles : iPhone, iPad, Apple TV, Mac et Vision

Envoi de vidéos à Infuse pour lecture

Lire une ou plusieurs vidéos et revenir à une autre application une fois la lecture terminée

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

Rapports de réussite et d'erreur

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

Notes

• Prise en charge d'entrées d'url simples ou multiples
• Les paramètres sous-titre et nom de fichier sont facultatifs.
• La spécification d'un nom de fichier peut aider à fournir des métadonnées précises lors de l'utilisation de l'un des styles de dénomination de fichier recommandés
• Tous les URL sont lus séquentiellement sous la forme d'une liste de lecture temporaire.
• x-success n'est pas appelé pour chaque URL de la liste, mais une fois lorsque la lecture de la liste de lecture se termine ou lorsque le lecteur est fermé (renvoie la dernière URL + la progression 0-1).
• x-error est appelé une fois et renvoie les URLs qui ont échoué (erreurs invalides ou de lecture)

Sauvegarde de liens dans Infuse pour la lecture et/ou le téléchargement

Enregistrer (signet) une ou plusieurs URL vidéo pour les lire plus tard

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

Rapports de réussite et d'erreur

x-success

some-app://success

x-error

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

Notes

• Prise en charge d'entrées d'url simples ou multiples
• Les paramètres sous-titre et nom de fichier sont facultatifs.
• La spécification d'un nom de fichier peut aider à fournir des métadonnées précises lors de l'utilisation de l'un des styles de dénomination de fichier recommandés
• Le paramètre de téléchargement peut être utilisé pour commencer à télécharger des fichiers pour une lecture hors ligne (0=lien de sauvegarde uniquement, 1=lien de sauvegarde et téléchargement).
• Le paramètre de téléchargement s'applique à l'ensemble de la demande
• x-success n'a pas de paramètres
• x-error est appelé une fois et renvoie les URL qui ont échoué (liens invalides EG)

Codage de l'URL

Conformément à la spécification x-callback-url, toutes les valeurs des chaînes de requête doivent être sûres ou codées. Les URL non codées peuvent fonctionner dans certains cas, mais lorsque vous utilisez des actions avec des paramètres multiples ou des URL avec des clés multiples, vous devrez probablement coder manuellement vos URL.

Exemples

URL non codé

http://192.168.162.100/Movies/movie.mkv

URL codé

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

Des liens profonds pour enrichir les documents de la bibliothèque

Les applications peuvent renvoyer directement aux éléments de la bibliothèque Infuse en utilisant les numéros d'identification TMDB appropriés. Note : Si un titre n'est pas présent dans la bibliothèque, une page de remplacement avec les données de la BDMT sera affichée.

Lien vers un film

infuse://movie/{tmdb_id}

Lien vers une série télévisée

infuse://series/{tmdb_id}

Lien vers une saison de série télévisée

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

Lien vers un épisode de série télévisée

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