# H5 AFMAX Universal Player 公共版 完整使用说明（含调用+规则+多用途）

## 一、核心介绍

H5 AFMAX Universal Player 是一款 公共免费的在线视频播放器，支持跨域访问、第三方嵌入/跳转播放，无需注册登录，直接通过URL参数调用即可使用。核心优势：

- 无域名限制：支持播放任意合法第三方视频/字幕资源（仅限制文件格式）；

- 多格式兼容：覆盖主流视频、字幕、流媒体格式；

- 灵活调用：支持单个视频、多集播放、定时播放、自定义Logo等功能；

- 易嵌入：支持嵌入到任意网页、APP、公众号等场景，无技术门槛。

播放器地址http://player.afmax.cn/

## 二、使用方法（傻瓜式上手）

### （一）核心调用逻辑

通过 URL参数拼接 生成播放链接，格式：

http://player.afmax.cn/?参数1=值1&参数2=值2

示例http://player.afmax.cn/?r=https://help.api.afmax.cn/mp4/1.m4v&srt=https://help.api.afmax.cn/mp4/1.ass

### （二）核心参数说明（全支持，无域名限制）

|参数名|作用说明|取值格式/要求|是否必填|依赖关系|

|---|---|---|---|---|

r|单个主视频地址|完整视频URL（MP4、m3u8等白名单格式）|否|txttime互斥，三选一|

srt|字幕地址|完整字幕URL（SRT、ASS、VTT格式）|否|需搭rtxt使用|

insert|插入视频（片头/片尾）|完整视频URL（白名单格式）|否|无，可单独搭配任意主内容参数|

txt|多集播放/定时播放列表|完整.txt文件URL（按格式编写）|否|rtime互斥，三选一|

logo|自定义播放器Logo|完整图片URL（PNG/JPG格式）|否|无|

### （三）关键格式白名单（仅支持以下格式，安全防护）

|类型|支持格式|

|---|---|

|视频格式|MP4、M4V、MOV、AVI、FLV、WMV、MKV、WEBM、m3u8、TS（流媒体分片）|

|字幕格式|SRT、ASS、VTT（WebVTT）、SUB、IDX|

|列表格式|TXT（多集/定时播放配置文件）|

|Logo格式|PNG、JPG（建议尺寸：100×100px，不遮挡视频）|

### （四）txt文件编写教程（多集/定时播放核心）

txt 文件是多集播放、定时播放的核心，按以下规则编写，无需复杂配置：

#### 1. 用途1：多集播放列表（最常用）

- 编写规则：

- 后缀必须为 .txt，编码为 UTF-8（无中文乱码）；

- 每行1个视频配置，空行/注释行#开头）自动忽略；

- 支持3种写法：仅视频、视频+字幕、视频+字幕+备注。

- 完整示例（可直接复制使用）：

- 调用公式http://player.afmax.cn/?txt=你的txt文件URL

- 示例http://player.afmax.cn/?txt=https://help.api.afmax.cn/mp4/2.txt（用户专属多集列表）

#### 2. 用途2：定时播放配置

- 编写规则：

- 每行格式时间点,视频URL,字幕URL（字幕URL可选，无则留空）；

- 时间格式HH:MM（24小时制，如 09:30）；

- 分隔符：英文逗号 ,，不可用中文逗号。

- 完整示例：

- 调用公式http://player.afmax.cn/?time=你的定时txt文件URL

- 示例http://player.afmax.cn/?time=https://help.api.afmax.cn/mp4/1.txt

## 三、实战调用示例（直接复制打开）

### （一）基础场景（个人/简单使用）

1. 单个视频播放：

http://player.afmax.cn/?r=https://help.api.afmax.cn/mp4/1.m4v

1. 单个视频+字幕：

http://player.afmax.cn/?r=https://help.api.afmax.cn/mp4/1.m4v&srt=https://help.api.afmax.cn/mp4/1.ass

1. 多集播放（用户专属列表）：

http://player.afmax.cn/?txt=https://help.api.afmax.cn/mp4/2.txt

1. 自定义Logo+视频：

