API для сторонних приложений и сервисов

Разработчики сторонних приложений и сервисов могут использовать мощные функции воспроизведения видео Infuse для воспроизведения, создания закладок и загрузки видео с помощью гибких схем URL. Также появилась поддержка x-callback , которая позволяет вернуться в другое приложение после выполнения действия.

Доступные платформы: iPhone, iPad, Apple TV, Mac и Vision

Отправка видео в Infuse для воспроизведения

Воспроизведение одного или нескольких видео и возврат к другому приложению по завершении.

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

Отчеты об успехах и ошибках

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

Примечания

• Поддерживает ввод одного или нескольких url
• Параметры субтитров и имени файла являются необязательными
• Указание имени файла может помочь предоставить точные метаданные при использовании одного из рекомендуемых стилей именования файлов
• Все URL-адреса воспроизводятся последовательно в виде временного списка воспроизведения
• x-success вызывается не для каждого отдельного URL в списке, а один раз при завершении воспроизведения плейлиста или при закрытии плеера (возвращается последний URL + прогресс 0-1).
• x-error вызывается один раз и возвращает неудачные URL (недействительные или с ошибками воспроизведения).

Сохранение ссылок в Infuse для воспроизведения и/или загрузки

Сохраните (закладка) один или несколько URL-адресов видео, чтобы воспроизвести их позже

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

Отчеты об успехах и ошибках

x-success

some-app://success

x-error

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

Примечания

• Поддерживает ввод одного или нескольких url
• Параметры субтитров и имени файла являются необязательными
• Указание имени файла может помочь предоставить точные метаданные при использовании одного из рекомендуемых стилей именования файлов
• Параметр Download может использоваться для начала загрузки файлов для автономного воспроизведения (0= только ссылка на сохранение, 1= ссылка на сохранение и загрузка)
• Параметр загрузки применяется ко всему запросу
• x-success не имеет параметров
• x-error вызывается один раз и возвращает неудачные URL (недействительные ссылки EG)

Кодировка URL

Согласно спецификации x-callback-url, все значения строк запросов должны быть url-safe или закодированы. В некоторых случаях некодированные URL могут работать, но при использовании действий с несколькими параметрами или URL с несколькими ключами вам, вероятно, придется вручную кодировать ваши URL.

Примеры

URL без кодировки

http://192.168.162.100/Movies/movie.mkv

Кодированный URL

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

Глубокие ссылки для включения элементов библиотеки

Приложения могут напрямую ссылаться на элементы в библиотеке Infuse, используя соответствующие идентификационные номера TMDB. Примечание: Если название отсутствует в библиотеке, будет показана страница-заглушка с данными TMDB.

Ссылка на фильм

infuse://movie/{tmdb_id}

Ссылка на телесериал

infuse://series/{tmdb_id}

Ссылка на сезон телесериала

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

Ссылка на эпизод телесериала

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