[C#] MCI 详解与封装类, MCI 播放音乐, 获取播放状态, 获取音频长度, 进度调整,

淦!

琢磨了一晚上啊, 总算有些眉目了. _{(所以我还是一个笨蛋啊, 明明这么简单的东西却花费了这么长时间}

首先, MCI的全称是Multimedia Control Interface, 即多媒体控制接口, 通过它, 我们可以做到播放音频视频, 甚至录制音频, 虽然古老, 但是真的强大.

注意, 文章较官方文档有不少删减, 如果看标准内容, 还是看官方文档比较好.

MCI Command Strings 官方文档: Microsoft Command Strings - Win32 app | Microsoft Docs 哦对了, 文档是纯英文哦~

理论基础:

1. MCI 不能与 C# 中的内存流打交道, 他只能播放文件.
2. MCI 支持很多格式, 包含: CD音频, 数字音频, MIDI音乐, 视频唱片(videodisc), VCR, 以及波形音频.
3. MCI 中, 被播放的音频文件被称作 设备(Device)
4. MCI 中, 支持巨多设置项, 包括播放进度, 音量大小, 声道开关, 如果你播放的是 MIDI, 支持的设置更多.

正式开始:

下面, 我们将以播放音频为例, 尽可能多的讲述 MCI 的相关知识, 文章在今后可能会继续更新.

示例文件在: C:\Users\Null\Desktop\Tutorial.wav

> 引用库:

• 最最开始, 无非是载入库.

1. 对于 C++, 需要引用 Windows.h 以及 Mmsystem.h 这两个头文件
2. 对于 C#, using System.Runtime.InteropServices; 以进行非托管库的调用.

> 执行指令:

• MCI 中, 有 3 种方式来执行 MCI 指令. 分别是: mciSendString, mciExecute, mciSendCommand, 它们均位于 winmm.dll 中.

• 函数原型:

MCIERROR mciSendString(    // MCIERROR 是 无符号长整形数字
    LPCTSTR lpszCommand,
    LPTSTR  lpszReturnString,
    UINT    cchReturn,
    HANDLE  hwndCallback
);
  
BOOL mciExecute(
    LPCSTR pszCommand
);

  MCIERROR mciSendCommand(
      MCIDEVICEID IDDevice,    // 设备 ID, 通过另一个函数打开文件可以获得
      UINT        uMsg,
      DWORD_PTR   fdwCommand,
      DWORD_PTR   dwParam
  );

• C# 声明方式:

[DllImport("winmm.dll", EntryPoint = "mciSendString", CharSet = CharSet.Unicode)]
extern static ulong MciSendString(string command, string buffer, int bufferSize, IntPtr callback);

[DllImport("winmm.dll", EntryPoint = "mciExecute", CharSet = CharSet.Unicode)]
extern static bool MciExecute(string command);

[DllImport("winmm.dll", EntryPoint = "mciSendCommand", CharSet = CharSet.Unicode)]
extern static ulong MciSendCommand(uint deviceId, uint uMsg, IntPtr fdwCommand, IntPtr dwParam);

• 简略说明:

mciSendString: 最常用的方法, 通过字符串来表示一个指令, 会返回错误码, 不会有弹窗警告
mciExecute: 调试时较常用的方法, 在执行时若有未完善的地方, 会弹窗警告, 也因为如此, 程序的发布版本不会使用这个(影响使用体验)
mciSendCommand: 很少用, 通过指令的ID来表示指令, 会返回错误码, 不会有弹窗警告
 
某些 MCI 指令具有返回值, 例如获取播放状态, 这些指令不能通过mciExecute执行.

• 文章只会通过 mciSendString 来介绍 MCI 哟

> 打开文件:

• 对于播放音频, 首要的第一件事, 肯定就是打开文件并将其载入到内存了. 不过有一点很重要, 就是 MCI 指令只支持短路径(ShortPath), 所以在拿到文件路径后, 我们得将其转换为短路径.
• 如果不对路径进行转换, 那么某些名字长度大于8的文件(准确来说是路径中任何一部分长度大于8)的将无法播放

关于短路径与长路径: windows系统下的文件长名和文件短名 短路径与长路径的转换: [C#/C/C++] GetShortPathName 详解, 长路径转换为短路径

• MCI 指令中, 通过 open 来打开一个文件, 并且在末尾还可以使用 “alias 别名” 来为这个已打开的文件起一个别名.
• 下面是两个示例:

// 文件是 C:\Users\Null\Desktop\Tutorial.wav
// 转换为短路径是 C:\Users\Null\Desktop\Tut~1.wav
mciSendString(@"open C:\Users\Null\Desktop\Tut~1.wav", null, 0, IntPtr.Zero);
mciSendString(@"open C:\Users\Null\Desktop\Tut~1.wav alias tutorial", null, 0, IntPtr.Zero);

• 在第一的 mciSendString 中, 很清晰明了, 打开了一个文件, 而第二个中, 我们还加了一个alias, 即, 别名, MCI支持为打开的文件起一个别名, 并且推荐这么做.
  第二个种, 我们为它起的别名是 tutorial.

> 播放音频:

• 播放音频的 MCI 指令是 play, 直接 “play 设备”
• 示例:

mciSendString(@"play C:\Users\Null\Desktop\Tut~1.wav", null, 0, IntPtr.Zero);
mciSendString(@"play tutorial", null, 0, IntPtr.Zero);

• 如果你没有为文件指定别名, 那么在使用 play 指令时, 只能指定短路径
  如果你为文件指定了别名, 直接play加上别名即可播放这个文件.

> 重复播放音频:

• 这里, 用到了参数, 就像alias一样, 可选. 重复播放还是使用的play指令.
• 示例:

mciSendString(@"play C:\Users\Null\Desktop\Tut~1.wav repeat", null, 0, IntPtr.Zero);
mciSendString(@"play tutorial repeat", null, 0, IntPtr.Zero);

> 同步播放音频:

• 同样是参数, 这里是wait, 支持wait参数的指令可以同步执行, 例如play指令
• 示例:

mciSendString(@"play C:\Users\Null\Desktop\Tut~1.wav wait", null, 0, IntPtr.Zero);
mciSendString(@"play tutorial wait", null, 0, IntPtr.Zero);

> 暂停播放:

• 暂停, pause, 用法很简单, 同样是 “pause 设备”
• 示例:

mciSendString(@"pause C:\Users\Null\Desktop\Tut~1.wav", null, 0, IntPtr.Zero);
mciSendString(@"pause tutorial", null, 0, IntPtr.Zero);

> 恢复播放:

• 恢复, resume, 语法是 “resume 设备”
• 示例:

mciSendString(@"pause C:\Users\Null\Desktop\Tut~1.wav", null, 0, IntPtr.Zero);
mciSendString(@"pause tutorial", null, 0, IntPtr.Zero);

> 关闭文件:

• 关闭, close, 语法是: “close 设备”
• 示例:

mciSendString(@"close C:\Users\Null\Desktop\Tut~1.wav", null, 0, IntPtr.Zero);
mciSendString(@"close tutorial", null, 0, IntPtr.Zero);

> 改变播放位置:

• seek 指令, 这个指令比较复杂哦. 语法如下:

seek device to position
seek device to start
seek device to end

• 示例:

mciSendString(@"seek tutorial to 1000", null, 0, IntPtr.Zero);
mciSendString(@"seek tutorial to start", null, 0, IntPtr.Zero);
mciSendString(@"seek tutorial to end", null, 0, IntPtr.Zero);

• 短路径肯定是能用的哦, 我只是懒得写了, 至于 “seek device to position” 的用法, 其中position默认是ms为单位的整数时间哦, 也就是说, 1000代表1s.
• seek 的单位是可以调整的, 继续看哦

> 设置相关:

• 设置, set, 这个支持的就更多了

以下是适用于 CD Audio 的语法 :
set device time format milliseconds
set device time format msf
set device time format tmsf

以下是适用于 Wave Audio 的语法 :
set device any input
set device any output
set device channels channel_count
set device format tag pcm
set device format tag tag
set device input integer
set device output integer
set device time format bytes
set device time format milliseconds

> 状态信息:

• 状态, status, 语法: “status device option”, 返回到 mciSendString 参数指定的字符串缓冲区

适用于音频的常用语法

status device position

status device length

status device mode

status device time format

string buffer = new string('\0', 256);       // 分配一个长度的字符串用来存放返回值
mciSendString("status tutorial position", buffer, 256, IntPtr.Zero);   // 调用
Console.WriteLine(buffer.TrimEnd('\0'));     // 打印返回值, TrimEnd的原因字符串的是长度是256, 函数没有使用的部分仍然是 \0 字符.

> 音频设置

• 设置音频, setaudio, 语法 “setaudio device option”

常用语法:

setaudio device left volume to factor

setaudio device right volume to factor

setaudio device volume to factor

错误码:

• 下面是sendMciString会返回的错误码以及描述(对名称翻译, 然后稍加校正), 哦对了, 返回 0 代表无错误哦

封装类:

去这里吧, 在我的另一篇文章中 [C#] 音乐播放 3 种方式 Demo 与 MCI 音乐播放器封装类. o(〃‘▽’〃)o

附加内容:

• 下面是我的一些发现

1. WinForm 程序使用 MCI 是可以打开 MP3 文件的, 但是如果是控制台程序, 就会出现错误, 错误码266, “MCIERR_CANNOT_LOAD_DRIVER”
2. MCI 的某些指令不能正常使用, 但其实并不是很影响, 例如, “set device audio left/right off/off”, 无法正常使用.
3. 音量控制我目前还是没弄成… 不过可以确认的是, 进度获取, 调整, 长度获取是没问题的, 有这些最基本的, 就差不多公用了呢

放一张我写文章时的照片吧 , 原文贴的哪都是 (笑