首页/新闻资讯/正文详情

mp3-module TF卡音乐命名指南:0001.wav文件格式与按名播放的差异一次讲清

发布时间:2026/9/25 1:28:25 来源:云帆数科 栏目:资讯中心
mp3-module TF卡音乐命名指南:0001.wav文件格式与按名播放的差异一次讲清
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),仅供参考

相关推荐

智能物流小车硬件选型避坑指南:从电机编码器到主控的实战解析
智能物流小车硬件选型避坑指南:从电机编码器到主控的实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:28:19

Obsidian离线插件安装全攻略:从下载到备份一篇搞懂
Obsidian离线插件安装全攻略:从下载到备份一篇搞懂

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:28:19

ps2-controller源码解读:PS2I2C类如何把6字节I2C数据变成16个按键和4根摇杆
ps2-controller源码解读:PS2I2C类如何把6字节I2C数据变成16个按键和4根摇杆

ps2-controller源码解读:PS2I2C类如何把6字节I2C数据变成16个按键和4根摇杆 【免费下载链接】ps2-controller 源师兄扩展项目: PS2 | 由源师兄组织创建 项目地址: https://gitcode.com/yuanshixiong/ps2-controller ps2-controller 是源师兄开源的 PS2 手柄扩… · 2026/9/25 1:28:19

Keil Flash下载失败Cortex-M3报错深度解析与实战修复
Keil Flash下载失败Cortex-M3报错深度解析与实战修复

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 2:04:09

微信小程序AppID与支付凭证安全:从群聊式共享到受控分发改造实录
微信小程序AppID与支付凭证安全:从群聊式共享到受控分发改造实录

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 2:04:09

微信小程序课堂签到源码:SSM+MySQL实现四种签到方式
微信小程序课堂签到源码:SSM+MySQL实现四种签到方式

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 2:04:09

跨阻放大器设计全解析:增益带宽、稳定性补偿与噪声预算
跨阻放大器设计全解析:增益带宽、稳定性补偿与噪声预算

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 2:04:09

S905L3B盒子刷安卓9.0 ATV固件后必做的五个优化设置
S905L3B盒子刷安卓9.0 ATV固件后必做的五个优化设置

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 2:04:09

原神抽卡点名程序:纯前端HTML+txt实现随机抽取动画
原神抽卡点名程序:纯前端HTML+txt实现随机抽取动画

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 2:04:02

数值优化(Numerical Optimization)学习系列-03-共轭梯度方法(Conjugate Gradient)
数值优化(Numerical Optimization)学习系列-03-共轭梯度方法(Conjugate Gradient)

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31

创维E900V22D刷机全攻略:S905L3SB芯片兼容性解析与救砖实战
创维E900V22D刷机全攻略:S905L3SB芯片兼容性解析与救砖实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31

MQTT协议原理与Broker服务器搭建实战:从Mosquitto到EMQX
MQTT协议原理与Broker服务器搭建实战:从Mosquitto到EMQX

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:37

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码