这是一个专为 ComputerCraft (CC: Tweaked) 设计的高性能视频播放器客户端。它利用 Tom's Peripherals 外设进行硬件加速渲染，结合远程服务器转码，实现了在 Minecraft 中流畅播放网络视频的功能。
✨ 主要功能
- 在线转码：直接输入视频 URL（如
.mp4链接），服务器自动提取帧和音频。 - 硬件加速：利用
tm_gpu外设进行高效的图像解码和绘制。 - 音频同步：支持立体声音频播放（需要扬声器外设），并带有自动追帧/跳帧逻辑以保持音画同步。
- 异步缓冲：使用多线程（协程）并发下载技术，边播边下，极大减少卡顿。
- 断点重试：内置自动重试机制，应对网络波动。
- 性能监控：提供 Debug 模式，实时显示 FPS、渲染耗时和缓冲状态。
- 快速重播：播放结束后生成 Task ID，1小时内可直接凭 ID 再次播放，无需重新转码。
🛠️ 环境要求
在运行此程序之前，请确保你的游戏环境满足以下条件：
- Mod 要求：
- CC: Tweaked >= 1.105.0
- Tom's Peripherals
- 硬件搭建：
- 高级电脑（金电脑）。
- TM GPU：连接到电脑（名为
tm_gpu_0或自动搜索）。 - 显示器：连接到 GPU 的显示器。
- 扬声器 (Speaker)：用于播放音频（程序依赖
speakerlib.lua）。
📥 安装
wget https://git.liulikeji.cn/xingluo/computer_craft_video_play/raw/branch/main/play.lua
注：程序首次运行时会自动检查并下载依赖库 speakerlib.lua
🚀 使用方法
1. 播放新视频
直接在命令行后跟视频的网络链接地址：
player https://example.com/video.mp4
程序将发送请求到服务器，等待转码后自动开始播放。
2. 通过 ID 重播
如果视频在过去一小时内播放过，可以使用任务 ID 直接播放，跳过转码等待：
player 20116713
(注：ID 会在视频播放结束后显示在屏幕上)
3. Debug 调试模式
在 URL 或 ID 后添加 debug 参数，可在屏幕左上角显示实时性能数据：
player https://example.com/video.mp4 debug
Debug 信息说明：
100/5000: 当前帧/总帧数Avg:20(50ms): 平均 FPS（平均每帧耗时）Low:15(66ms): 最低 FPS（当前秒内最大单帧耗时）
⚙️ 技术细节
- API 服务端：默认连接至
https://newgmapi.liulikeji.cn。 服务器项目https://git.liulikeji.cn/xingluo/GMapiServer - 分辨率：程序会自动将 GPU 设置为
64x分辨率模式，并请求服务器将视频缩放至 GPU 的实际宽高 (w, h)。 - 帧率：目标帧率为 20 FPS（Minecraft 逻辑刻速度）只能是此大小。
- 缓存机制：
- 预加载：播放前预先下载前 20 秒（约 400 帧）的数据。
- 动态缓冲：播放过程中，后台协程会持续预取后续大约 20 秒的帧数据包。
- 数据格式：使用定制的
FramePack二进制格式批量传输帧数据，减少 HTTP 请求开销。
❓ 常见问题
Q: 画面很流畅，但声音卡顿/不同步？ A: 这是 CC 扬声器的常见限制。程序内置了追帧逻辑，如果画面落后音频超过 3 帧，会自动跳帧追赶。如果服务器 TPS 过低，可能会导致音频本身播放缓慢。
Q: 如何获取任务 ID？
A: 视频播放完毕后，控制台会输出：The ID for playing the video is XXXXX。