91丨亚洲丨精产区看片接口 · 技术档案索引台

接口档案概览

91丨亚洲丨精产区看片接口是一层面向播放端的资源取用通道：调用方提交资源编号与清晰度偏好，接口返回可播放地址、线路编号与状态字段。档案台把编号规则、字段清单、切换逻辑与调试要点按目录层级归档，方便在接入、联调和回查时逐条比对。

每条资源都以“前缀—区域段—序号”三段式编号登记，例如 91-AS-0142 表示前缀 91、亚洲区段、序号 0142。编号本身不含播放参数，参数一律随请求字段下发，因此同一条目可以在不同清晰度与线路之间自由切换，而不必重新登记。

目录层级只描述检索深度：层级越深，字段越细，排查时越容易定位到具体一项参数。

请求与返回参数索引

下表按常用顺序列出字段。字段名区分大小写，取值示例仅说明格式，实际取值以调用方约定为准。

字段按序号递增排列，新增字段一律追加在末尾，不改动既有序号，避免旧版调用方解析错位。

接入与调试步骤

1. 登记编号。确认资源编号符合三段式规则，前缀与区域段固定，序号补足四位。
2. 提交请求。携带 res_id 与 quality，线路留空时由服务端按顺序探测。
3. 校验返回。先读 status，为 ready 时再取用 play_url，避免在待定状态下直接起播。
4. 绑定播放器。把返回地址交给播放器内核，同时注册状态回调，用于处理缓冲与中断。
5. 回写记录。把本次编号、清晰度、线路与结果登记进归档，便于下次对照。

调试时先看三处

• 编号是否补足四位，缺位会被判为无效条目。
• 清晰度档位是否在当前线路的可用范围内。
• 状态回调是否被播放器内核覆盖，导致状态停留在初始值。

线路与清晰度对照

切换线路不会改变资源编号，也不会改变播放进度；进度由 seek 字段单独携带，切换后重新提交即可续播。清晰度降级按档位依次尝试，直到返回可用地址为止。

同一编号在不同线路下的返回地址不同，归档时建议同时记录线路编号，否则回查时容易误判为地址失效。

常见问题

返回状态一直是待定怎么办？

先确认编号是否登记完成，再确认清晰度档位是否超出线路范围。两项都正常时，改用 auto 档位重新提交，由服务端自行探测可用线路。

切换线路后进度丢失？

线路切换只替换地址，进度需通过 seek 重新携带。建议在切换前记录当前播放秒数，切换后立即回填。

播放器能起播但没有状态回调？

多数情况是播放器内核接管了状态事件。把回调注册放在内核初始化之后，或改用接口返回的 status 字段轮询读取。

编号检索不到条目？

检查前缀与区域段是否被误改，序号是否为四位。编号是检索主键，任何一位变动都会指向另一条目。

归档与更新记录

• 2026-11-03补充线路对照表，明确 auto 档位的兜底顺序。
• 2026-09-18参数索引新增字幕轨字段，序号顺延至 07。
• 2026-07-05统一编号为三段式，旧编号在归档中保留原样以便回查。
• 2026-04-22接入步骤重排，把状态校验提前到取用地址之前。

归档按日期倒序排列，每条只记录一次调整，重复条目以最新日期为准。