http://player.afmax.cn/?r=https://help.api.afmax.cn/mp4/1.m4v&logo=https://afmax.cn/zb_users/theme/suiranx_nav/image/logo.png

### （二）高级场景（企业/开发者使用）

1. 片头+多集+Logo（品牌宣传）：

http://player.afmax.cn/?insert=https://help.api.afmax.cn/mp4/2.mp4&txt=https://help.api.afmax.cn/mp4/2.txt&logo=https://afmax.cn/zb_users/theme/suiranx_nav/image/logo.png

1. 定时播放+全局字幕（线上课程）：

http://player.afmax.cn/?time=https://help.api.afmax.cn/mp4/1.txt&srt=https://help.api.afmax.cn/mp4/common.vtt

1. 第三方视频+字幕（无域名限制）：

http://player.afmax.cn/?r=https://thirdparty.com/video.mp4&srt=https://thirdparty.com/sub.vtt

1. 嵌入网页示例（HTML代码，直接复制到网页）：

```c

<iframe height=498 width=510 src='http://player.afmax.cn/XXXX' frameborder=0 'allowfullscreen'></iframe>

```

## 四、使用规则（公共服务规范，必遵守）

### （一）合法使用规则

1. 仅允许播放 合法合规的资源，禁止播放侵权、色情、暴力、违法等违规内容；

2. 使用者需自行确保所播放的视频、字幕、Logo等资源拥有合法版权或使用权，若引发版权纠纷，由使用者自行承担责任；

3. 禁止将播放器用于非法盈利、恶意传播、网络攻击等违法用途。

### （二）技术使用限制

1. 仅支持格式白名单内的文件类型，超出格式将被代理脚本拦截（返回403错误）；

2. 单个视频/字幕资源建议不超过500MB，过大文件可能导致播放卡顿（受网络影响）；

3. 代理脚本超时时间为15秒，无法访问的资源将返回400错误，请确保资源URL有效、可访问。

### （三）公共服务说明

1. 播放器免费开放使用，无带宽/次数限制，但禁止恶意刷量、DoS攻击等滥用行为；

2. 支持跨域嵌入，可嵌入到任意网页、APP、公众号文章、小程序等场景，无技术限制；

3. 平台有权根据法律法规要求或技术升级需要，调整功能或暂停服务，将提前通过播放器主页公告。

## 五、核心用途（覆盖10+场景，适配不同需求）

### 1. 个人娱乐/收藏（普通用户）

- 场景：收藏多个影视片段、音乐MV、生活记录视频，通过txt列表批量播放；

- 优势：无需下载播放器，浏览器直接打开，支持连续播放，手机/电脑端通用。

### 2. 企业品牌宣传（企业用户）

- 场景：制作品牌片头+产品介绍+案例展示的多集视频，嵌入到官网、公众号文章；

- 优势：自定义Logo强化品牌认知，支持嵌入到任意宣传渠道，无需单独开发播放器。

### 3. 在线教育/培训（老师/机构）

- 场景：将课程拆分为多个章节，按顺序制作txt列表，搭配字幕上传，学生通过1个链接连续学习；

- 优势：支持定时播放（直播课预告）、字幕偏移调节（适配不同语速），提升学习体验。

### 4. 开发者嵌入使用（技术/开发者）

- 场景：在自己的网站、APP中嵌入播放器，播放自有或第三方合法视频资源；

- 优势：无需开发复杂播放器功能，直接通过参数调用，支持定制化Logo，适配自有产品风格。

### 5. 线上会议/活动（企业/组织）

- 场景：通过定时txt配置会议流程（开场视频→主讲内容→互动环节），参会者统一链接观看；

- 优势：按时间自动切换内容，无需人工操作，支持多设备接入，降低组织成本。

### 6. 自媒体内容分发（博主/UP主）

- 场景：将系列视频（如教程、测评）制作成多集列表，分享给粉丝，粉丝可连续观看；

- 优势：仅需分享1个链接，减少粉丝操作成本，支持嵌入到自媒体平台，提升内容传播效率。

### 7. 公益宣传/公告发布（公益组织/政府机构）

- 场景：发布公益宣传视频、政策解读视频，通过多集列表按主题分类，嵌入到官网或公众号；

