这些指南把行业概念对应到平台目前已有的对象（频道包、线路、套餐、分销商账户、节点、API）。它们只是概念上的对应，并非行业专属功能，分销商账户是委托账户，而不是相互隔离的租户。
概念对应
面板里没有任何东西叫患者或病区。下表说明哪个对象承担哪个角色；下面各章按该顺序进行设置。
| 在您的行业中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 病区频道组合 | 频道包：由一个套餐授予的、已命名的频道、电影或剧集集合 | Bouquets，由 Streams 和 Movies / Series 组成 |
| 床位或病区电视 | 线路：一份访问权限，包含其套餐、频道包、到期时间、连接数上限和输出 | Lines → 添加，或激活码，或 Reseller API |
| 电视频道或信息循环播放 | 直播频道：带有信号源、EPG 和输出格式的流 | Streams → 添加直播流（源 URL 或 RTMP 推流） |
| 健康教育和信息视频 | 点播目录：带季和集的电影与剧集、分类和元数据 | Movies 和 Series，或点播入库任务 |
| 床位的访问期限 | 线路的到期日期，通过套餐、积分或 API 续期 | 线路的到期日期和套餐的时长 |
| 楼翼或楼栋节点 | 流媒体节点：从面板登记的边缘服务器，每个场地或每栋楼一个 | Servers → 添加节点，通过 SSH 安装 |
| 每个床位的屏幕数 | 线路的最大连接数：允许多少台设备同时观看 | 线路的最大连接数 |
前提条件
安装前需要准备什么。
- 医院数据机房里的一台服务器（Ubuntu 22.04 或 24.04）、安装程序，以及床边和病区电视可以访问的内部地址。
- 医院拥有权利的频道信号、医院的信息和健康教育视频，以及屏幕（Android TV 盒子、MAG 或 Enigma2 机顶盒、带播放器应用或浏览器的智能电视）。
- 关于谁管理面板（通常是 IT 团队）、床位和病区如何命名，以及每种病区类型的频道组合的决定。
基础设施部署
先部署中心服务器，再为每个楼翼部署一个节点。
- 在中心服务器上运行安装程序，并把播放基础地址设为医院的内部地址，使屏幕保持在本地网络内。
- 在服务器上设置许可证密钥；现场没有互联网时，在本地网络上离线激活。
- 在“服务器”中为每个楼翼或楼栋登记一个节点；面板通过 SSH 安装它，并把该楼翼的屏幕路由到它。
- 如果某科室的 IT 团队或病区管理员的工作需要与中心管理员分开，为其创建一个分销商账户（reseller）。
内容组织
每个病区一套频道组合，一个信息频道包。
- 用获授权的频道，为每套频道组合（普通病区、长期住院病房、儿科）创建一个频道包。
- 为医院的信息和健康教育视频创建一个频道包，并将其加入每个套餐。
- 每种病区类型创建一个套餐，包含它授予的频道包，并以较长的时长作为访问期限，使床位不会在两位患者之间到期。
- 为频道排序并设置徽标，使床边屏幕上的菜单清晰易读。
分销商配置
通常只有 IT 团队。
- 单家医院用管理员账户运行面板；开通一个床位不需要分销商账户。
- 当病区主管或某个科室需要管理自己屏幕的线路时，添加一个权限分组受限的分销商账户。
- 拥有多个院区的医院集团，每个院区获得一个分销商账户，各有自己的线路；它是委托账户，而不是隔离的安装。
床位和病区线路配置
每个床位或病区电视一条线路。
- 在“线路 → 添加”下为每块屏幕创建一条线路，以床位或病区命名（例如 4 病区 12 床），使用该病区类型的套餐。
- 床边屏幕的最大连接数设为 1，多人间则设为共用屏幕的数量。
- 当网络为屏幕分配固定地址时，把线路绑定到电视的地址。
- 用线路的凭据一次性配置屏幕（Xtream Codes API 或 M3U，或 MAG / Enigma2 门户）；凭据跟随床位，因此新患者无需任何设置。
信息和健康教育视频
医院自己的资料库。
- 把欢迎词、病区规定和健康教育影片作为电影上传，把多集节目作为剧集，附上简短说明并按主题分类。
- 把它们放入信息频道包，使每种病区类型都能收到。
- 信息变化时在面板中替换视频；屏幕会立即看到新版本。
电视频道和信息循环播放
面向病区的直播频道。
- 在“流”下添加每个获授权的频道及其信号；添加一个 EPG 源，让屏幕上的节目指南显示节目。
- 对于通知频道，添加一个由医院内编码器供流的循环播放直播流，并将其放入信息频道包。
- 医院只能在部分病区播放的频道，放在只有这些病区的套餐才授予的频道包中。
访问与到期
床位保持开通。
- 给床位的线路设置较长的有效期，在快到期时随其套餐续期；床位不应在两位患者之间断播。
- 禁用已关闭的床位或楼翼的线路，重新开放时再启用。
- 如果内部系统需要知道即将到期和已禁用的线路，让它订阅 webhook。
与其他系统集成
医院 IT 驱动线路，面板负责播放视频。
- 面板与医院系统没有原生集成；没有护士呼叫、病历或 EHR 连接。
- 医院自己的系统可以凭密钥和请求 ID，通过 Reseller API 创建、续期、启用和禁用线路，并接收变更的 webhook。
- 没有面向观众的单点登录；屏幕使用其线路的凭据播放。
安全注意事项
平台留在大楼内部。
- 让播放基础地址和节点保持在医院网络内；把面板放在带 TLS 的反向代理之后并设置 TRUSTED_PROXIES，使审计日志能看到真实地址。
- 每个面板账户使用双重验证登录并设置权限分组，使病区主管只能看到其角色所需的内容。
- 播放链接带签名且会过期，每条床边线路的连接数限制为 1，屏幕有固定地址时绑定地址。
- 加密的数据库备份并保留异地副本，用审计日志记录线路和目录的每一次变更；面板不保存患者数据。
故障排查
常见的首要检查项。
- 某个床位没有电视：检查其线路已启用且未过期，然后检查屏幕的凭据和地址。
- 某个病区缺少一个频道：检查该病区类型的套餐所含的频道包。
- 某个楼翼卡顿：检查该楼翼节点的心跳以及其屏幕是否已路由到它。
- 互联网中断时电视停播：检查播放基础地址和信号源是否为内部地址；外部信号依赖上行链路。