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

天云上人

播放MIDI音乐——使用DirectMusic
# Y7 ]# a, i/ l( tBy Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)
1 l  X6 u( O7 l
2 h. I0 b% _7 Q(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
" p1 W) D& X9 S6 m0 d5 ^
' j& y5 D5 n$ C9 a3 j1 lDirectMusic主要有下面几个部分组成：
' D# Y* B7 \, j* Z: c- x3 \, m
  r( C1 s! r. Q% n9 }2 eIDirectMusicLoader8

" G3 R8 a- N  w1 ]. UIDirectMusicPerformance8
0 L% v# r& F5 P; ]7 y
IDirectMusicSegment8
4 U, z$ ]; d% n1 n; D2 h- K: m" E& R
IDirectMusicSegmentState8

, \, @5 z" g, i& a0 f% ^你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
7 b6 p( [- [* U. J% s
IDirectMusic8

IDirectMusicLoader8

# w* S5 e" X" J+ Q# `4 ^. H. }IDirectMusicPerformance8

IDirectMusicSegment8
& K3 a' a( B3 H; ~8 |  s
, n: e5 S1 M1 d- NAudioPath
% |3 Q, {0 |7 u" G
5 s) ?! u# }% R' xIDirectMusicSegmentState8

如图:

                                                                                                   
2 @" A# c6 o! d. O" x
  
/ r# J) i- Y2 P" t
* d* m9 \6 r) D& N+ M! h  
( G) d9 f6 \2 q; Q' [0 g
: b/ I" y* E* p, w1 Y) W9 Y  

/ [8 ]. U! a) T" K" U7 @  
) a+ ]% q; C8 q1 I; y- z8 R+ ?3 z! p+ ~
IDirectMusicLoader8,加载器。用于加载Mid文件等等

IDirectMusicPerformance8用来控制DirectMusic的接口
2 T5 h. v) @5 \% _
IDirectMusicSegment8音乐数据段，加载音乐后存放的位置

IDirectMusicSegmentState8 音乐段状态
5 N- d* c. Z' _2 Q" F
顺便说一下DLS

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

DLS全称是DownLoadable Sounds

! V9 l9 }( x2 |& h, T+ X+ mMSDN中这样解释：

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.
. e7 I5 [2 \4 E" C  J
( b  Y: }  z  }7 |: N" P原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中

使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
& V9 c; _; V! O9 B( K6 h
7 b: O  f) D% h( p1 Z好了，说了这么多，该开始应用了
% o, j" U2 l8 h! q+ P! ~2 \: M
; Z2 }  y; }% bIDirectMusicLoader8*  pLoader=NULL;
$ g# k7 F/ h& o, j+ L, X
IDirectMusicPerformance8* pPerf=NULL;