- 优势：无域名限制，可播放任意合法公益资源，支持广泛传播，覆盖更多人群。

### 8. 临时直播/轮播（活动主办方）

- 场景：通过m3u8格式接入临时直播流，搭配片头视频，嵌入到活动专题页；

- 优势：支持流媒体格式，无需专业直播平台，浏览器直接观看，降低直播门槛。

### 9. 电商产品展示（电商商家）

- 场景：制作产品开箱、功能演示、使用教程的多集视频，嵌入到商品详情页；

- 优势：支持连续播放，帮助用户全面了解产品，提升购买转化率，无需额外付费。

### 10. 家庭影院/聚会播放（家庭用户）

- 场景：收集多个经典影片片段、综艺名场面，制作txt列表，聚会时通过电视浏览器打开，全屏播放；

- 优势：支持大屏显示，自动续播，无需手动切换，提升聚会氛围。

## 六、常见问题排查（避坑指南）

1. 视频无法播放？

- 检查视频URL是否有效（复制到浏览器能直接播放）；

- 确认视频格式在白名单内（如m3u8、MP4等，不支持exe、zip等格式）；

- 若提示“Proxy Error”，可能是资源URL无法访问或超时，更换资源链接即可。

1. 字幕不显示？

- 确srt参数rtxt搭配使用（单独srt无效）；

- 检查字幕URL是否有效、格式是否为SRT/ASS/VTT；

- 若字幕与视频不同步，在播放器设置面板调整“字幕偏移”。

1. 无法嵌入到网页？

- 检查iframe代码是否正确（复制示例代码修改URL即可）；

- 确认网页支持iframe嵌入（部分平台可能限制，可直接分享播放链接）。

1. 多集无“上一集/下一集”按钮？

- 确认txt列表中至少有2个有效视频；

- 刷新页面重新加载，可能是初始化延迟。

## 七、总结

H5 Universal Player 公共版是一款 零门槛、多功能、安全合规 的在线播放器，核心优势是“无域名限制+易调用+多场景适配”：

- 普通用户：直接通过参数拼接链接，播放单个/多集视频；

- 企业/组织：自定义Logo、嵌入宣传渠道，强化品牌或内容传播；

- 开发者：无需开发，直接嵌入，适配自有产品。

所有使用需遵守合法合规原则，仅播放合法资源。如需定制化功能（如密码保护、循环播放、字幕颜色修改），可联系平台反馈！

# README.md

一个功能强大、轻量级的HTML5视频播放器，支持多种视频格式、字幕和播放列表功能。

## 特性

- 多格式支持: 支持mp4、m4v、mov、avi、flv、wmv、mkv、webm、m3u8、ts等视频格式

- 字幕支持: 支持srt、ass、vtt、sub、idx等字幕格式

- 播放列表: 支持txt格式的播放列表和定时播放

- 自定义Logo: 支持添加自定义Logo

- 画中画: 支持画中画模式

- 快捷键: 支持键盘快捷键控制

- 响应式设计: 适配手机和电脑屏幕

- 安全代理: 支持跨域资源访问

## 基本使用

### 1. 直接播放单个视频

```

http://player.afmax.cn/?r=视频URL

```

### 2. 带字幕播放

```

http://player.afmax.cn/?r=视频URL&srt=字幕URL

```

### 3. 播放列表模式

创建一个txt文件，每行一个视频配置：

```

视频URL1&srt=字幕URL1

视频URL2&srt=字幕URL2

# 这是注释

视频URL3

```

然后通过txt参数加载：

```

http://player.afmax.cn/?txt=播放列表URL

```

### 4. 定时播放模式

创建一个txt文件，每行一个定时配置：

```

time=08:00&url=视频URL1&srt=字幕URL1

time=12:30&url=视频URL2

time=18:15&url=视频URL3

```

然后通过time参数加载：

```

http://player.afmax.cn/?time=定时配置URL

```

### 5. 片头播放

```

http://player.afmax.cn/?insert=片头视频URL&r=正片视频URL

```

### 6. 自定义Logo

```

http://player.afmax.cn/?r=视频URL&logo=Logo图片URL

```

## 参数说明

| 参数 | 说明 | 优先级 |

