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

天云上人

播放MIDI音乐——使用DirectMusic
7 F$ w7 d0 a7 Z9 ~/ }By Kylinx,2003-5-15,E-mail:game-diy@163.com
7 k" B/ p$ v$ N0 s. k+ E/ j(转载请保证文档的完整性)
: r( O9 s/ g4 e
(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

4 w; d# C" o9 ?5 w在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分

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

IDirectMusicLoader8

IDirectMusicPerformance8
! v4 g. _, Z' ^. f
  P. }* i! r& OIDirectMusicSegment8

IDirectMusicSegmentState8
* t; s5 _6 s) f$ v0 w" K& E
& R' C- A$ `/ j你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
- T+ q; @2 y( r. v$ i, \9 g
IDirectMusic8

IDirectMusicLoader8
: o) ]' g: g& ]$ n5 Q; k
7 R1 w" ?+ Z' s* z( _! @( w* [* WIDirectMusicPerformance8
9 z1 d/ H2 |4 F+ p6 P" b
2 u2 H; F% q  ]. O: kIDirectMusicSegment8

9 i  b0 w) U% sAudioPath

IDirectMusicSegmentState8

  v* [3 `9 @7 w如图:

                                                                                                   
3 X3 f! Y$ g% S6 u' Q
' }& v7 f% K4 h5 \, P/ v  
7 X" m5 ]8 h' }5 p/ W
  

  
, t# o% M# x: `% h8 V' w4 S
  

IDirectMusicLoader8,加载器。用于加载Mid文件等等
8 V  W. v' a+ w' {& j6 N8 m/ V  E2 \
) g" q# S: {" j0 jIDirectMusicPerformance8用来控制DirectMusic的接口
$ {* J* R" y+ [* o
4 P( W' c; R$ \0 UIDirectMusicSegment8音乐数据段，加载音乐后存放的位置

IDirectMusicSegmentState8 音乐段状态
9 |. S4 V; n& b+ u
顺便说一下DLS
, H/ G+ n$ R! q1 }; w+ D( [" r6 Z' f
) g8 ~1 E' q1 [" V我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
* u8 e/ R" `8 e$ L
DLS全称是DownLoadable Sounds
$ r: D0 Y3 R: J3 j. |
MSDN中这样解释：

% b4 e9 j3 |- eA 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.
, A" j* i% j- W/ E
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
! B& d6 c1 Q" t+ v" ?
& F/ p: |: g+ a5 `0 E  R9 u9 S使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
5 V  p0 |  i5 h. y% ?
& L& _$ ?/ O0 x6 r% A! J好了，说了这么多，该开始应用了

IDirectMusicLoader8*  pLoader=NULL;

2 I9 J& d( a  e% Y$ a9 u' \! G$ }IDirectMusicPerformance8* pPerf=NULL;
  C/ C% G7 i1 n5 V) c; P
& e; h$ ~" Z7 S) [7 aIDirectMusicSegment8*  pSeg=NULL;
2 [! e% z$ ~5 q2 x9 Q! r
' K- e; c5 ?  ~. @4 C9 y! m% y首先，初始化Com

(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

HRESULT hr=CoInitialize(NULL);
2 q0 e7 n& ^7 P0 x2 I/ n" X
, M& D8 v+ S; y2 b" hIf(FAILED(hr))
. ^$ e+ O# }; F) h8 m! Y
7 [" j7 M8 O" a5 A* X. Y{

3 x+ P% Y4 g; X3 L" o& L6 @0 L" W   处理错误
( F8 w- o0 o) M9 @" ?2 y' f
9 `' A  C- N% j0 @1 j) S}

9 j& e2 W7 x0 c/ i以下为了方便，省了错误处理
+ A. n2 w/ U& l5 ~. U- |
下面创建加载器

& X1 Z7 l. M! {CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
. M5 d( [5 Z: j; @" ]+ r
NULL,    //不是创建集合

# P! n7 e9 c  s% c; v' h# F8 QCLSCTX_INPROC,      //创建的环境

, }1 Y/ Z3 c( G" I% nIID_IDirectMusicLoader8,    //接口的GUID

(void**)&pLoader);              //被创建的接口指针
: l4 z' T; _6 O( K, Z
创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID

NULL,    //不是创建集合
; |9 r  F! C" Y3 x6 z
9 v/ ?- F1 W5 y1 w1 b; k& V% yCLSCTX_INPROC,      //创建的环境
6 `7 U* N- ^4 B
IID_IDirectMusicPerformance8,   //接口的GUID
, c! c7 H/ X3 R: R# A+ ?
  M/ t8 y/ K$ |, N! E; T(void**)&pPerf);          //被创建的接口指针
& e1 X: l, Y  c2 u  N# @
; }) a2 d! U8 e5 y初始化声音通道

pPerf->InitAudio(

6 I/ ?) R" d; K- H% p8 g1 P    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

% K$ L0 S$ K7 X    NULL,//DirectSound对象的指针，同上
( B$ c2 m* k( O
    hWnd,//窗口句柄
+ V% g( Z; W7 A9 M. O
; i, a- Q- ^, \! d5 O- |    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

    64, //音乐通道数

+ T2 J- p$ J/ A! F$ c    DMUS_AUDIOF_ALL, //声卡的所有特性

) l3 ?& w' b" _3 j7 W) k9 z    NULL // DMUS_AUDIOPARAMS对象的指针

  );
6 |; \1 s) o' s: P
好了,初始化Dmusic完成

+ `0 ^$ G* l2 W下面读入mid文件

  
- a$ p! }' v2 v* I/ E" a/ C, W
pLoader->LoadObjectFromFile(

  k2 O" x4 f- Q0 @( J4 I                CLSID_DirectMusicSegment, //组件的GUID
8 [! c) j. i' |8 J
/ G' p9 F1 P1 I0 l# W                    IID_IDirectMusicSegment8, //接口的GUID

# j. C* x; c  C" Q) f3 q' T, e* y. {- a                    file;//文件名,注意用Unicode
% M5 J$ y1 b5 p) }
0 u, n# D  }! r" H- I) i2 K. S+ W                   (void**) &pSeg//音乐要装到的段

  );

0 ]& t5 S1 f' Y/ m. w) o) H2 p从ASCII转换到UNICODE的函数是

1 z+ G5 ]* o4 `/ ^& e# J比如

const int MAX_FILE_LENGTH=128;
6 O6 |2 J9 w8 r! \: {3 I% ~
: e5 Y: e# h- O1 Z8 ]WCHAR UnicodeFile[MAX_FILE_LENGTH];

! i5 E3 K) w8 |+ L4 oMultiByteToWideChar(

CP_ACP,//ASCII码

   0,//
2 B' V- Y- l/ a
& M: C2 J5 Y, Q/ H- }9 sasciifile,//要转换的ascii字符串

+ a/ R! E* I) P( u, @, v' h -1,//要转换的字节数,-1表示以’\0’结尾的字符串

: @, ~$ |; Q7 Z. D1 ^  d" h. q- R                        UnicodeFile,//转换后UNICODE存放的地方

MAX_FILE_LENGTH);
! @. U, [8 b( `1 h
下面播放mid音乐
; H3 ]0 e' c* Y+ M! O
pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
: r1 l: s5 w* W! c" D" v
  p9 Y3 a/ S5 G2 G( TpSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
- y& V# f8 ?( ~& D
pPerf->laySegmentEx(pSeg,//要播放的段
' ]' S: v0 k3 ]: ^/ v& K' Z+ M$ g
NULL,//保留,必须为NULL

  u# B1 R# n6 g6 t5 g2 k; f+ ENULL,//pTransiton
: g) J! v+ M/ X4 O5 o6 g1 h
0,//播放的标志

