iPlay

简体中文

English
Español

简体中文

English
Español

Appearance

iPlay 协议使用说明 ​

iPlay 支持通过自定义协议调用播放器播放视频，让您可以从浏览器、其他应用或脚本中直接启动 iPlay 播放器。

协议概述 ​

iPlay 提供了两种协议调用方式：

  • 简单替换方式：直接替换视频链接中的 http:// 或 https://
  • 标准协议方式：使用带参数的完整协议格式

两种方式均支持 iplay:// 和 iplays:// 两种协议前缀。

方式一：URL 替换方式 ​

这是最简单直接的使用方式，只需将视频播放链接的协议部分替换即可。

使用方法 ​

将视频地址中的 http:// 或 https:// 替换为 iplay:// 或 iplays://

示例 ​

原始链接替换后的链接
https://example.com/video.mp4iplay://example.com/video.mp4
http://example.com/stream.m3u8iplay://example.com/stream.m3u8
https://cdn.example.com/movie/hd.mp4iplays://cdn.example.com/movie/hd.mp4

使用场景 ​

  • 在浏览器地址栏中快速调用
  • 在网页链接中添加播放按钮
  • 支持流媒体网站视频播放

注意事项 ​

重要：使用此方式需要先下载安装 youtube-dl (yt-dlp)

下载地址：yt-dlp

安装后在 iPlay 设置中配置 yt-dlp 可执行文件路径

方式二：标准协议格式 ​

使用标准的 iPlay 协议格式，支持更多参数和配置选项。

协议格式 ​

iplay://play/any?type=url&url={base64_encoded_url}

参数说明 ​

参数说明必填示例
type播放类型，固定值 url是type=url
urlBase64 编码后的视频地址是url=aHR0cHM6Ly9leGFtcGxlLmNvbS92aWRlby5tcDQ=

完整示例 ​

假设要播放视频：https://example.com/video.mp4

步骤 1：Base64 编码

原始链接: https://example.com/video.mp4
Base64 编码: aHR0cHM6Ly9leGFtcGxlLmNvbS92aWRlby5tcDQ=

步骤 2：构建协议链接

iplay://play/any?type=url&url=aHR0cHM6Ly9leGFtcGxlLmNvbS92aWRlby5tcDQ=

步骤 3：调用播放

在浏览器或应用中打开上述链接，iPlay 将自动启动并播放视频。

使用场景 ​

  • 网页按钮集成
  • 第三方应用调用
  • 自动化脚本批量播放
  • 需要传递复杂 URL 参数的场景

代码示例 ​

JavaScript ​

javascript
// 将 URL 编码为 Base64
function encodeVideoUrl(url) {
  return btoa(url);
}

// 构建 iPlay 协议链接
function buildIPlayUrl(videoUrl) {
  const encoded = encodeVideoUrl(videoUrl);
  return `iplay://play/any?type=url&url=${encoded}`;
}

// 使用示例
const videoUrl = 'https://example.com/video.mp4';
const iplayUrl = buildIPlayUrl(videoUrl);
window.location.href = iplayUrl; // 调用 iPlay 播放

Python ​

python
import base64

def build_iplay_url(video_url):
    """构建 iPlay 协议链接"""
    # Base64 编码
    encoded = base64.b64encode(video_url.encode()).decode()
    # 构建协议链接
    return f"iplay://play/any?type=url&url={encoded}"

# 使用示例
video_url = "https://example.com/video.mp4"
iplay_url = build_iplay_url(video_url)
print(iplay_url)

浏览器使用指南 ​

Windows 平台 ​

  1. 在浏览器地址栏中访问视频链接
  2. 将 http:// 或 https:// 替换为 iplay://
  3. 按下回车键
  4. 浏览器会提示是否允许打开 iPlay，点击"允许"
  5. iPlay 将自动启动并播放视频

浏览器调用示例

macOS 平台 ​

  1. 在浏览器中访问视频链接
  2. 修改协议为 iplay:// 或 iplays://
  3. 按回车键启动 iPlay
  4. 首次使用需要在系统设置中授权

iOS 平台 ​

在 Safari 或其他浏览器中：

  1. 点击包含 iPlay 协议的链接
  2. 系统会询问是否打开 iPlay
  3. 点击"打开"即可开始播放

常见问题 ​

Q: 为什么有 iplay:// 和 iplays:// 两种协议？ ​

A: iplays:// 对应 HTTPS 协议，iplay:// 对应 HTTP 协议。在实际使用中，两者功能相同，可以互换使用。

Q: Base64 编码的优势是什么？ ​

A: Base64 编码可以确保 URL 中的特殊字符（如 &、=、? 等）不会与协议参数冲突，保证链接的准确传递。

Q: 是否支持本地文件播放？ ​

A: 是的，可以使用 file:// 协议的路径进行 Base64 编码后传递。

Q: 如何在网页中添加播放按钮？ ​

A: 可以使用 HTML 链接或 JavaScript 代码：

html
<!-- HTML 方式 -->
<a href="iplay://example.com/video.mp4">使用 iPlay 播放</a>

<!-- JavaScript 方式 -->
<button onclick="playWithIPlay('https://example.com/video.mp4')">
  使用 iPlay 播放
</button>

<script>
function playWithIPlay(url) {
  window.location.href = url.replace(/^https?:\/\//, 'iplay://');
}
</script>

Q: 是否支持播放列表？ ​

A: 目前协议主要支持单个视频播放。如需播放列表功能，建议使用 iPlay 应用内的播放列表功能。

安全说明 ​

  • iPlay 协议调用时，会由系统安全机制进行确认
  • 首次使用时，浏览器或系统会提示是否允许打开外部应用
  • 建议只从可信来源的链接调用 iPlay 协议
  • Base64 编码不是加密，只是编码格式，请勿用于传输敏感信息

技术支持 ​

如果您在使用 iPlay 协议时遇到问题，请访问：

版本支持 ​

iPlay 协议支持从以下版本开始提供：

  • Windows: v1.0.614 Beta+
  • macOS: v1.2.8+
  • iOS: v1.2.8+
  • Android: 待支持