|------|------|--------|

| insert | 片头视频URL | 最高 |

| txt | 播放列表URL | 高 |

| time | 定时配置URL | 中 |

| r | 单个视频URL | 低 |

| srt | 字幕URL | - |

| logo | Logo图片URL | - |

## 键盘快捷键

| 按键 | 功能 |

|------|------|

| 空格 | 播放/暂停 |

| F | 全屏切换 |

| M | 静音切换 |

| 右箭头 | 前进5秒 |

| 左箭头 | 后退5秒 |

| 上箭头 | 音量+ |

| 下箭头 | 音量- |

| O | 字幕开关 |

## 安全策略

### 格式限制

只允许以下文件类型：

- 视频：mp4, m4v, mov, avi, flv, wmv, mkv, webm, m3u8, ts

- 字幕：srt, ass, vtt, sub, idx

- 配置：txt

### 代理特性

- 跨域支持: 允许任何域名访问

- 编码处理: 自动检测和转换文件编码为UTF-8

- 证书忽略: 支持访问自签名证书的资源

- 浏览器模拟: 使用Chrome UA，减少被拦截的概率

## 嵌入播放

可以将播放器嵌入到其他网页中：

```html

```

## 注意事项

1. 所有URL必须是完整的HTTP/HTTPS链接

2. 字幕文件编码建议使用UTF-8

3. 对于m3u8等流媒体格式，需要服务器支持CORS

4. 大文件建议使用支持Range请求的服务器

5. 定时播放模式下，配置文件会每分钟自动更新

## 示例

1. 单个视频播放：

```

http://player.afmax.cn/?r=https://example.com/video.mp4

```

2. 带字幕的视频：

```

http://player.afmax.cn/?r=https://example.com/video.mp4&srt=https://example.com/subtitle.srt

```

3. 播放列表：

```

http://player.afmax.cn/?txt=https://example.com/playlist.txt

```

4. 定时播放：

```

http://player.afmax.cn/?time=https://example.com/schedule.txt

```

5. 带片头的播放：

```

http://player.afmax.cn/?insert=https://example.com/intro.mp4&r=https://example.com/main.mp4

```

# 详细说明：

# H5 Universal Player 参数使用指南

# H5 Universal Player 完整参数使用指南（含多集播放+所有组合场景）

## 一、核心参数总览（所有支持功能一网打尽）

|参数名|作用说明|取值格式/要求|是否必填|优先级|

|---|---|---|---|---|

r|单个主视频地址|完整视频URL（MP4、M4V、m3u8等白名单格式）|否|2级（与txt互斥，优先txt）|

srt|字幕地址|完整字幕URL（SRT、ASS、VTT格式）|否|-|

insert|插入视频（片头/片尾）|完整视频URL|否|最高（先播insert再播主内容）|

txt|多集播放列表|完整.txt文件URL（每行1个视频链接）|否|1级（与r互斥，优先txt）|

time|定时播放配置|完整.txt文件URL（按时间点配置视频）|否|1级（与r/txt互斥）|

logo|自定义播放器Logo|完整图片URL（PNG/JPG格式）|否|-|

### 关键规则：

1. 互斥参数txt「多集列表」r「单个视频」time「定时播放」三者只能选一个，同时填写时优先加载 txt，其次 time，最后 r；

2. 依赖参数srt（字幕）必须搭配 r 或 txt 中的视频使用，单独填写无效；

3. 参数连接：多个参数用 & 拼接（如 txt=xxx&logo=xxx），URL必须完整包含 https://。

## 二、单个参数基础用法（入门级）

### 1. 单个视频r 参数）

- 公式http://player.afmax.cn/?r=视频URL

- 示例http://player.afmax.cn/?r=https://help.api.afmax.cn/mp4/1.m4v

- 效果：播放单个视频，无字幕、无额外内容。

### 2. 单个视频+字幕r+srt）

- 公式http://player.afmax.cn/?r=视频URL&srt=字幕URL

- 示例http://player.afmax.cn/?r=https://help.api.afmax.cn/mp4/1.m4v&srt=https://help.api.afmax.cn/mp4/1.ass

- 效果：播放单个视频，自动加载字幕，支持字幕偏移调节。

