第三方应用程序和服务的开发人员可以利用 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 将作为临时播放列表依次播放
- 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
说明
- 支持单个或多个网址条目
- 字幕和文件名参数为可选参数
- 在使用推荐的文件命名方式时,指定文件名有助于提供准确的元数据
- 下载参数可用于开始下载文件以供离线播放(0=仅保存链接,1=保存链接并下载)。
- 下载参数适用于整个请求
- x-success 没有参数
- x-error 被调用一次,并返回失败的 URL(EG 无效链接)
URL 编码
根据 x-callback-url 规范,所有参数值都应采用安全 url 或 Encode 编码。 在某些情况下,未编码的 URL 可能有效,但在使用带有多个参数的操作或带有多个键的 URL 时,您可能需要 手动对 URL 进行 Encode 编码。
实例
未编码的 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}