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

天云上人

播放MIDI音乐——使用DirectMusic
By Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)
2 h* o+ o3 |* k" y; L
(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

7 g+ X  e- }, `4 W8 M在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分

DirectMusic主要有下面几个部分组成：

( \2 \: V8 b8 m* M/ H8 k- `4 E' y6 EIDirectMusicLoader8

8 }. F2 i2 Q6 M8 Z) v+ JIDirectMusicPerformance8
1 ]7 y: R2 M" h# k3 c7 ]
IDirectMusicSegment8
, U# r9 B1 y" n+ ]' O1 j
) }2 I) ^) k! ~7 ~IDirectMusicSegmentState8

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

. A  t3 M! K  A+ pIDirectMusic8

IDirectMusicLoader8
) U" l1 P7 K5 D- K% h: X( I1 }! U
IDirectMusicPerformance8
+ s5 }' H2 F: f* \/ b9 X# s1 C
5 q) C8 ^* L: U5 Y1 MIDirectMusicSegment8
4 j( j, W3 x5 S; j
AudioPath

IDirectMusicSegmentState8

) I9 |0 I" g) S# V* w) r如图:

1 B- g; k1 q+ r                                                                                                   

  
* L2 F$ B/ V7 P, t3 g
' t8 \1 O7 G) }  

  
- H. Z' K) G+ ~2 t" q. l3 ]" E, A/ S
0 Y* b6 [! B+ s1 }- @" k; @  
7 b1 j8 T+ F$ N+ B
IDirectMusicLoader8,加载器。用于加载Mid文件等等

IDirectMusicPerformance8用来控制DirectMusic的接口

; T/ G/ ]" R. z9 E" [4 fIDirectMusicSegment8音乐数据段，加载音乐后存放的位置

IDirectMusicSegmentState8 音乐段状态
) k% u3 W* D7 l2 m9 j
顺便说一下DLS

我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题

DLS全称是DownLoadable Sounds
2 _) J. T. H4 R/ L
MSDN中这样解释：

0 A6 Q, r& s! a+ Y" W4 L2 _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.

/ q4 e9 z+ P8 Z4 {, ^0 _- r* H原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中

7 {8 d) }0 X, [2 T. i2 M使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）

好了，说了这么多，该开始应用了

IDirectMusicLoader8*  pLoader=NULL;
3 x3 X0 h0 \; \+ k7 N
: _  ^- B: Q) R' FIDirectMusicPerformance8* pPerf=NULL;
8 u# w7 q- h; [9 W; _1 v" T$ u5 W
9 U: S) ~) F/ r. o- k: PIDirectMusicSegment8*  pSeg=NULL;

首先，初始化Com
0 k/ e; q" g6 k2 F0 d: f) B  A
/ r+ q3 z" G: Y4 s6 c( d! a; b(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

0 w+ n' ?: }0 F4 h' UHRESULT hr=CoInitialize(NULL);

