2849 字
14 分钟
[C#] MCI 详解与封装类, MCI 播放音乐, 获取播放状态, 获取音频长度, 进度调整,
2021-02-11
.NET
dotnet
/
mci
/
win32
/
windows
/
winapi

淦!#

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

首先, 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);
    设备名如旧, 可以直接指定短路径, 也可以指定别名, 而想做到重复播放, 只需要在最后指定repeat

> 同步播放音频:#

  • 同样是参数, 这里是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

    选项描述
    time format milliseconds将时间格式设置为毫秒, 所有使用position值的指令都将采用毫秒作为单位, 你可以将milliseconds缩写为ms. 对于音序器设备,
    time format msf设置时间格式到 分钟, 妙, 以及帧. 所有使用position值的指令都见采用MSF格式(CD音频的默认格式), 请将MSF值指定为 mm:ss的格式, mm是分钟, ss是秒, ff是帧. 如果一个字段以及后面的字段都是0, 你可以忽略掉它. 例如, 3, 3:0, 3:0:0 都是表示3分钟的正确方式. MSF字段有以下最大值, 分钟:99, 秒:59, 帧: 74.
    time format tmsf将时间格式设置为 音轨, 分钟, 秒, 以及帧. 所有使用position值的指令都见采用TMSF格式, 额, 与上面的一样, 只不过多了个音轨. 音轨的最大值是99, 分钟, 秒, 帧的最大值与MSF格式一致.
    any input当录制时, 使用所有支持当前格式的输入, 这是默认设置
    any output当播放时, 使用所有支持当前格式的输出, 这是默认的
    time format bytes在 PCM 文件格式中, 设置时间格式(单位)为字节, 指定这个指令后, 所有position信息都将被指定为字节格式

> 状态信息:#

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

    适用于音频的常用语法

    status device position

    status device length

    status device mode

    status device time format

    选项描述
    position获取目前播放的位置单位与时间格式统一
    length获取当前播放音频的长度 单位与时间格式统一
    mode获取播放状态, 返回的值是以下值之一: stopped / playing / paused
    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

    选项描述
    left/right volume to factor将指定声道的音量设置为指定值
    volume to factor将音量设置为指定值