### 3. 多集播放txt 参数，核心多集功能）

- 公式http://player.afmax.cn/?txt=多集列表txtURL

- 示例http://player.afmax.cn/?txt=https://help.api.afmax.cn/mp4/2.txt（用户专属多集列表）

- 效果：加载 2.txt 中的2个视频（第1集：2.mp4，第2集：1.m4v），自动显示「上一集/下一集」，支持自动续播。

### 4. 定时播放time 参数）

- 公式http://player.afmax.cn/?time=定时配置txtURL

- 示例http://player.afmax.cn/?time=https://help.api.afmax.cn/mp4/1.txt

- 效果：按txt中配置的时间点自动播放对应视频（如 09:00 播1.m4v，10:30 播2.mp4）。

### 5. 自定义Logologo 参数）

- 公式http://player.afmax.cn/?r=视频URL&logo=Logo图片URL

- 示例http://player.afmax.cn/?r=https://help.api.afmax.cn/mp4/1.m4v&logo=https://afmax.cn/zb_users/theme/suiranx_nav/image/logo.png

- 效果：播放器右上角显示自定义Logo。

## 三、参数组合高级用法（实战级，直接复制使用）

### 1. 片头+多集播放insert+txt，最常用组合）

- 公式http://player.afmax.cn/?insert=片头视频URL&txt=多集列表txtURL

- 示例http://player.afmax.cn/?insert=https://help.api.afmax.cn/mp4/2.mp4&txt=https://help.api.afmax.cn/mp4/2.txt

- 效果：先播放片头视频（2.mp4），播完自动加载 2.txt 多集列表（第1集：2.mp4 → 第2集：1.m4v）。

### 2. 片头+单个视频+字幕+Logoinsert+r+srt+logo，全功能组合）

- 公式http://player.afmax.cn/?insert=片头URL&r=主视频URL&srt=字幕URL&logo=LogoURL

- 示例http://player.afmax.cn/?insert=https://help.api.afmax.cn/mp4/2.mp4&r=https://help.api.afmax.cn/mp4/1.m4v&srt=https://help.api.afmax.cn/mp4/1.ass&logo=https://afmax.cn/zb_users/theme/suiranx_nav/image/logo.png

- 效果：先播片头 → 再播带字幕的主视频 → 右上角显示Logo，支持所有核心功能。

### 3. 多集播放+自定义Logotxt+logo，品牌化组合）

- 公式http://player.afmax.cn/?txt=多集列表txtURL&logo=LogoURL

- 示例http://player.afmax.cn/?txt=https://help.api.afmax.cn/mp4/2.txt&logo=https://afmax.cn/zb_users/theme/suiranx_nav/image/logo.png

- 效果：加载多集视频（2.txt），同时显示品牌Logo，适合系列内容品牌展示。

### 4. 定时播放+字幕time+srt，适配特定场景）

- 公式http://player.afmax.cn/?time=定时配置txtURL&srt=默认字幕URL

- 示例http://player.afmax.cn/?time=https://help.api.afmax.cn/mp4/1.txt&srt=https://help.api.afmax.cn/mp4/1.ass

- 效果：按时间点播放视频，自动加载默认字幕（若定时txt中某视频单独配置字幕，优先使用该字幕）。

## 四、用户专属资源实战示例（直接点击打开）

|需求场景|完整播放链接|效果说明|

|---|---|---|

|单纯多集播放（无额外功能）http://player.afmax.cn/?txt=https://help.api.afmax.cn/mp4/2.txt|播放2.txt中的2个视频，自动续播、支持手动切换集数|

|片头+多集+Logohttp://player.afmax.cn/?insert=https://help.api.afmax.cn/mp4/2.mp4&txt=https://help.api.afmax.cn/mp4/2.txt&logo=https://afmax.cn/zb_users/theme/suiranx_nav/image/logo.png|先播片头 → 多集连续播放 → 右上角显示Logo|

|多集+字幕（后续扩展用）http://player.afmax.cn/?txt=https://help.api.afmax.cn/mp4/2.txt&srt=https://help.api.afmax.cn/mp4/1.ass|多集播放时，所有视频默认加载1.ass字幕（若需单集单独字幕，修改2.txt即可）|

