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

天云上人

播放MIDI音乐——使用DirectMusic
( B! P! G& H" H0 ~7 y: ^1 W$ {By Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)

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

在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分

DirectMusic主要有下面几个部分组成：
; U% {: e4 n: H
; p. P9 f5 y7 hIDirectMusicLoader8
; l- g( y4 h7 I! c- c+ `# H/ p
IDirectMusicPerformance8

IDirectMusicSegment8

IDirectMusicSegmentState8
- d9 Z- r9 o. |- l  ^# Y
你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
# P& G+ ^# H/ [* u. C' h
( I" c9 `( i8 OIDirectMusic8
. W: S) v3 Q9 C" W' `
  ^+ r" w7 K3 v8 m# K" ^$ EIDirectMusicLoader8
- g3 a$ s; G' c  w' f* |4 H! n( X
5 }- s% K+ Q9 q. `1 ~IDirectMusicPerformance8
) o/ z% n5 T6 B: n
9 A, M+ c" R( |3 mIDirectMusicSegment8

+ f! j7 I& |3 p% h) t7 `AudioPath

IDirectMusicSegmentState8

如图:

                                                                                                   
$ _( Z( N' M, h8 s
. l$ f8 |2 Y/ V0 R+ t$ n  
! g& v  w; E) p  q0 C0 v- }" k
  
; b' o4 E$ ^/ J7 k# P. D6 c5 `
  
3 U- T7 Z, }) n- N/ T+ ~
  

' L. b# \% P. g2 |IDirectMusicLoader8,加载器。用于加载Mid文件等等
' ]( i. N# z6 E  [+ \
0 ?) T# M1 ~0 kIDirectMusicPerformance8用来控制DirectMusic的接口

IDirectMusicSegment8音乐数据段，加载音乐后存放的位置

IDirectMusicSegmentState8 音乐段状态
. n! a7 o' O) V/ ^
顺便说一下DLS

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

DLS全称是DownLoadable Sounds
/ y% y) t8 o: c# Q/ d: g
$ e) Q3 e7 e9 _  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.

9 o0 k) s: I$ `5 x  s, m: B" A+ S原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中

4 e: n6 F1 _! V  b: P使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
, a# O  H' s4 P1 f0 u3 y
好了，说了这么多，该开始应用了
! D* n" g/ N" ~- ?7 L! V( |/ n
& }8 w7 G4 W  H% |IDirectMusicLoader8*  pLoader=NULL;
; {- X0 u4 a* N' [  v- ]: f4 S* d! @
IDirectMusicPerformance8* pPerf=NULL;

IDirectMusicSegment8*  pSeg=NULL;
; a, T' r$ g* R1 l- l- i
首先，初始化Com
0 R6 V9 @0 o8 |- x
(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
8 q' R/ ]2 }% a( B6 f/ D
HRESULT hr=CoInitialize(NULL);
+ R" }. P; U1 l- B. q
If(FAILED(hr))
# P. q; _4 _. [* |) x4 Z6 \
1 S+ x  O7 ^; U, Q{
. V1 ?' N( k& l- I1 ?
1 }% [$ }4 K4 f% R! H   处理错误
8 H; ]0 q) L& N
5 b& {) m' g  `: ?. K5 X1 J}
; j9 e  m4 L. U" d1 ~7 z3 f" c
以下为了方便，省了错误处理

( H' g, J; d/ c" s' {7 y  E$ V3 T下面创建加载器

/ r! a1 V/ F9 a7 X% g% V6 }CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
5 {7 p5 W6 I  [. n
3 b! c5 x7 W- u  t, U: ~NULL,    //不是创建集合
* w- h" Y! w" A' P# S
* w/ F) y+ x/ U. l$ YCLSCTX_INPROC,      //创建的环境
  d0 W8 q$ ?2 N
IID_IDirectMusicLoader8,    //接口的GUID

(void**)&pLoader);              //被创建的接口指针
: h* t! W! Z' E6 @# h
3 N1 m/ a& N2 s% T% ]7 z. @创建“表演”，（控制器）
3 x- l8 |3 p: n2 D2 A2 a  R
+ w, ?8 Y* R6 C$ x% W* v% kCoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID

# y( d+ }( J# n' C) A* NNULL,    //不是创建集合

! H# y& {0 D8 k/ x" }* eCLSCTX_INPROC,      //创建的环境

: [+ D( }, x1 o8 v) n, o6 EIID_IDirectMusicPerformance8,   //接口的GUID

1 }4 D8 P1 H: K, C# m. {2 {(void**)&pPerf);          //被创建的接口指针

" }/ C. s/ }7 N( d: h$ F# R3 j: {初始化声音通道
2 b% I. z2 j- C7 z0 S
pPerf->InitAudio(
/ k- I& g6 r, j: J6 c2 i. t
    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
' u! Q2 p* U5 S1 u0 |
    NULL,//DirectSound对象的指针，同上

& O! m' a" S% s3 y. G' F  E    hWnd,//窗口句柄

    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

  m& m$ W' p( ?  ^; I+ P' J    64, //音乐通道数
/ M+ N: L2 u- X1 b/ |) j8 s7 I
    DMUS_AUDIOF_ALL, //声卡的所有特性

$ g5 f2 W; U+ c* @4 S) t- {    NULL // DMUS_AUDIOPARAMS对象的指针
) k" s! |- x4 s
  );
1 p& I- \% v- g
好了,初始化Dmusic完成

下面读入mid文件

8 n; x, Z- c+ D  n  

