mp3-module TF卡音乐命名指南0001.wav文件格式与按名播放的差异一次讲清【免费下载链接】CupCode_mp3模块源师兄扩展项目: MP3模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/mp3-module源师兄的 CupCode_mp3 模块是面向源师兄板的音乐播放扩展基于 GD3800D 芯片支持 wav 与 mp3 两种格式。音乐能不能放出来关键就在TF卡音乐文件命名4 位的0001.wav对应「播放序号」3 位的001.mp3对应「按名播放」。本篇指南把两种命名格式的差异一次讲清帮你避开「积木选对了却没声音」这个新手最常踩的坑。 MP3模块两种播放方式速览GD3800D 模块接入源师兄板、插好 TF 卡后播放音乐有两条路可走对比项播放序号按名播放对应积木MP3 模块播放序号为MP3 模块播放名为文件命名示例0001.wav、0002.mp3001.mp3、102.mp3位数4 位纯数字3 位纯数字首位限制无只能以 0、1、2 开头匹配方式文件在卡中的拷贝顺序按文件名输入范围0 ~ 655353 位数字两种方式分别对应驱动源码 library/gd3800.py 中的play_by_index()与play_by_name()。命名方式选对播放方式才对否则就是没声音。 0001.wav 四位命名播放序号的标准玩法「MP3 模块播放序号为」积木依赖 TF 卡文件按 config.json 中约定的格式命名0001.wav、0002.mp3即4 位纯数字 音频扩展名。几个关键点序号从 1 开始输入序号依次对应文件拷贝进卡里的顺序序号 1 就是0001.wav。范围 0 ~ 65535序号越界时驱动直接返回 0不播放见 gd3800.py。wav、mp3 可混用序号玩法只看数字部分扩展名两种格式都行。如果只是想「放第 N 首」这是最省心、最稳的方式也是模块推荐的默认命名方式。 三位命名按名播放的特殊规则「MP3 模块播放名为」积木按文件名匹配积木提示写得很明确音乐名为 3 位纯数字且名字只能以 0、1、2 开头。例如输入1播放卡中的001.mp3。注意差异点4 位命名的0001.wav无法直接被按名积木找到提示原文见 blocksdef.js。这正是两种积木命名差异的根源序号播放用 4 位流水号按名播放用 3 位且首位限 0/1/2。⚙️ 播放前先初始化接线别搞反所有 MP3 积木使用前都要在程序开头放置「初始化MP3模块」积木RX/TX 是交叉接线模块 RX 接主控 TX默认 14、模块 TX 接主控 RX默认 13接反会通信失败、没有声音。串口波特率 9600 已内置在驱动里一般不用操心。✅ 命名选型建议与常见坑序号为主统一用0001.wav、0002.mp3四位命名配「播放序号」积木最简单、最不易错。需要按名给要按名播放的文件用001.mp3、102.mp3这类三位命名再配「播放名为」积木。别混着来拿 4 位命名的文件去按名播放通常放不出来详见 README.md 的「按名播放无效」条目。音量 0 ~ 100超出范围的数值会按 60 处理播放前先设好合适音量。另外提醒一个容易看反的细节「播放状态」积木返回 True 表示未播放、False 表示正在播放写条件判断时注意取反。更多方法用法可查看 README.md 的 Python API 章节。【免费下载链接】CupCode_mp3模块源师兄扩展项目: MP3模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/mp3-module创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考