6 W! o( c" D6 ^5 f: CIDirectMusicSegment8*  pSeg=NULL;
0 K$ e3 m9 n6 J. t) {; G. z' Q0 m
首先，初始化Com

(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
# q. F" k3 C! b. Y6 x' D
8 y2 C5 u9 X  H1 g/ y# e7 a  UHRESULT hr=CoInitialize(NULL);

! c$ e' u, k1 y/ r* q% o2 qIf(FAILED(hr))
7 [" E" X" a. W4 G
9 w' _0 z/ y) D  [' j{
# S( M" U% k( q0 B. t. f
) Z1 _& C* j( W, ~: Y) g   处理错误
$ j* \( E; t( y  X
! [  k* R7 p+ i" J+ e}

以下为了方便，省了错误处理
+ i: Y3 m* H8 o$ v: C
下面创建加载器

CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

6 |) i9 g! {2 `5 vNULL,    //不是创建集合

, [7 z. b$ F7 L! A7 _5 D2 w' CCLSCTX_INPROC,      //创建的环境
" j& I9 x, [; J3 \/ l$ ~3 j
IID_IDirectMusicLoader8,    //接口的GUID

. K4 n( s4 n& g+ _(void**)&pLoader);              //被创建的接口指针

. m8 a; d$ J# L( l5 f& a: A' a/ R  |7 W创建“表演”，（控制器）
0 A' T6 \; z8 x% k. l6 g  s
4 H, O; n9 z9 j. ^CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
/ @/ F- G0 f1 ~  y5 v
NULL,    //不是创建集合
8 [1 a7 F; K$ u
CLSCTX_INPROC,      //创建的环境
0 M- E& d- L# u# I. y
' q7 N. W& t# {5 P  E/ s/ NIID_IDirectMusicPerformance8,   //接口的GUID
* {% ]$ i. s5 Q8 _' o9 C/ I
(void**)&pPerf);          //被创建的接口指针
0 w& i8 U1 @1 k7 T
# c7 ]0 l; i5 o0 d! i6 d初始化声音通道
  J9 I; o$ p- F2 q: `
pPerf->InitAudio(

    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
  {6 w+ z; b$ b: c3 K" B
/ k' L( x# B$ s' z    NULL,//DirectSound对象的指针，同上
1 J7 @; J5 q6 O8 u# c: `
    hWnd,//窗口句柄

( n4 S( o6 h' }9 s1 P- m2 D, u  [    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
7 w  ]! q1 C8 b! ]7 Z3 v: E
    64, //音乐通道数

    DMUS_AUDIOF_ALL, //声卡的所有特性

! l, y" r4 M4 V# b' e1 {; g) Y    NULL // DMUS_AUDIOPARAMS对象的指针
# ~/ L% g! B# ]
' n8 b1 b' F( M5 F' e+ R+ f  );
0 c) @- t* V/ v) }  D+ g
& v' w5 q9 h' u: K; Z: Z  \* X0 x* e  @好了,初始化Dmusic完成

7 F6 E3 k# {$ M, d, d7 V下面读入mid文件

  
9 M, ^9 W% o& _! U
) m+ \2 _, v" s$ E+ @6 d% \: ppLoader->LoadObjectFromFile(

                CLSID_DirectMusicSegment, //组件的GUID
+ _2 N0 t* n  z) k8 }* H" k
( ?5 A/ O4 {. K2 |0 Q/ x                    IID_IDirectMusicSegment8, //接口的GUID

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

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

3 }- C& @/ ?% t  ~7 d  );

从ASCII转换到UNICODE的函数是

比如
: A' y1 ]$ Y9 {" q; b, R1 c
const int MAX_FILE_LENGTH=128;
( _5 {; j5 a0 P" U" ^
WCHAR UnicodeFile[MAX_FILE_LENGTH];
0 s, f3 F( D7 Z! j3 o& z
MultiByteToWideChar(
7 H* x' f* m$ l/ @- f& H5 H1 Y
/ c$ E  S2 r" Q7 p8 }. PCP_ACP,//ASCII码
" N3 u7 y* ]7 v( \$ j% n8 I
( d# V. e5 o4 A% G2 y$ s3 `   0,//

6 B1 `' g' y/ j6 |' wasciifile,//要转换的ascii字符串

7 Z8 B, F8 p( q  Z -1,//要转换的字节数,-1表示以’\0’结尾的字符串

3 @2 Y; S% Q% G( ?/ j6 D                        UnicodeFile,//转换后UNICODE存放的地方
/ K( _* B2 u  g4 C" s# s
1 F1 M5 |+ ?* R# e+ ~+ E0 yMAX_FILE_LENGTH);

. j7 }: C+ H! E2 ~6 F& S. w下面播放mid音乐
) ^" P! ]5 o+ Z1 f& G
, N# Q1 h6 V3 v; opSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限

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

pPerf->laySegmentEx(pSeg,//要播放的段
) S7 s# J; e( A" c; p
NULL,//保留,必须为NULL

NULL,//pTransiton

0,//播放的标志

0,//开始的位置
/ v6 ~2 V* A. y( ~
. \) l) A- ~" ]8 u. oNULL,//用与接收段状态的指针,如果不需要,就为NULL
5 E( L1 I, {; |/ }/ I
NULL,//使用默认

NULL//默认的AudioPath
' q& ?- D8 p7 c- C9 O, {8 I% N& Q
- }1 \0 v& h- b; L);

暂停播放

MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型
9 s/ C0 k+ I& o6 f. T
  ~; |: `* v6 q9 c% a) ?' n# T5 d/ b" _) UpPerf->GetTime(NULL, &mtime);//得到暂停的位置

2 P. e" K% j8 u3 p- ^: p# X+ f停止播放

pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

NULL,//段状态

0,//多少时间后停止,0表示立即

; P6 S+ _& }) T2 ?2 N0//标志

);
" d* N: t$ U0 l: k
从暂停点继续播放

pSeg->SetStartPoint(mtime);//播放点
3 `* ~/ Y7 t& f' H' b1 j& H
# T- p- t2 q+ Z! a. t6 VpPerf->laySegmentEx(pSeg,

0 I. X1 j) }6 ~. JNULL,

NULL,

DMUS_SEGF_REFTIME,

9 V+ r, i. G' I- j0,

# A3 ]7 X- [. Y1 yNULL,
6 s+ d! I6 I* w9 J, ~& u& q0 \9 V
' L, v9 a7 }1 }NULL,

NULL

) Q6 z5 l! O, \3 d& Y& W( ]( c4 W);

/ P) _3 @. B/ [$ N/ XpSeg->SetStartPoint(0);
! P5 |8 C( @: [# v7 e: g
  O  q& j% j+ ^! k- {- f释放DirectMusic
. V) h0 T2 ~; W- d8 P
+ D. ~( S9 L" Y3 L) {+ J, upPerf->CloseDown();

pSeg->Release();
7 W. |0 ^' q# T* N
pPerf->Release();

7 L4 @! e1 D' F3 \- C) G5 m5 t! c" IpLoader->Release();

2 Z; ?( o& q8 o; z8 y1 F' y' y  
. Q+ j) q! T5 y6 x( H% |
9 \4 f8 W* t2 C" Z7 D* xCoUninitialize();//停止使用COM

- W" g4 R" T! o  r# _6 Y好了,整个过程就是这么简单!
: V/ u" s/ b& g: b$ i
/ I. l; Z3 R! k当你理解后,可以自行把上面的代码封装为一个类
) q4 Z$ w5 |) H3 v
这样,你就可以在你的游戏中实现MID的播放啦!

当然,播放mid只是DirectMusic功能中很小的一部分
" h2 F/ _6 V3 T, ~3 y5 k
它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
; |# g2 [7 u. H$ {/ u
2 E' g) z1 J, d" _, n& Z最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
" R1 ^0 o; w+ j' N7 ~/ S6 F
3 x7 h% F. }3 H8 t$ u1 O程序下载:

  
+ K0 H, F& M. s. i' S% h
(参考资料:
( d$ Y/ b) d  \  O& ^' Z- |; O
1 O2 |8 B$ @4 U+ eWINDOWS游戏编程大师技巧
* M( _7 Q  O5 ?* [4 |' H9 Z5 P4 B
) p- O1 P) N4 WMSDN2003的DirectMusic部分)