KazumiTV

注意：此项目与 Kazumi 并非同一作者，为经过原作者同意开发的 Apple TV 移植版本。

KazumiTV 是 Kazumi 的独立 Apple TV/tvOS 移植版本，使用 Swift 与 SwiftUI 重新实现。

本仓库与原 Kazumi 项目独立维护，并非由 Kazumi 原作者或原维护团队开发、维护或发布。本移植版本已获得原作者同意，原项目来源与归属信息同时记录在 NOTICE 中。

项目状态

KazumiTV 目前处于活跃开发阶段。应用面向 tvOS 平台，使用 URLSession + Fuzi + JavaScriptCore 与本机隐藏网页运行时解析视频地址，并在 App 内启动只绑定 127.0.0.1 的 loopback 播放代理，为 HLS 播放列表、分片、密钥和 MP4 请求注入必要请求头。安装和播放不需要部署额外服务。

使用截图

以下截图仅用于展示 KazumiTV 在 Apple TV 真机上的界面效果，截图中的媒体画面与海报版权归原权利方所有。

推荐页	详情页	播放器

架构

• tvOS 应用：Swift、SwiftUI、MVVM
• 导航：基于 NavigationStack 与共享 Router
• 插件解析：通过 Fuzi 进行 XPath 解析
• 视频解析：静态/轻量脚本使用原生解析，动态页面使用本机隐藏网页运行时
• 播放代理：App 内 127.0.0.1 loopback HLS/MP4 代理，负责重写播放列表与透传 Range
• 本地存储：SQLite.swift 与 UserDefaults
• 图片加载与缓存：Kingfisher

环境要求

• Xcode 15 或更新版本
• tvOS 17.0 或更新版本
• XcodeGen

构建

生成 Xcode 项目：

xcodegen generate

构建 Apple TV 模拟器版本：

xcodebuild -project KazumiTV.xcodeproj \
  -scheme KazumiTV \
  -configuration Debug \
  -destination 'platform=tvOS Simulator,name=Apple TV 4K (3rd generation)' \
  build

弹幕 API 配置

KazumiTV 按原版 Kazumi 的方式调用 DanDanPlay API。DanDanPlay 请求需要应用 ID 与密钥签名；源码构建时，请在本地配置自己的 DanDanPlay Open API 凭据。

复制模板文件：

cp Config/DanDanPlay.local.example.xcconfig Config/DanDanPlay.local.xcconfig

然后编辑 Config/DanDanPlay.local.xcconfig：

DANDANPLAY_APP_ID = <your-app-id>
DANDANPLAY_APP_SECRET = <your-app-secret>

重新生成 Xcode 工程并构建：

xcodegen generate
xcodebuild -project KazumiTV.xcodeproj \
  -scheme KazumiTV \
  -configuration Debug \
  -destination 'platform=tvOS Simulator,name=Apple TV 4K (3rd generation)' \
  build

请不要把真实 DanDanPlay 密钥提交到仓库。Config/DanDanPlay.local.xcconfig 已被 Git 忽略；未配置凭据时，播放器会保留弹幕开关与渲染能力，但弹幕加载会显示未配置提示。

播放解析模式

播放链路完全在 Apple TV 本机完成：

原生页面解析 -> 本机动态网页解析（按需） -> App 内 127.0.0.1 loopback 代理 -> AVPlayer

本地 loopback 代理只监听 Apple TV 真机自己的 127.0.0.1 随机端口，不会暴露到局域网。它会把远端 m3u8/mp4 映射为短 token URL，重写 HLS master/media playlist、segment、EXT-X-KEY 和 EXT-X-MAP，并透传 Range、Content-Type、Content-Length、Content-Range 等响应头。

动态网页解析默认开启，可以在设置中关闭。验证码、登录态或强反爬页面仍可能无法解析，应用会自动切换下一来源。

侧载说明：tvOS 没有公开可用的网页视图 API，动态网页解析因此通过运行时加载系统 WebKit 类实现，仅适用于自行签名/侧载构建，不能作为 App Store 审核兼容方案；系统升级后若该运行时不可用，原生解析来源仍可继续工作。

规则源

首次安装会优先尝试从 KazumiRules 获取推荐原生播放规则，并以内置 AGE、DM84、aafun 作为离线兜底。已有安装不会在播放时自动联网更新规则；可以在“规则管理”里使用“安装推荐”补齐 MXdm、omofun03、xfdmneo、7sefun、gugu3 等规则，或使用“规则仓库”手动安装更多规则。

默认播放源排序会优先使用近期开播成功的来源；没有历史记录时，MXdm 等无反爬原生播放源会排在 AGE/aafun 这类更容易遇到 CDN 地区限制的来源前面。

与 Kazumi 的关系

KazumiTV 是原 Kazumi 项目的 Swift/tvOS 移植版本。请不要将本仓库与上游 Kazumi 项目混淆：

• 原项目：Predidit/Kazumi
• KazumiTV：独立维护的 tvOS 移植版本
• 开发许可：本移植版本已获得原作者同意
• 作者关系：KazumiTV 与 Kazumi 不是同一项目，也不是由同一作者或团队维护

免责声明

KazumiTV 不托管、不分发、也不提供任何媒体内容。插件规则、数据源及相关网络请求均由用户自行配置和承担责任。用户必须遵守所在地法律法规，以及其所配置第三方来源的服务条款。

许可证

KazumiTV 使用 GNU General Public License version 3 授权，与原 Kazumi 项目使用的许可证保持一致。详见 LICENSE。

原 Kazumi 项目及其贡献者保留其在原项目中的相应权利。