C语言播放音乐 Windows多媒体库MCI使用大全

        在开发应用程序时，我们会遇到播放音频的需求，如何使用高级编程语言实现音频的播放是关键，在Windows下，我们可以直接调用Windows提供的Winmm（Windows Multimedia）库实现音频的播放，下面提供一种方便，快捷的调用方式，使用C语言即可完成。

本文是我在阅读了微软官网的帮助文档后总结出来的使用经验，阅读英文文档不易，请多多支持。

微软官方文档地址：Windows Multimedia

        1：包含头文件

        要使用winmm库，需要包含指定的头文件，包含windows.h和其他需要的头文件即可

除了windows.h，还需要告知编译器使用winmm库，在源代码中添加以下两行： 

#include <windows.h>
#pragma comment (lib,"winmm.lib")

***如果在编译时编译器报告找不到符号之类的错误，请使用命令行编译器如GCC，再编译指令后加上 -l winmm 参数。

***winmm库的文件是winmm.dll，默认在C:\Windows\System32目录下，如果你没有这个文件，请先下载该动态库文件。

gcc -o mci.exe mciTest.c -l winmm

        2：编写调用函数

        为了方便调用，可以选择编写一个调用的函数，调用函数中调用mciSendString库函数来完成工作。

mciSendString的返回值为0表示命令执行成功，不为0则表示执行失败

//发送指令
static void mySend(const char * command) {
    int ret = mciSendString(command, NULL, 0, NULL);
    if (ret != 0) {
        printf("Error: For command: \"%s\" -- %d\n", command, ret);
    } else {
        printf("Command: \"%s\" send success!\n", command);
    }
}

        mciSendString函数原型如下：（来自微软官方文档）

MCIERROR mciSendString(
   LPCTSTR lpszCommand,
   LPTSTR  lpszReturnString,
   UINT    cchReturn,
   HANDLE  hwndCallback
);

其中，第一个参数为指令字符串，后面的参数先按照所示的方案填写。

        3：调用函数，发送指令

        调用刚才所写的函数，按照以下格式发送指令：

1：打开文件：

mySend("open Snow.wav type waveaudio alias music");

        open + 文件名相对路径或绝对路径 + alias 标记名

        type waveaudio表示文件的类型为wav波形文件，如果是mp3则不用写这个参数

2：设置时间格式：

mySend("set music time format ms");

        设置当前mci的时间表示格式，后面的时间参数都以这个格式为标准

        set + 刚才在open中定义的标记名 + time format + ms（以毫秒为单位表示时间）

3：播放音频

mySend("play music");

        play + 标记名 播放整个音频

        如果进行了第二步设置时间单位，就可以写成

mySend("play music from 0 to 8000");

        表示从0毫秒处开始播放，一直播放到8000毫秒处停止

        ***如果没有进行第二步，就不能使用from to参数，否则会执行失败！

        以上调用会在音频播放开始后，程序往下执行。如果想让程序等待到播放完成后再往下执行，可以在尾部加上wait。

mySend("play music from 0 to 8000 wait");

4：暂停、继续播放

//暂停：pause 标记名
//继续播放：resume 标记名
mySend("pause music");
mySend("resume music");

5：关闭音频

mySend("close music");

        这个操作会释放占用的资源

        4：其他指令

除了播放，MCI还提供了其他的一些指令用于调用，以下总结了几个常用的指令。MCI给出的指令很多，但是其中大部分对于播放音频来说都用不上。

1：status指令

        status + 标记名 + 指令

        1.1：获取音频的总长度

//接收返回值
static void mySendBuffer(const char * command, char * buffer, unsigned int bufferLength) {
    int ret = mciSendString(command, buffer, bufferLength, NULL);
    if (ret != 0) {
        printf("Error: For command: \"%s\" -- %d\n", command, ret);
    } else {
        printf("Command: \"%s\" send success!\n", command);
    }
    printf("Buffer: %s\n", buffer);
}

char buf[1024];
mySendBuffer("status music length", buf, 1024);

        注意：status指令可以获取一些信息，我们需要向mciSendString传入一个char数组用于接收这些信息。mciSendString的第二个参数为信息存储的数组，第三个参数为数组的长度，第四个参数为一个返回值句柄，一般用不上填NULL

调用后，访问这个char数组即可获取音频的长度，其值为刚才设置的以毫秒为单位的值，比如音频的总长度为5分13秒，那么输出char数组可能得到 312935（312秒935毫秒）

        1.2：获取当前播放器所在位置（当前播放到哪里）

char buffer[1024];
mySendBuffer("status music position", buffer, 1024);

        同样的，返回值也是以毫秒为单位的。

2：seek指令

        seek + 标记名 + 参数

参数可以为 to end 定位到结尾，to（position）定位到指定位置，to start 定位到开头

        将播放位置定位到开头

mySend("seek music to start");
//或
mySend("seek music to 0");

以上就是所有MCI常用指令了，最后附上一个测试代码供参考。

#include <stdio.h>
#include <windows.h>
#pragma comment (lib,"winmm.lib")

//接收返回值
static void mySendBuffer(const char * command, char * buffer, unsigned int bufferLength) {
    int ret = mciSendString(command, buffer, bufferLength, NULL);
    if (ret != 0) {
        printf("Error: For command: \"%s\" -- %d\n", command, ret);
    } else {
        printf("Command: \"%s\" send success!\n", command);
    }
    printf("Buffer: %s\n", buffer);
}

//发送指令
static void mySend(const char * command) {
    int ret = mciSendString(command, NULL, 0, NULL);
    if (ret != 0) {
        printf("Error: For command: \"%s\" -- %d\n", command, ret);
    } else {
        printf("Command: \"%s\" send success!\n", command);
    }
}

#define L 1024
static void musicTest(void) {
    for (int i = 0; i < 1; i++) {
        //打开wav格式音乐
        mySend("open Snow.wav type waveaudio alias music");
        //如果需要使用from，to定位，必须先使用set命令设置时间单位
        mySend("set music time format ms");
        //wait表示等待播放完成后再执行下一条语句
        mySend("play music from 0 to 8000 wait");

        //获取当前播放位置，值为当前的位置毫秒数
        char buffer[L];
        mySendBuffer("status music position", buffer, L);
        char buf2[L];
        mySendBuffer("status music number of tracks", buf2, L);

        //定位到一个位置并从指定位置开始播放
        mySend("seek music to start");
        //从3000播放到7000
        mySend("play music to 7000 wait");

        //关闭
        mySend("close music notify");
    }
}

static void musicTest2(void) {
    mySend("open Snow.wav type waveaudio alias m");
    mySend("set m time format ms");
    char buf[L];
    mySendBuffer("status m length", buf, L);

    printf("Play 3 times!\n");
    for (int i = 0; i < 3; i++) {
        mySend("play m from 0 to 10000 wait");
        mySend("seek m to start");
    }
    printf("Replay!\n");
    mySend("seek m to 0");
    mySend("play m wait notify");

    mySend("close m notify");
}

int main() {
    musicTest2();
}