安装应用

从本站下载页获取 APK。

• 电视 / 盒子：用 U 盘拷入，或用 ADB 安装；部分系统需在设置里允许「未知来源」。
• 手机：直接安装 APK；若系统拦截，按提示允许本次安装即可。

连接你的服务器

首次启动会进入配置页。输入运营商提供的服务器域名或 IP（例如 api.example.com），点连接。

• 成功后会自动拉取频道列表，无需再导入一堆 m3u 文件。
• 地址填错会提示连接失败——改对再试，不要反复卸装。
• 本应用不内置任何节目内容；没有服务器就播不了，这是刻意设计。

换台与菜单

• 遥控器 上 / 下：上一个 / 下一个频道。
• 遥控器 确认 / OK：打开频道菜单，选分类与频道。
• 频道菜单会在一段时间无操作后自动收起，避免挡画面。
• 画面下方可短暂显示当前节目与下一档预告（取决于平台是否提供 EPG）。

播放不顺时先看这几步

• 长时间转圈：检查电视联网；或向平台确认该频道源是否在维护。
• 有声无画 / 花屏：多见于老盒子硬解能力不足，换一台设备或请平台提供更低清源。
• 某个台不行、隔壁台正常：往往是单线路问题，客户端会尝试切线；仍不行联系平台方。
• 不要连续猛按换台：等半秒再切，盒子解码器需要喘口气。

账号与授权（如平台开启）

部分平台需要登录或设备注册后才能播放付费频道。按界面提示完成即可；密码与会员事宜由你的平台方管理，本站不提供找回密码。

iPhone / iPad：在线观看放到桌面

没有 Android APK 也能用网页版。把 tvlive.app 加到主屏幕后，图标和打开方式更接近原生 App。

• 用系统自带的 Safari 打开 https://tvlive.app（微信 / QQ 内置浏览器可能没有「添加到主屏幕」）。
• 点底栏中间的 分享 按钮（方框带向上箭头）。
• 在弹出菜单里向下滑动，点 添加到主屏幕（英文为 Add to Home Screen）。
• 名称可改成「在线观看」或自定名称，再点右上角 添加。
• 回到桌面即可看到图标；以后点图标直接进入网页版，无需每次打开 Safari 再输地址。

自定义源：导入、隐藏、排序

除平台下发的频道外，可自行导入订阅（本地文件、网络地址、多条订阅）。电视上按菜单打开「手机助手」，用手机扫码后，在助手里找到「自定义」进行管理，比在遥控器上点更方便。

• 隐藏：在自定义里选中某个分类，长按该分类，弹出提示框后按提示操作（例如隐藏该源 / 分类）。隐藏后列表里不再显示，需要时再同样入口取消隐藏。
• 排序：按住分类不放，拖动到目标位置后松开，即可调整分类顺序；频道侧栏会按新顺序显示。
• 多订阅：可添加多条自定义订阅地址；各订阅下的分类可分别排序或隐藏，互不影响官网源。
• 删除：手机助手里可删除指定自定义内容（单条订阅或整块自定义数据），删除前请确认，避免误清。
• 电视本机也可在设置 → 自定义里做本地导入 / 网络导入 / 清除；复杂操作建议仍用手机助手。

JS 解析规则怎么用

自 3.2.0 起，频道地址可指向一段 JavaScript：客户端下载并执行脚本的 main(item)，把网页或接口解析成可播放地址。需开启扩展支持库 / JS。

• 完整写法：js://https://example.com/js/fh.js?id=xxxx 或 js://http://…；本机文件：js:///sdcard/cjzb/js/demo.js。
• 简写（推荐）：js_https://example.com/js/fh.js?id=xxxx、js_http://example.com/xxxx.js——与上面完整写法等价，少写一层 js://。
• 脚本须实现 main(item)，返回带 url 的对象；可用 ku9 / ms 发请求、解密等。接口说明见「JS 规则」文档。
• 仅用于你有权使用的自建或已授权节目源；版权与合规由部署方负责。

JS 规则