Files

2025-11-12 16:55:41 +08:00

5.2 KiB

Raw Blame History

ComputerCraft 网易云音乐播放器

📌 简介

本程序是一个基于 ComputerCraft（Minecraft 模组）的网易云音乐播放器，使用 Lua 编写，调用了第三方网易云 API、DFPWM 音频转码 API，结合 Basalt GUI库构建图形界面，支持搜索/播放网易云音乐，并支持歌单播放、歌词同步等功能。

此版本支持中文音乐名称显示（搜索出来的列表），但搜索只能使用英文或中文拼音

支持歌词显示，且会根据显示大小变更文字分辨率，但在默认的终端使用会显示不全，所以此功能建议使用屏幕显示（monitor 方向 music168.lua）

此软件使用触控交互，所以不支持石头电脑

🖼️ 展示图

🔍 中文搜索展示

支持中文音乐名称显示（搜索建议使用拼音或英文）

📄 播放列表展示

点击播放后可查看当前播放列表并切换歌曲

📂 歌单搜索展示

支持通过歌单 ID 搜索并播放整个歌单

🎙️ 歌词展示

播放时可同步显示歌词

🖥️ 屏幕显示歌词展示（适配大屏显示）

适用于使用 Monitor（monitor）外设播放时的歌词同步显示

🚀 安装方法

在 Minecraft 中安装好 ComputerCraft 模组后在电脑终端：

wget https://git.liulikeji.cn/xingluo/ComputerCraft-Music168-Player/raw/branch/main/music168.lua

运行：

music168

即可启动播放器。并自动补全运行库

🛠️ 使用方法

🔍 搜索音乐

在顶部输入框中输入歌曲名（拼音或英文均可，空格隔开）或网易云音乐 ID（需要多试几次）。
点击输入框右侧的 Q 按钮开始搜索。
下方列表中点击歌曲即可播放。

📂 歌单播放

底部菜单栏点击 {G} 按钮，进入歌单搜索界面。
输入歌单 ID（可通过复制粘贴）并点击 Q 搜索。
点击歌单中的音乐可播放。

🎵 播放控制

点击播放界面中的按钮可控制播放暂停。
点击 T 可打开播放列表，点击列表内歌曲切换歌曲。
点击播放界面左上角的 V 退出播放界面到搜索。
通过点击下方播放栏回到播放页面
点击进度条可以切换播放进度

多通道音频

默认为全部单通道播放，如使用双声道音频请按以下操作

编辑文件 speaker_groups.cfg

edit speaker_groups.cfg

在内部写入例如：

{
    main = {}, --混合通道扬声器列表
    left = {"speaker_0","speaker_1"}, --左声道扬声器列表
    right = {"speaker_5","speaker_6"} --右声道扬声器列表
}

这里的"speaker_0","speaker_1"等数量不限制，但多了会导致音频不同步或超出最大上限 "speaker_0","speaker_1"等为扬声器名称，如果使用网线链接则是打开时聊天栏的名称，如果直接放在旁边则为方向名例如（top,left,right）

📦 使用技术栈

语言：Lua
GUI 库：Basalt GUI
网易云 API：liulikeji.cn
DFPWM 音频转码接口：GMapiServer-ffmpeg
歌词支持：通过 MusicLyrics.lua 加载歌词
播放和格式转换：通过speakerlib.lua 转换格式和处理播放

⚠️ 注意事项

本程序为半成品，部分按钮仅作装饰。
若播放无声音，请检查播放界面左下角时间是否为 00:00，如果长时间无变化，请稍等或重试。
因为网络延迟或 API 崩溃，可能导致播放失败。
播放效果依赖于 ComputerCraft 中的 speaker 外设（扬声器）。

🗂️ 更新历史

新增歌单播放功能
修复部分播放逻辑与 UI 显示错误
新增中文音乐名，歌词显示，多通道音频
使用了新版GMApi接口

🛑 声明

本项目仅供学习交流使用，API 来源于第三方网易云api，音乐内容的版权属于原权利人。请勿用于商业用途。

🧑‍💻 项目作者

项目为个人开发，目前处于“咕咕咕”状态，更新不确定。

📬 反馈与支持

如有建议或问题，请联系项目原作者。

祝你享受愉快的音乐时光 🎶
在 ComputerCraft 世界中聆听你的网易云音乐❤

5.2 KiB Raw Blame History Unescape Escape