If(FAILED(hr))
0 a: D6 ]( K0 h9 T2 b  l
. N# ]! A/ M& m{
' ^8 t# q# A8 O6 U: z1 y! c: y
   处理错误

# K3 z2 j# ]* a( ~8 y}
+ \( T' g0 l# H" X! B6 p
) G7 \" s6 s+ H; b# h以下为了方便，省了错误处理

下面创建加载器

CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

NULL,    //不是创建集合
% i4 O2 l5 b8 X, O3 U. A* _4 x
CLSCTX_INPROC,      //创建的环境
! j% J: y3 m( |; ^1 A% _; ?
6 o" \! N. I! L- e+ Y+ XIID_IDirectMusicLoader8,    //接口的GUID

(void**)&pLoader);              //被创建的接口指针
. Y3 g6 P; G# `+ R7 E5 i
创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
, u/ [( n% B0 ~" U5 z
) A  _2 d, G& C& g$ Y; uNULL,    //不是创建集合

; T7 y& w5 x: y7 `5 q) LCLSCTX_INPROC,      //创建的环境
$ S  f5 m& m8 c0 e* V; n
$ t% w  k. I0 P& YIID_IDirectMusicPerformance8,   //接口的GUID
9 Y. a' Z; n' M- Q! G7 _
(void**)&pPerf);          //被创建的接口指针

' x) k/ P+ O5 Q0 N1 T初始化声音通道
& }. q8 w9 x2 S. ^1 A+ v) r0 y
pPerf->InitAudio(

" K! g& R) f5 R7 v' \" H; b0 m    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
. V7 K' j6 |5 w) C7 E" Y
    NULL,//DirectSound对象的指针，同上

& @% s) v' J+ ]  y6 u& [    hWnd,//窗口句柄
( @2 e4 l( j" n& o3 x3 _
9 H' z  v$ T8 ]: N& C5 N# h    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

    64, //音乐通道数
7 A# Y! q4 t- I; O2 U
3 M, t* X6 z. r( g1 E1 ^( C2 d    DMUS_AUDIOF_ALL, //声卡的所有特性
! O  N' k$ O5 j/ |  T
4 ]  C4 V+ ?' y6 o& \    NULL // DMUS_AUDIOPARAMS对象的指针
# w; \# `: L3 k' _/ w! ^! ], c, W; e
  );
8 s( n' B1 b% ?- \) r. b; l( l
好了,初始化Dmusic完成
* g. g) t( A% a5 a9 Y
下面读入mid文件
/ t7 w* H9 {; Q% Y8 ?6 E) y4 B* |
. v, I( p& c* [  

pLoader->LoadObjectFromFile(
' d& }" Q9 Z, F& G
                CLSID_DirectMusicSegment, //组件的GUID
2 ]+ \* W+ S4 Y# T; R
                    IID_IDirectMusicSegment8, //接口的GUID

                    file;//文件名,注意用Unicode

                   (void**) &pSeg//音乐要装到的段
( R5 A; t# \( L4 L! ^: h$ H# {
  );

从ASCII转换到UNICODE的函数是
9 B  @: Y- Q) j# D5 Q
比如
# x1 v+ ~- H7 o7 ~- n. Z
const int MAX_FILE_LENGTH=128;
1 r) ?4 Q( W1 B. S4 A5 o9 {
WCHAR UnicodeFile[MAX_FILE_LENGTH];

2 l# [8 L, c) KMultiByteToWideChar(
& k" _* s+ [1 M) e* T& D
CP_ACP,//ASCII码

. L: y: \9 N! Q5 ]  t   0,//
" J, ^, S  Q' |7 O5 `% R0 T8 G7 s5 M
asciifile,//要转换的ascii字符串
$ k* k9 l' C& K+ T
8 p/ O3 V7 j! C5 i# e+ r -1,//要转换的字节数,-1表示以’\0’结尾的字符串
- A; b2 `( \* z( i2 s
                        UnicodeFile,//转换后UNICODE存放的地方
: Y" n& `5 q( ~# x( V1 E* h4 Y
MAX_FILE_LENGTH);
  j* j  m, A; `* e: Q
下面播放mid音乐

0 `; m/ H" B' z6 ^- Q9 ~! \- n0 u) mpSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限

pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

pPerf->laySegmentEx(pSeg,//要播放的段

NULL,//保留,必须为NULL
9 O; u: x% ]2 t0 ]" o
NULL,//pTransiton

5 u' d2 |5 h9 i" X! Y( `5 q0,//播放的标志

  s% l% M! e3 t0,//开始的位置

# B+ C3 J, o5 x8 ZNULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认
" ?1 {0 E& i* z6 ]' [- t9 [/ r
NULL//默认的AudioPath

0 e7 n/ j! Q0 V- o7 f2 M" M);

3 \3 L6 s8 K- l6 ]暂停播放
% N' q8 M8 V7 P8 {% q, R5 H
1 w* r* K! k8 O" _) ?5 @; p, D4 U1 rMUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

pPerf->GetTime(NULL, &mtime);//得到暂停的位置

停止播放
) T$ A+ p+ \. D1 }8 ~: H+ I
$ s% C; b9 j, N$ `' d& W4 j3 a8 qpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

4 J# G5 N4 c' C# A6 r& z+ MNULL,//段状态
8 z8 }# V2 P0 ^8 e' v
0,//多少时间后停止,0表示立即

8 [6 m, o/ D3 f! B9 V% \+ T0//标志

);
& ~- p- G8 N2 D1 s4 h8 N
- e& q& C' s0 G% Z* F从暂停点继续播放

: m2 Z, M  W  w+ Z, c) gpSeg->SetStartPoint(mtime);//播放点

pPerf->laySegmentEx(pSeg,
- [, [" X) j9 A) v+ L) }$ t  g
NULL,
8 u: x% ^- k/ j8 N
NULL,

DMUS_SEGF_REFTIME,
5 D( `( ~. D/ m9 U& J( x; Y
0,

% S) m8 T7 m: y) VNULL,
" b' b4 ~3 |. i+ F) x
3 w, F2 N. U! Z' R* m. CNULL,
: L6 ^+ p# }( o1 K1 E3 D' ~
NULL

0 {7 ~- R, J5 z9 k2 E3 A. `0 p);
! V4 z, @' g+ D( G
pSeg->SetStartPoint(0);
  E: E1 B5 y+ E4 K% W
释放DirectMusic
' F5 C1 j9 Y9 c+ m) b* r
pPerf->CloseDown();
9 G: b$ ^/ V* k7 I) B  e$ c) S
pSeg->Release();

pPerf->Release();
# l9 G( z6 x' A. E0 E, n
* Q$ B5 h' M: M4 l% R' lpLoader->Release();
5 P1 i1 {* _1 g/ `
( R' m+ S% n6 m+ g' z8 e  k0 F  
5 q! s; A! f: I
6 {. x5 F9 K$ A& j: ?2 U/ [CoUninitialize();//停止使用COM

, j0 @# c* r' W9 C1 J5 B好了,整个过程就是这么简单!
" J' s3 b& c+ X" a# i! [. _! Z8 ~
当你理解后,可以自行把上面的代码封装为一个类

; x+ B1 f+ K# g2 |4 p这样,你就可以在你的游戏中实现MID的播放啦!
2 M- ?, o% ]; X: e, x+ @. s
当然,播放mid只是DirectMusic功能中很小的一部分

它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
6 ^1 V( N8 l9 q2 U7 e
7 v& }( {  p( @9 t  }最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

2 o" x, S; ~4 Y% `8 |9 [程序下载:
1 P0 E' J% a6 f/ `+ z
  
9 ?8 c. p$ e2 T8 F
(参考资料:

WINDOWS游戏编程大师技巧
( P4 C7 p+ S9 ~! l/ B1 c5 |
( g9 y7 x+ M. i! H: w* @0 CMSDN2003的DirectMusic部分)