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

2023-10-23 21:06| 来源: 网络整理| 查看: 265

淦!

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

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

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

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

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

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

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

> 引用库: 最最开始, 无非是载入库. 对于 C++, 需要引用 Windows.h 以及 Mmsystem.h 这两个头文件对于 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:ff 的格式, 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 / pausedtime 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无效设备 ID259MCIERR_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获取 CD308MCIERR_SET_CD设置 CD309MCIERR_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 端口 INUSE338MCIERR_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

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

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

【本文地址】

公司简介

联系我们