; F+ T8 t" E+ ~7 |8 c. spLoader->LoadObjectFromFile(

4 A3 j6 O( i. Q2 e! e6 S4 r7 q4 G                CLSID_DirectMusicSegment, //组件的GUID
' s1 j2 P6 h% _/ F# T- ?; r
                    IID_IDirectMusicSegment8, //接口的GUID
  \* y2 M' F  Q
                    file;//文件名,注意用Unicode

                   (void**) &pSeg//音乐要装到的段
1 d5 X  y( d$ u, v5 t+ v
  );
& |& j5 Y" L9 K& R# k. `( M$ O
+ z4 ~0 P+ H" q" ?% c从ASCII转换到UNICODE的函数是
5 x: g* R& I( |# M5 D: T
( B2 @5 r6 h- ~' k' M比如
2 `9 ?- \$ i( i; `' K. K
const int MAX_FILE_LENGTH=128;

0 `- ]% P0 S1 p* w/ XWCHAR UnicodeFile[MAX_FILE_LENGTH];
6 @+ j2 H$ |& E+ S2 z
. h: p$ U: |, Z: S( o1 \MultiByteToWideChar(

$ f! L  Z# z& J5 V- I  BCP_ACP,//ASCII码

   0,//
; j0 t) ]. E0 b1 n, s" q" a$ Q3 ?
4 C* y. v# H  J* m: Vasciifile,//要转换的ascii字符串
- }2 p2 O/ n8 Q! I  e0 r4 C
0 v' j/ Z* |7 E' _5 ~, b1 A, K9 I -1,//要转换的字节数,-1表示以’\0’结尾的字符串
# \3 V- i) `1 e
                        UnicodeFile,//转换后UNICODE存放的地方
6 {+ `. _% G1 s: U; l* _% [
MAX_FILE_LENGTH);

5 K" c8 ~  E( ~9 U/ Y. w; ^下面播放mid音乐

0 |+ D; C( o, }7 d0 EpSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
1 t  c) ^3 g0 W/ L
pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
9 I) y2 t/ V, k9 B( a
/ b$ R( m6 C8 b7 i0 O5 y% K4 |pPerf->laySegmentEx(pSeg,//要播放的段
8 l, b" U+ {/ \5 s
% P' z# Z& J" \NULL,//保留,必须为NULL
% c1 I* Q; z2 [) f
* U1 V" b# J! p$ \$ f: _NULL,//pTransiton

6 z# i6 y! ]7 @. V0,//播放的标志

& `3 V6 D$ t& G6 A7 b" |( V) u* q0,//开始的位置
+ x. _& ^2 L# r4 D7 q
NULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认
4 G9 X! p# ?, Z$ d! o. G) M
NULL//默认的AudioPath

);
" ?! c" ?& g5 a- M5 ]( Q1 B
暂停播放

MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

pPerf->GetTime(NULL, &mtime);//得到暂停的位置
% k- L$ g2 C# V# `! H; _: C0 p
! M7 L" |. X6 H, P停止播放

+ H5 z# [9 _1 |! }& t7 j1 JpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

NULL,//段状态
6 I% ?6 W$ H; X( b
0,//多少时间后停止,0表示立即
+ h6 y- D$ F! O) v% @* j
0//标志

);
( t$ W/ V4 j9 p1 P. T* d/ w
从暂停点继续播放
. K, L( G, G1 B: e
& M: V* o6 V5 a$ m) J+ HpSeg->SetStartPoint(mtime);//播放点

pPerf->laySegmentEx(pSeg,

! r# M" S6 `; S1 Z$ ]NULL,
  R# Z3 D) m4 |; ?2 u# p
NULL,
  H8 _0 S; t8 u0 f/ i+ c9 d$ P7 ~
) b8 F, l9 `1 s2 x% P: B0 bDMUS_SEGF_REFTIME,
1 I  v' k, [: g- J1 u6 b6 w# f7 ]
0,

NULL,
& S7 ~. A# M, l; i# k: w
! j: y. H. a3 G4 L! m3 eNULL,
- v) [2 ^' u  Z  j/ _
% I& Z5 I' e- G4 k( L  KNULL

);
: t4 \7 j3 R2 m6 g
7 x& ]/ g0 A+ A) v% ?& z( k) Y. G( ~pSeg->SetStartPoint(0);
9 E8 T' P* V8 G/ }2 S0 N( V7 h8 T. H
释放DirectMusic

pPerf->CloseDown();

pSeg->Release();

; V2 E) y% n* O0 fpPerf->Release();

pLoader->Release();
6 Y( O% L. F+ l* [  z
  
1 f8 _5 i# H" M) w  [; T" F( F
2 F6 n6 u3 _" I' s1 ]5 s% ?CoUninitialize();//停止使用COM

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

当你理解后,可以自行把上面的代码封装为一个类
- o0 [$ W/ \) l0 X+ _8 c, k9 \
这样,你就可以在你的游戏中实现MID的播放啦!

4 t+ b4 D% g, K& _1 W- R4 V当然,播放mid只是DirectMusic功能中很小的一部分

5 {' x+ X, I' o4 F! I: J# c! S它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
" L* d9 [2 W) b4 m; I
6 G; h+ A* f( \% y* B% w& ?最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
5 w* O% ]3 \3 V1 t  H% F* [
程序下载:

  
4 m. F' N9 T: I
(参考资料:

- d- s* c4 w0 s% NWINDOWS游戏编程大师技巧

MSDN2003的DirectMusic部分)