Overview
Developers of third-party apps and services can leverage Infuse's powerful video playback features to play, bookmark, and download videos using flexible URL schemes. Support for x-callback is also available which allows for returning back to another app once an action has been completed.
Available platforms: iPhone, iPad, Apple TV, Mac, and Vision
Usage Examples
Play a single file, and return to another app when finished
infuse://x-callback-url/play?
x-success=some-app://x-callback-url/playbackDidFinish&
x-error=some-app://x-callback-url/playbackDidFail&
url=http://192.168.162.100/Movies/movie.mkv
Play a single file with external subtitles added
infuse://x-callback-url/play?
x-success=some-app://x-callback-url/playbackDidFinish&
x-error=some-app://x-callback-url/playbackDidFail&
url=http://192.168.162.100/Movies/movie.mkv&
sub=http://192.168.162.100/Movies/movie.srt
Save (bookmark) a video URL to play later
infuse://x-callback-url/save?
x-success=some-app://x-callback-url/playbackDidFinish&
x-error=some-app://x-callback-url/playbackDidFail&
url=http://192.168.162.100/Movies/movie.mkv
Save (bookmark) a video URL and begin downloading it (iOS/macOS/visionOS only)
infuse://x-callback-url/save?
x-success=some-app://x-callback-url/playbackDidFinish&
x-error=some-app://x-callback-url/playbackDidFail&
url=http://192.168.162.100/Movies/movie.mkv&
download=1
URL Encoding
Per the x-callback-url spec, all querystring values should be url-safe or encoded. Unencoded URLs may work in some cases, but when using actions with multiple parameters or URLs with multiple keys you will probably need to manually encode your URLs.
Examples
Unencoded URL
http://192.168.162.100/Movies/movie.mkv
Encoded URL
http%3A%2F%2F192.168.162.100%2FMovies%2Fmovie.mkv