第三方應用程式和服務的開發人員可以利用 Infuse 強大的視訊播放功能,使用彈性的 URL 方案來播放、加入書籤和下載視訊。 支援 x-回調 也可用,允許在操作完成後返回到另一個應用程式。
可用平台: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 輸入
- 字幕和檔案名稱參數是可選的
- 在使用其中一種建議的檔案命名樣式時,指定檔案名稱有助於提供精確的元資料
- 下載參數可用於開始下載檔案以供離線播放 (0= 僅儲存連結,1= 儲存連結並下載)
- 下載參數適用於整個請求
- x-success 沒有參數
- x-error 會呼叫一次,並返回失敗的 URL (EG 無效連結)
URL 編碼
每一個 x-callback-url 規格,所有 querystring 值都應該是 url-safe 或 encoded。 在某些情況下,未編碼的 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 ID 號碼直接連結至 Infuse 資料庫中的項目。 注意:如果圖庫中沒有標題,則會顯示包含 TMDB 資料的占位符頁面。
連結至電影
infuse://movie/{tmdb_id}連結至電視連續劇
infuse://series/{tmdb_id}連結至電視劇季
infuse://series/{tmdb_id}-{season_number}連結至電視劇集
infuse://series/{tmdb_id}-{season_number}-{episode_number}