【免费下载】 DFPlayer Mini MP3 播放器使用指南

2026-01-16 09:28:39作者：江焘钦

(已不维护)简单灵活的iOS音频播放组件。基于AVPlayer，支持本地和远程音频播放，具有缓存、耳机线控、锁屏和控制中心信息展示、单曲顺序随机播放、倍速播放、歌词同步等音频播放器功能，DFPlayer封装了缓冲条、进度条、播放暂停按钮、下一首按钮、上一首按钮、播放模式按钮、歌词同步的tableview等UI控件，一行代码布局即可实现相应功能。

项目地址：https://gitcode.com/gh_mirrors/df/DFPlayer

1. 项目介绍

DFPlayer Mini是DFRobot公司推出的一款小型MP3播放模块，它支持SD卡和UART串口通信，可用于Arduino等开发平台进行音频播放。该模块易于集成到各种项目中，例如智能玩具、智能家居、实验教学等场合。

特点

支持SD卡播放MP3/WAV文件
可通过UART串口控制
内置音效模式
简单易用的API接口

官方网站及资源 DFPlayer Mini官方页面

2. 项目快速启动

依赖库安装

在开始之前，请确保你已经安装了Arduino IDE。然后，按照以下步骤安装DFPlayer Mini的库：

下载库文件：
解压缩下载的文件。
将解压得到的DFPlayer文件夹复制到Documents\Arduino\libraries目录下（Windows系统），或~/Arduino/libraries（Linux/Mac系统）。
重启Arduino IDE，新库应已可用。

示例代码

接下来，使用下面的示例代码连接并测试你的DFPlayer Mini：

#include "DFRobotDFPlayerMini.h"

SoftwareSerial softSerial(4, 5); // RX, TX pins
DFRobotDFPlayerMini myDFPlayer;

void setup() {
  Serial.begin(115200);
  Serial.println("DFRobot DFPlayer Mini Demo");

  // 初始化串口和DFPlayer Mini
  softSerial.begin(9600);
  if (!myDFPlayer.begin(softSerial)) {
    Serial.println("Unable to find DFPlayer.");
    while (1) {}
  }
  
  Serial.println("Initializing DFPlayer...");
  delay(3000);
}

void loop() {
  if (myDFPlayer.available()) {
    uint8_t cmd = myDFPlayer.read();
    
    switch(cmd) {
      case DFPLAYER_OK:
        Serial.println("Playing...");
        break;
      case DFPLAYER_FINISH:
        Serial.println("Finished playing, restarting playback");
        myDFPlayer.play(1);
        break;
      // 其他状态码处理...
    }
  }

  // 控制播放
  // myDFPlayer.play(1);   // 播放第一首歌
  // myDFPlayer.next();     // 播放下一首歌
  // myDFPlayer.previous(); // 播放上一首歌
}