[收藏]播放MIDI音乐——使用DirectMusic

天云上人

播放MIDI音乐——使用DirectMusic
By Kylinx,2003-5-15,E-mail:game-diy@163.com
( {( u7 y# U. j! |(转载请保证文档的完整性)

(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
9 {2 K( j) ]$ a* R; u
; U* s. _8 Y0 oDirectMusic主要有下面几个部分组成：
9 k; O' g8 S0 D: B, b9 f
IDirectMusicLoader8
4 G; D/ \2 W+ w, w
* Q+ E4 k/ \- N# T$ r- h! c, SIDirectMusicPerformance8
8 X3 N+ s5 P: k0 j
IDirectMusicSegment8
& A$ \3 G9 W! \$ h+ j! y5 Q4 F3 g! T
& H8 d9 D- ^% |IDirectMusicSegmentState8

  h6 U- z! G" e7 {5 K你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

8 Y, ^# X6 y  S7 qIDirectMusic8

# G& a  {# ^  M0 |( kIDirectMusicLoader8

4 M% N. z, \$ `9 {" yIDirectMusicPerformance8

IDirectMusicSegment8

AudioPath

IDirectMusicSegmentState8

如图:
3 p3 ]1 P1 ^5 E1 `5 J* @
                                                                                                   
( z1 U3 C" s) M! u2 W
  
: _; @- D, f, N/ |5 U6 G
  

6 {: X5 a, z6 `/ Y  L8 [  

- t+ e' S; Q% G& M" e# p5 d4 J7 O  
  `/ w4 @. G! H7 n7 a* T- }
IDirectMusicLoader8,加载器。用于加载Mid文件等等

IDirectMusicPerformance8用来控制DirectMusic的接口
# f' D4 {# R7 J
- s5 @% T' a: I, FIDirectMusicSegment8音乐数据段，加载音乐后存放的位置
4 @% X3 e' P; h2 X! N5 n2 o' f* [
$ {0 c8 l  o, OIDirectMusicSegmentState8 音乐段状态

顺便说一下DLS
& b+ e% J. U' ^
我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
" u: p# [/ y0 v7 c
( t; o: l6 e" V8 `% @* q- |DLS全称是DownLoadable Sounds

6 B3 s# ], p/ h' l2 o& R" QMSDN中这样解释：

A standard for synthesizing wave sounds from digital samples stored in software. The DLS level 1 and level 2 standards are published by the MIDI Manufacturers Association.
# l3 O& l3 y# E! ?: B
% R1 Z$ |9 Q* o2 m" H9 ?0 y原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中

使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
  S9 U2 H. o9 a6 _# _0 ~
2 R) n) O  s( Y# X' K好了，说了这么多，该开始应用了

IDirectMusicLoader8*  pLoader=NULL;

: z7 G" H+ j1 s2 m9 {$ lIDirectMusicPerformance8* pPerf=NULL;

IDirectMusicSegment8*  pSeg=NULL;
6 L1 d' Q3 G4 J0 c' L  V
首先，初始化Com
( M4 r; v0 x" q; h9 X
(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

HRESULT hr=CoInitialize(NULL);
  t$ F7 y5 F* }, N2 l2 R! L1 L
8 b3 O; c: p# E( t5 k8 x( rIf(FAILED(hr))

% C9 E, V6 b$ h; q8 ^1 \{

   处理错误
% j$ f2 R" A. L- V
* C8 u- V1 n9 p2 O) X}
8 X% f/ Q$ C5 z# K7 j4 t' b
以下为了方便，省了错误处理

下面创建加载器

CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
0 {& M  g# E5 W6 X- j
* x  \* x5 q! y9 hNULL,    //不是创建集合
5 o" d5 t' D( r% F! J: f
# u& D) \  i0 [) F3 u: u, YCLSCTX_INPROC,      //创建的环境

6 e' K8 M: J+ x5 z  v3 {IID_IDirectMusicLoader8,    //接口的GUID
9 i: v) c8 M& C; s
(void**)&pLoader);              //被创建的接口指针
7 h) _$ V5 `, R4 d
# Y, }9 n3 k" f0 z1 j  Z! j9 W! {1 l创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID

+ n( `( n' p, z! {5 B4 ~NULL,    //不是创建集合
. f* ^% s' r3 d4 B# ]
CLSCTX_INPROC,      //创建的环境

3 |9 R+ X9 q, m, K+ A; pIID_IDirectMusicPerformance8,   //接口的GUID
5 O% S3 x* T, T  \0 q2 J
(void**)&pPerf);          //被创建的接口指针
9 g( M7 Z; e/ M" z. Q3 T: |* K& `7 p
* t5 y1 g% V; Y. I. R* y初始化声音通道
0 ]. o5 B! u. L' e
pPerf->InitAudio(

( [* }& l) |0 m) Z0 R' s: O) F    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

5 n" o8 p% z6 r; L2 ?' R    NULL,//DirectSound对象的指针，同上

. r/ p' x! R1 j" I. i5 I    hWnd,//窗口句柄

6 n1 ^% y8 O- W" j# [    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

6 k* Z- ^8 G" D) h' v    64, //音乐通道数

5 j' d. U( u5 x7 L5 [  X2 D    DMUS_AUDIOF_ALL, //声卡的所有特性

    NULL // DMUS_AUDIOPARAMS对象的指针

$ J2 @/ k% f8 a# |  f  );

$ U8 z8 E5 f+ L" F4 Y好了,初始化Dmusic完成
# i2 Y  b! M* q  |/ `( g
下面读入mid文件

  
+ M6 k/ ^( k$ Y8 f9 E4 h
pLoader->LoadObjectFromFile(

                CLSID_DirectMusicSegment, //组件的GUID
7 V( [! E' _# s9 d  t: q1 c, O
                    IID_IDirectMusicSegment8, //接口的GUID

2 [1 [2 B) {2 `* G                    file;//文件名,注意用Unicode

                   (void**) &pSeg//音乐要装到的段

  );

从ASCII转换到UNICODE的函数是
3 E9 u# M; s9 f5 K5 J
比如

const int MAX_FILE_LENGTH=128;

WCHAR UnicodeFile[MAX_FILE_LENGTH];
" W1 ]" w# A: F" y. S
0 r# d; L+ d5 W: j  j$ xMultiByteToWideChar(
5 k+ K& Y0 n& g3 d+ g
3 Q2 c# D2 Z- b: A8 c: J, D" P6 \CP_ACP,//ASCII码

   0,//

! X& J  ?" X2 y- ?7 tasciifile,//要转换的ascii字符串
, l  ~* P" k: N. O% y6 \
, y" Y4 y& p# ?1 L -1,//要转换的字节数,-1表示以’\0’结尾的字符串

                        UnicodeFile,//转换后UNICODE存放的地方
7 ~4 U* X1 v  ]0 P
MAX_FILE_LENGTH);

下面播放mid音乐
( X" W' o" ]# H& F8 A, @
pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
: V" {* @# ]% n9 m# D
% t( {' h. b$ a% D, Y* @8 z  OpSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

pPerf->laySegmentEx(pSeg,//要播放的段
* C7 C# O9 \: K
$ M" `+ L, d$ D: z2 mNULL,//保留,必须为NULL
* C  L2 p7 E5 H7 J! Y
NULL,//pTransiton

  q3 L* [$ z+ N+ M9 f0,//播放的标志

5 k+ X. ~& S( S& `& @  F0,//开始的位置
/ ~" P: x' O: \
6 _  r  Y* Z5 g7 aNULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认

NULL//默认的AudioPath

/ D% D: b/ O" x8 u+ o9 y);

2 Z. o3 U5 ^2 d- a  M- H- t暂停播放
( C4 [! r3 C* u& q! D8 f! P
3 @! e( Z1 W) J, @7 @MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

% _" }# k" K* IpPerf->GetTime(NULL, &mtime);//得到暂停的位置

停止播放

pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止
& F' Y, G4 f) q
NULL,//段状态
: ^/ ]! @& ^4 O; Y% d
0,//多少时间后停止,0表示立即

0 r9 t: c. O! H( ?+ d: l0//标志
; p/ I. d% B- ~6 @
+ S/ ^* ^4 r$ P% Y2 U* D);
# F/ |  p# I6 _
5 g8 z# X, G* U4 S从暂停点继续播放

: z, C& B9 M" R1 q# c6 ?pSeg->SetStartPoint(mtime);//播放点
- L+ A1 f3 I; X4 H+ r, W
pPerf->laySegmentEx(pSeg,

+ f/ H* X& l' v1 V/ {: ]7 ONULL,

( c  ~3 O8 z# W' S# lNULL,

/ @0 n& ~, F2 R/ k- _DMUS_SEGF_REFTIME,

0,

NULL,

+ K$ ?& {+ d9 A. NNULL,

% b6 k% w3 y& k/ G3 BNULL

);
3 \& T$ }. q* d1 R: i/ B0 V
* z6 i# o* g. f0 ?1 h# D2 G8 npSeg->SetStartPoint(0);
; M8 B1 i" ~9 \7 t/ x8 o9 l
释放DirectMusic

pPerf->CloseDown();
6 G* ^4 r9 G; A5 O& X4 L$ o) S( w
; |4 M% p# |% x/ g9 G" PpSeg->Release();
* N, O! k. c" t9 w; s
7 L% D' U/ F5 F  r: c! J. A. npPerf->Release();

) ?7 R4 Q2 B0 }8 b$ P( }pLoader->Release();
+ q! A3 z( B# K+ R! @
' u7 E! e" u* [; v  

CoUninitialize();//停止使用COM

好了,整个过程就是这么简单!

当你理解后,可以自行把上面的代码封装为一个类
3 r! W& k! r, N, y0 V0 A  s
& ~# D1 a$ K4 t9 a/ Z; q这样,你就可以在你的游戏中实现MID的播放啦!
2 R. s0 l+ ]9 _) `4 C
当然,播放mid只是DirectMusic功能中很小的一部分

. ?% R9 i+ P8 {7 \: V它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
5 p( ]: O+ i; _5 |# u. o/ ~
最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
6 J7 j' v# `; j
, q* g$ r5 y# k1 O, q2 o程序下载:
6 s6 @( O4 d6 R
  

(参考资料:
/ z3 J) U/ \  V
WINDOWS游戏编程大师技巧
, K+ z2 ^! f, o; F' b3 g( Z2 }
MSDN2003的DirectMusic部分)