错误码:#

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

    错误码名称描述
    257MCIERR_INVALID_DEVICE_ID无效设备 ID
    259MCIERR_UNRECOGNIZED_KEYWORD未识别关键字
    261MCIERR_UNRECOGNIZED_COMMAND未识别的命令
    262MCIERR_HARDWARE硬件
    263MCIERR_INVALID_DEVICE_NAME无效的设备名称
    264MCIERR_OUT_OF_MEMORY内存不足
    265MCIERR_DEVICE_OPEN设备打开
    266MCIERR_CANNOT_LOAD_DRIVER无法加载驱动程序
    267MCIERR_MISSING_COMMAND_STRING缺少命令字符串
    268MCIERR_PARAM_OVERFLOW参数溢出
    269MCIERR_MISSING_STRING_ARGUMENT缺少字符串参数
    270MCIERR_BAD_INTEGER坏整数
    271MCIERR_PARSER_INTERNAL分析器内部 (估计是这个API内部对指令分析时出现的错误)
    272MCIERR_DRIVER_INTERNAL驱动程序内部
    273MCIERR_MISSING_PARAMETER缺少参数
    274MCIERR_UNSUPPORTED_FUNCTION不支持的功能
    275MCIERR_FILE_NOT_FOUND未找到文件
    276MCIERR_DEVICE_NOT_READY设备未就绪
    277MCIERR_INTERNAL内部
    278MCIERR_DRIVER驱动器
    279MCIERR_CANNOT_USE_ALL不能全部使用
    280MCIERR_MULTIPLE多个
    281MCIERR_EXTENSION_NOT_FOUND未找到扩展
    282MCIERR_OUTOFRANGE超出范围
    284MCIERR_FLAGS_NOT_COMPATIBLE标志不兼容
    286MCIERR_FILE_NOT_SAVED文件未保存
    287MCIERR_DEVICE_TYPE_REQUIRED需要设备类型
    288MCIERR_DEVICE_LOCKED设备已锁定
    289MCIERR_DUPLICATE_ALIAS重复别名
    290MCIERR_BAD_CONSTANT坏常量
    291MCIERR_MUST_USE_SHAREABLE必须使用可共享
    292MCIERR_MISSING_DEVICE_NAME缺少设备名称
    293MCIERR_BAD_TIME_FORMAT错误的时间格式
    294MCIERR_NO_CLOSING_QUOTE没有关闭中的引用
    295MCIERR_DUPLICATE_FLAGS重复标志
    296MCIERR_INVALID_FILE无效文件
    297MCIERR_NULL_PARAMETER_BLOCK空参数块
    298MCIERR_UNNAMED_RESOURCE未命名的资源
    299MCIERR_NEW_REQUIRES_ALIAS新需要别名
    300MCIERR_NOTIFY_ON_AUTO_OPEN自动打开时通知
    301MCIERR_NO_ELEMENT_ALLOWED不允许任何元素
    302MCIERR_NONAPPLICABLE_FUNCTION不可应用功能
    303MCIERR_ILLEGAL_FOR_AUTO_OPEN非法自动打开
    304MCIERR_FILENAME_REQUIRED需要文件名
    305MCIERR_EXTRA_CHARACTERS额外字符 (可能是指多出了一些不需要的字符)
    306MCIERR_DEVICE_NOT_INSTALLED未安装设备
    307MCIERR_GET_CD获取 CD
    308MCIERR_SET_CD设置 CD
    309MCIERR_SET_DRIVE设置驱动器
    310MCIERR_DEVICE_LENGTH设备长度
    311MCIERR_DEVICE_ORD_LENGTH设备 ORD 长度
    312MCIERR_NO_INTEGER无整数
    320MCIERR_WAVE_OUTPUTSINUSE波输出
    321MCIERR_WAVE_SETOUTPUTINUSE波设置输出
    322MCIERR_WAVE_INPUTSINUSE波输入使用
    323MCIERR_WAVE_SETINPUTINUSE波设置
    324MCIERR_WAVE_OUTPUTUNSPECIFIED波输出未指定
    325MCIERR_WAVE_INPUTUNSPECIFIED波输入未指定
    326MCIERR_WAVE_OUTPUTSUNSUITABLE波输出可居住
    327MCIERR_WAVE_SETOUTPUTUNSUITABLE波设置通普通西装
    328MCIERR_WAVE_INPUTSUNSUITABLE波输入可居住
    329MCIERR_WAVE_SETINPUTUNSUITABLE波设置通图适合
    336MCIERR_SEQ_DIV_INCOMPATIBLESeq Div 不兼容
    337MCIERR_SEQ_PORT_INUSESEQ 端口 INUSE
    338MCIERR_SEQ_PORT_NONEXISTENTSeq 端口不存在
    339MCIERR_SEQ_PORT_MAPNODEVICESeq 端口地图无设备
    340MCIERR_SEQ_PORT_MISCERRORSEQ 杂项错误
    341MCIERR_SEQ_TIMERSEQ 定时器
    342MCIERR_SEQ_PORTUNSPECIFIEDSEQ 端口未指定
    343MCIERR_SEQ_NOMIDIPRESENTSEQ 没有MIDI在场
    346MCIERR_NO_WINDOW无窗口
    347MCIERR_CREATEWINDOW创建窗口
    348MCIERR_FILE_READ文件读取
    349MCIERR_FILE_WRITE文件写入
    350MCIERR_NO_IDENTITY无标识

封装类:#

去这里吧, 在我的另一篇文章中 [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. 音量控制我目前还是没弄成… 不过可以确认的是, 进度获取, 调整, 长度获取是没问题的, 有这些最基本的, 就差不多公用了呢

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

手动翻译, 淦

[C#] MCI 详解与封装类, MCI 播放音乐, 获取播放状态, 获取音频长度, 进度调整,
https://slimenull.com/posts/20210211102111/
作者
SlimeNull
发布于
2021-02-11
许可协议
CC BY-NC-SA 4.0
[C#] 音乐播放 3 种方式 Demo 与 MCI 音乐播放器封装类.
[C#/C/C++] GetShortPathName详解, 长路径转换为短路径
© 2024 SlimeNull. All Rights Reserved. / RSS / Sitemap
Powered by Astro & Fuwari