第三方应用程序和服务的 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 将作为临时播放列表依次播放
  • 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}
分享这篇文章

这篇文章有帮助吗?

126 人中有 80 人觉得有帮助

还有其它问题?提交请求