|片头+单个视频+字幕http://player.afmax.cn/?insert=https://help.api.afmax.cn/mp4/2.mp4&r=https://help.api.afmax.cn/mp4/1.m4v&srt=https://help.api.afmax.cn/mp4/1.ass|先播片头 → 再播带字幕的主视频|

## 五、核心应用场景（覆盖所有使用需求）

### 1. 系列内容播放txttxt+insert）

- 适用：培训课程、讲座实录、影视系列片、产品教程等需按顺序观看的内容；

- 优势：多集自动续播，无需手动切换，观众沉浸式观看，分享仅需1个链接。

### 2. 品牌化展示logo+insert+r/txt）

- 适用：企业宣传视频、产品发布会、品牌活动花絮等；

- 优势：片头展示品牌信息，播放器显示Logo，强化品牌认知，所有内容集中播放。

### 3. 定时直播/轮播timetime+insert）

- 适用：线上会议、定时开播的课程、24小时轮播的宣传视频；

- 优势：按时间自动切换内容，无需人工值守，适配无人化播放场景。

### 4. 单个高清视频带字幕r+srt）

- 适用：需要文字说明的视频（如教学视频、外语视频、技术讲解）；

- 优势：字幕自动同步，支持偏移调节，适配不同观看需求。

## 六、使用规则与注意事项

### 1. 格式与安全规则

- 所有URL必须完整（包含 https://），否则无法加载；

- 视频、字幕、图片域名必须在 proxy.php 白名单afmax.cnhelp.api.afmax.cn）内，否则代理会拦截；

- txt 列表文件要求：UTF-8编码、每行1个视频链接、无多余空格/换行，支持 &srt= 拼接字幕# 标注备注。

### 2. 播放优先级规则

- 内容优先级insert（片头）→ 主内容txttimer）；

- 主内容优先级txt（多集）> time（定时）> r（单个视频）；

- 字幕优先级txt 单行星字幕 > 全局 srt 参数 > 无字幕。

### 3. 异常排查

- 链接打不开：检查URL是否完整、参数是否用 & 连接、域名是否在白名单；

- 字幕不显示：确认 srt 参数与 rtxt 搭配使用、字幕URL有效、格式为SRT/ASS/VTT；

- 多集无切换按钮：刷新页面（初始化延迟）、确认 txt 中至少有2个有效视频；

- 代理拦截：检查视频/字幕域名是否在 proxy.php 的 $ALLOWED_DOMAINS 中，格式是否在 $ALLOWED_EXTENSIONS 中。

## 七、总结

所有功能都可通过「参数组合」实现，核心记住3点：

1. 互斥参数txtrtime）选一个，依赖参数srt）配主参数；

2. 组合用 & 连接，URL必须完整；

3. 用户专属多集列表 2.txt 直接用 txt=https://help.api.afmax.cn/mp4/2.txt 调用，可搭配任何非互斥参数扩展功能。

## 二、txt详细说明

# H5 Universal Player 的 txt 编写与参数组合

# H5 Universal Player 完整参数+txt编写指南（含所有场景+txt教程）

## 一、核心参数总览（所有支持功能）

|参数名|作用说明|取值格式/要求|是否必填|优先级|

|---|---|---|---|---|

r|单个主视频地址|完整视频URL（MP4、M4V、m3u8等白名单格式）|否|2级（与txt互斥，优先txt）|

srt|字幕地址|完整字幕URL（SRT、ASS、VTT格式）|否|-|

insert|插入视频（片头/片尾）|完整视频URL|否|最高（先播insert再播主内容）|

txt|多集播放列表/定时配置|完整.txt文件URL（分两种用途，下文详解）|否|1级（与r互斥，优先txt）|

logo|自定义播放器Logo|完整图片URL（PNG/JPG格式）|否|-|

### 关键规则：

1. 互斥参数txt（多集/定时）r（单个视频）三者只能选一个，同时填写优先加载 txt；

2. 依赖参数srt 必须搭配 r 或 txt 使用，单独填写无效；

3. 参数连接：多个参数用 & 拼接（如 txt=xxx&logo=xxx），所有URL必须包含 https://。

