サードパーティのアプリやサービスの開発者は、Infuseの強力な動画再生機能を活用し、柔軟なURLスキームを使用して動画を再生、ブックマーク、ダウンロードすることができます。 また、 x-callback のサポートもあり、アクションが完了したら別のアプリに戻ることができる。
利用可能なプラットフォーム：iPhone、iPad、Apple TV、Mac、Vision
インフューズにビデオを送って再生する
1つまたは複数のビデオを再生し、終了したら別のアプリに戻る
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ごとに呼び出されるのではなく、プレイリストの再生が終了したとき、またはプレーヤーが閉じられたときに1回呼び出されます（最後のURL + プログレス0-1を返します）。
- x-errorは一度だけ呼び出され、失敗したURL（無効または再生エラー）を返す。
Infuseにリンクを保存して再生やダウンロードを行う
後で再生するために1つまたは複数のビデオ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 specに従い、すべてのクエリストリング値は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インフューズ・ライブラリー項目へのディープリンク
アプリは、適切なTMDB ID番号を使用して、インフューズ・ライブラリのアイテムに直接リンクすることができます。 注：タイトルがライブラリに存在しない場合、TMDBデータのプレースホルダページが表示されます。
映画へのリンク
infuse://movie/{tmdb_id}テレビシリーズへのリンク
infuse://series/{tmdb_id}TVシリーズシーズンへのリンク
infuse://series/{tmdb_id}-{season_number}テレビシリーズのエピソードへのリンク
infuse://series/{tmdb_id}-{season_number}-{episode_number}