0,//开始的位置
6 t- z6 y5 Z5 }, R, U2 Q2 {8 g
& k0 P% J4 t- F2 j$ gNULL,//用与接收段状态的指针,如果不需要,就为NULL
# {3 {! @# D: K# {' m
NULL,//使用默认
) U/ \5 T2 v* _+ F8 b
NULL//默认的AudioPath

4 z" s6 ?' k. A, D( d/ d6 b  ~# m' s);
( l. z8 |# O; V8 o  G- k9 E
暂停播放

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

1 C0 _  m4 @! Y  f! k: _8 a  QpPerf->GetTime(NULL, &mtime);//得到暂停的位置

停止播放

4 o( Q: N0 B" B$ V  a& A* V7 KpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

NULL,//段状态
8 h4 s3 @" Z+ o
0,//多少时间后停止,0表示立即

' t5 r$ N6 h8 k6 X2 h# G+ ?0//标志
4 N8 Y, a  Y/ {( E8 F8 }, g" M
);

从暂停点继续播放
! Y& y* _2 T7 W$ d5 Y# ~1 s
pSeg->SetStartPoint(mtime);//播放点
7 ]9 I8 b( |# \# ^  S
( u! W7 V4 V4 z3 o: OpPerf->laySegmentEx(pSeg,

NULL,
  K8 m* z& ~" D. w+ R/ e
  f, J  B' v5 d$ Y# {- BNULL,

5 z: Z8 W* \1 wDMUS_SEGF_REFTIME,

! k- _6 x1 J! k* I  |& F1 y8 O5 a0,

! M  B! t% N+ _NULL,
# d. s& h4 ?  F- X7 @
0 }# q/ n6 Z8 xNULL,

7 e3 W  P) n2 s2 `% JNULL

);

0 G4 T2 o( E6 ApSeg->SetStartPoint(0);

3 z) y  i6 X: P释放DirectMusic

( P" B5 [% y; G  p' S9 bpPerf->CloseDown();
7 a+ X5 f% S3 B& L* ?
pSeg->Release();

pPerf->Release();
5 c( {5 I! C% t, }
/ w2 ]% E9 P# f- u2 S" cpLoader->Release();

  
3 V4 d  d7 O! V5 Z; J, a' s, E1 Q: C
CoUninitialize();//停止使用COM

4 I8 a  r% a) H0 X0 I8 a$ P$ j好了,整个过程就是这么简单!
/ n6 u0 N6 y6 i: v
当你理解后,可以自行把上面的代码封装为一个类
% H  w; h& L7 Y, g. U+ H
8 t; o2 v3 L$ T3 {- S这样,你就可以在你的游戏中实现MID的播放啦!

当然,播放mid只是DirectMusic功能中很小的一部分
4 p" j, i- f7 j
+ l4 L7 {, u% O8 I* L它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
$ k4 b1 H) G, E: K
最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

8 i; X5 h. Y4 S! h8 ^2 y程序下载:

  

(参考资料:

8 E; n2 x! P4 _4 w: ~  mWINDOWS游戏编程大师技巧
' I: F* P! f5 H$ [, f' i* Q
MSDN2003的DirectMusic部分)