## 二、核心重点：txt文件编写教程（两种用途，详细到每一步）

txt 文件是播放器的核心扩展功能，支持 多集播放列表 和 定时播放配置 两种用途，以下是具体编写规则（含示例、错误写法、验证方法）：

### （一）用途1：多集播放列表（最常用，如用户专属2.txt）

#### 1. 基础编写规则（必遵守！）

- 文件要求：后缀必须是 .txt，编码必须为 UTF-8（避免中文乱码）；

- 内容规则：每行1个视频配置，无多余空格、换行符，空行会被忽略；

- 注释规则：以 # 开头的行为注释行，播放器自动忽略（仅用于自己标注）；

- 支持格式：视频格式需在 proxy.php 白名单内（MP4、M4V、m3u8、ts等），字幕支持SRT/ASS/VTT。

#### 2. 3种行内配置写法（按需选择）

|写法类型|格式示例|适用场景|

|---|---|---|

|仅视频https://help.api.afmax.cn/mp4/2.mp4|无字幕的视频|

|视频+字幕https://help.api.afmax.cn/mp4/1.m4v&srt=https://help.api.afmax.cn/mp4/1.ass|需要字幕的视频（&srt=拼接）|

|视频+字幕+备注https://help.api.afmax.cn/mp4/1.m4v&srt=https://help.api.afmax.cn/mp4/1.vtt#第1集：基础教程|标注集名、便于管理#后为备注）|

#### 3. 完整示例（可直接复制创建txt）

```Plain Text

```

- 保存为 video_list.txt，上传到服务器（如 https://help.api.afmax.cn/mp4/video_list.txt）即可调用。

#### 4. 错误写法（避坑！）

```Plain Text

```

### （二）用途2：定时播放配置（按时间点播放）

#### 1. 基础编写规则

- 文件要求：同多集列表.txt 后缀、UTF-8编码）；

- 内容规则：每行1个定时配置，格式为「时间点,视频URL,字幕URL」（字幕URL可选，无则留空）；

- 时间格式：必须是 HH:MM:SS（24小时制，如 09:30:0014:15:00）；

- 分隔符：必须用英文逗号 , 分隔，不能用中文逗号 ，。

#### 2. 行内配置写法

|写法类型|格式示例|说明|

|---|---|---|

|时间+视频+字幕09:00:00,https://help.api.afmax.cn/mp4/1.m4v,https://help.api.afmax.cn/mp4/1.ass|09:00播放带字幕的视频|

|时间+视频（无字幕）10:30:00,https://help.api.afmax.cn/mp4/2.mp4,|10:30播放无字幕视频（末尾逗号不能少）|

|注释行# 定时播放配置：2024年5月10日会议视频|播放器自动忽略|

#### 3. 完整示例

```Plain Text

```

- 保存为 time_list.txt，上传到服务器（如 https://help.api.afmax.cn/mp4/time_list.txt）即可调用。

### （三）txt文件验证方法（确保能正常使用）

1. 本地验证：保存后用记事本打开，确认无乱码、每行格式正确；

2. 在线验证：将txt文件上传到服务器后，复制txt的URL，在浏览器中打开，若能直接显示文件内容（无下载、无404），则为有效URL；

3. 播放器验证：按公式 http://player.afmax.cn/?txt=你的txtURL 生成链接，打开后若能加载视频，则编写成功。

## 三、参数组合+txt调用实战示例（直接复制使用）

### 1. 多集播放（基础调用）

- 公式http://player.afmax.cn/?txt=多集列表txtURL

- 示例http://player.afmax.cn/?txt=https://help.api.afmax.cn/mp4/2.txt（用户专属多集列表）

- 效果：加载2.txt中的2个视频，自动续播、支持手动切换集数。

### 2. 片头+多集播放+Logo（品牌化组合）

- 公式http://player.afmax.cn/?insert=片头URL&txt=多集列表txtURL&logo=LogoURL

- 示例http://player.afmax.cn/?insert=https://help.api.afmax.cn/mp4/2.mp4&txt=https://help.api.afmax.cn/mp4/2.txt&logo=https://afmax.cn/zb_users/theme/suiranx_nav/image/logo.png

- 效果：先播片头 → 多集连续播放 → 右上角显示Logo。

### 3. 定时播放+字幕（全局字幕）

- 公式http://player.afmax.cn/?time=定时配置txtURL&srt=默认字幕URL

- 示例http://player.afmax.cn/?time=https://help.api.afmax.cn/mp4/1.txt&srt=https://help.api.afmax.cn/mp4/1.ass

- 效果：按时间点播放视频，未单独配置字幕的视频使用全局字幕。

### 4. 单个视频+字幕+自定义Logo（全功能单个视频）

- 公式http://player.afmax.cn/?r=视频URL&srt=字幕URL&logo=LogoURL

- 示例http://player.afmax.cn/?r=https://help.api.afmax.cn/mp4/1.m4v&srt=https://help.api.afmax.cn/mp4/1.ass&logo=https://afmax.cn/zb_users/theme/suiranx_nav/image/logo.png

- 效果：播放带字幕的单个视频，右上角显示Logo。

## 四、用户专属资源快速调用表（直接点击打开）

|需求场景|完整播放链接|效果说明|

|---|---|---|

|单纯多集播放http://player.afmax.cn/?txt=https://help.api.afmax.cn/mp4/2.txt|播放2.txt中2个视频，自动续播、手动切换集数|

|片头+多集+Logohttp://player.afmax.cn/?insert=https://help.api.afmax.cn/mp4/2.mp4&txt=https://help.api.afmax.cn/mp4/2.txt&logo=https://afmax.cn/zb_users/theme/suiranx_nav/image/logo.png|先播片头 → 多集播放 → 显示Logo|

|多集+全局字幕（扩展用）http://player.afmax.cn/?txt=https://help.api.afmax.cn/mp4/2.txt&srt=https://help.api.afmax.cn/mp4/1.ass|多集视频默认加载1.ass字幕（单集单独配置字幕优先）|

|定时播放（示例）http://player.afmax.cn/?time=https://help.api.afmax.cn/mp4/1.txt|按1.txt中时间点自动播放对应视频|

## 五、应用场景+txt编写对应表

|应用场景|推荐txt类型|txt编写要点|参数组合建议|

|---|---|---|---|

|培训课程、系列教程|多集播放列表|按课程顺序排列，每集标注集名，重要内容配字幕txt+insert（片头）+logo|

|企业宣传、品牌展示|多集播放列表|片头+产品介绍+案例展示，搭配品牌Logo，无字幕侧重画面insert+txt+logo|

|线上会议、定时开播|定时播放配置|严格按会议流程设置时间点，重要环节配字幕，预留休息时间（无字幕视频）time+insert（开场）|

|个人收藏、批量观看|多集播放列表|按个人喜好排序，无需备注和字幕，简洁配置txt 单独使用|

## 六、使用规则与异常排查

### 1. 安全与格式规则

- 所有URL必须完整（含 https://），否则无法加载；

- 视频、字幕、Logo的域名必须在 proxy.php 白名单afmax.cnhelp.api.afmax.cn）内，否则代理拦截；

- txt文件不可包含非法资源链接，否则播放器无法加载且违反使用规则。

### 2. 常见问题解决

- txt无法加载：检查txt URL是否有效、编码是否为UTF-8、是否有语法错误（如多余空格、中文逗号）；

- 多集无切换按钮：确认txt中至少有2个有效视频，刷新页面即可；

- 字幕不显示：检查 srt 参数是否与主参数搭配、字幕URL有效、格式为SRT/ASS/VTT；

- 定时播放不生效：检查时间格式是否为 HH:MM:SS、分隔符是否为英文逗号、视频URL是否有效。

## 七、总结

1. txt文件是核心扩展：多集播放和定时播放都依赖txt，按“用途选格式→按规则写内容→上传验证→参数调用”四步即可使用；

2. 参数组合灵活insert（片头）logo（品牌）可与任何非互斥参数搭配，满足不同场景需求；

3. 用户专属2.txt：直接用 txt=https://help.api.afmax.cn/mp4/2.txt 调用，可扩展片头、Logo、字幕等功能。