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

天云上人

播放MIDI音乐——使用DirectMusic
* o% }$ m- U( ?By Kylinx,2003-5-15,E-mail:game-diy@163.com
' g: W) v. t3 }6 Y2 }2 G: ~( [+ S(转载请保证文档的完整性)

7 Y/ B3 p: A( f  ]7 _(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)
* r( D6 K6 y* W" _
4 J: u: t4 T2 e! }) T5 z在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
9 `% {' d; y7 W: q, c/ [. H) ]+ ?
DirectMusic主要有下面几个部分组成：
+ }/ k( @% p! t1 b8 K5 I6 M
4 T3 F' n% Z  o6 y2 YIDirectMusicLoader8
) e; C. e* \4 Q' R& v. ^- z4 X4 z: F
IDirectMusicPerformance8
6 [& t5 u6 L4 H# X
( R- O7 j3 H! C2 v+ WIDirectMusicSegment8

8 y/ Y' |+ A% B6 L1 LIDirectMusicSegmentState8

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

  ~) }. s) r- a9 t' pIDirectMusic8
5 \& H& z2 `& J. N; s% G
; X3 N9 e, d% z  {IDirectMusicLoader8

IDirectMusicPerformance8

4 Q% K0 [& {( f+ V+ y5 \IDirectMusicSegment8

AudioPath
, Y: Y8 V* h0 g5 ?; \8 X
IDirectMusicSegmentState8
" }4 I. L/ c2 F& ?
" v' Q: C. n7 _9 @如图:
( C6 ^) E/ @* D
6 m( x2 U4 {8 a0 H                                                                                                   

  

  
7 A% r5 a  U3 d6 Q8 p
  
1 R+ S- k; c- f) H
1 k) v4 S0 ~& @% Y  

0 |8 A! j1 e- D1 O: wIDirectMusicLoader8,加载器。用于加载Mid文件等等
8 P4 ]+ H3 c. v& J# Y
8 c, u5 ^- ^/ A6 T# G2 K( J8 ZIDirectMusicPerformance8用来控制DirectMusic的接口
" i. w% h1 F" Y4 j
IDirectMusicSegment8音乐数据段，加载音乐后存放的位置

IDirectMusicSegmentState8 音乐段状态
& e" f- C( T% M5 }8 A2 h% _
. z& i% v  t/ G8 V  P+ C顺便说一下DLS

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

MSDN中这样解释：

4 [: l) `/ ?( S3 [( BA 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.
. `/ C2 `+ O( Q/ I. |# a. k
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
1 \" h+ ~5 ~$ ~( U1 W( A
7 b( ^& i( T  r* a/ v" T) `使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
. H  f: c7 y1 j4 E$ A" w
好了，说了这么多，该开始应用了

IDirectMusicLoader8*  pLoader=NULL;

$ i& M6 A. @, @+ y. d5 vIDirectMusicPerformance8* pPerf=NULL;

  b4 X  C% Z9 r/ ?2 p7 r8 \IDirectMusicSegment8*  pSeg=NULL;
6 A3 k$ i! V# t* M4 Y
4 Q/ h1 ^6 _4 {. [" T2 F+ z3 C首先，初始化Com
6 l  Q, G2 j' T4 b/ p6 b
! K" e+ S7 ~3 d! ?- u5 V$ g(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

HRESULT hr=CoInitialize(NULL);
3 Z+ f( u9 {+ S$ l6 L
2 `) V) M  z% ?5 f* Y3 p0 `1 GIf(FAILED(hr))

{

" }/ f1 v0 [# Q$ Q   处理错误

}

以下为了方便，省了错误处理
$ q  E1 D/ ^9 ]5 r( Z, _; m; j
下面创建加载器

CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
) T! N7 D; k/ K. B8 u3 s
# i$ ~$ {/ V1 g4 X' j) uNULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境
* a/ Q- r( D& e, k2 S3 r( O
& E+ f" ^9 i! j/ ~IID_IDirectMusicLoader8,    //接口的GUID
  K2 i1 T8 d$ L* f' Y
(void**)&pLoader);              //被创建的接口指针

* z6 u. ]! a, H. g  w创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
, N# E( ^. ~. ]
NULL,    //不是创建集合
6 U. N) I) Z1 F" N+ L% z3 O) \
CLSCTX_INPROC,      //创建的环境

1 Z% s$ ?* n$ F! c4 ], LIID_IDirectMusicPerformance8,   //接口的GUID

, ^. `- L5 `4 j5 v# n(void**)&pPerf);          //被创建的接口指针
, @$ y; w9 i" Y) V
初始化声音通道

pPerf->InitAudio(

' {9 i5 N& ]+ U7 z2 Z6 r5 y8 q    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
  N5 N4 s9 q3 R$ r/ I0 x& A- R
    NULL,//DirectSound对象的指针，同上
& E( B3 u" K/ o" p
, T. W7 A9 Z* W8 W6 A: ~  ~/ N    hWnd,//窗口句柄

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

    64, //音乐通道数
. W8 w& a5 a- I, `
4 {: t& G" d! {6 v+ z/ Q: Z    DMUS_AUDIOF_ALL, //声卡的所有特性
0 [! b" H3 a) L1 E2 K8 H/ g$ c% y6 q
2 o/ `- U) S# [( I- v    NULL // DMUS_AUDIOPARAMS对象的指针
- S  ^# B9 w; l. `: p; ?' P  J2 y+ E
  );
# ?9 m, o8 e5 w
好了,初始化Dmusic完成

' i5 J1 I9 s+ r6 q/ X0 @; U下面读入mid文件

% g, ~. Y7 u- r9 T' p8 u% A% ^  
# o6 g8 {, {2 Q  k/ Y% t
pLoader->LoadObjectFromFile(

                CLSID_DirectMusicSegment, //组件的GUID
# Y" h" s6 d) p5 G8 r8 ^& {
  L* g% D! p. N, g                    IID_IDirectMusicSegment8, //接口的GUID
. G& p. V, d5 t/ n2 u& A8 [
                    file;//文件名,注意用Unicode
2 G0 ^; T( X4 K4 l. `2 j1 C7 o
                   (void**) &pSeg//音乐要装到的段
0 d3 ^8 U. L" H5 ], @4 n% k
  );

" p0 Q/ n# ~6 d: }' o. I从ASCII转换到UNICODE的函数是

比如

const int MAX_FILE_LENGTH=128;

& P- r) |) V2 S! b) i# o0 aWCHAR UnicodeFile[MAX_FILE_LENGTH];
& G0 u* O+ g" k! v8 g
$ J+ \! `! R+ i6 c) N6 iMultiByteToWideChar(

CP_ACP,//ASCII码
/ \1 Y- s9 n! p
( M4 l9 U; N. T$ r+ ?* q) |   0,//

asciifile,//要转换的ascii字符串

1 I  G, q  R3 ^( r2 ^ -1,//要转换的字节数,-1表示以’\0’结尾的字符串
7 Z5 y3 S2 _: j' d( g" ~& C
' [  e3 {% E! R& E, D1 v                        UnicodeFile,//转换后UNICODE存放的地方

( _, |& k* G- Y% a  R# U4 V2 E1 MMAX_FILE_LENGTH);

# T- i2 P; i  w下面播放mid音乐
# s1 B5 i% V. x# g* ~6 P
pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
& z& I& i: ~3 J. E
pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
/ x+ X) L# N- S- \# N3 a
" S1 W6 J0 k$ N& H& opPerf->laySegmentEx(pSeg,//要播放的段

8 U8 G$ w  h0 C$ }( uNULL,//保留,必须为NULL

* e+ Z0 H( B+ ONULL,//pTransiton
% c9 a4 X/ ^) ?9 @9 |
: {  n2 S3 n9 \0,//播放的标志
6 @8 x4 Z9 y0 e
: ^7 i3 f( ~. |6 g7 y1 O* M! f0,//开始的位置
" B- p7 q5 u# E
6 ?& X( m+ \( {- O( G& a7 ~0 g. ^/ r9 HNULL,//用与接收段状态的指针,如果不需要,就为NULL

6 S5 j; |. r. J7 Q/ P" p" E0 i4 GNULL,//使用默认
7 y, z5 V0 a. u$ I# I: v
$ b5 `  t0 z9 r" u2 ~NULL//默认的AudioPath
; A- T. H! E1 o4 h: j6 @
5 f+ h- e7 ?  w" e0 I1 L$ `);
8 M9 P. d' K; w0 i7 p# z7 B
暂停播放
( ~! Q0 \4 C. f+ S3 G
MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型
, J2 \7 W$ ]" `, }; u& S% f
pPerf->GetTime(NULL, &mtime);//得到暂停的位置
2 R. t5 F; q8 v1 ?$ a: n
( y2 D- t7 U6 c" N  w$ g) `+ Q; V停止播放
" f6 Z- n: R3 [! Z' x0 ^  T. ]
  t9 c1 [7 \3 o+ C( \' QpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

& d4 u0 M. M  A$ aNULL,//段状态

0,//多少时间后停止,0表示立即
5 y/ E& T# X- v
0//标志
4 S0 U. q2 q1 D. Q" t2 C' `
);

从暂停点继续播放
* ~, d* v' K% s2 C; ~, ^
  e9 S* V+ F1 XpSeg->SetStartPoint(mtime);//播放点

pPerf->laySegmentEx(pSeg,
( B$ ?4 N3 b1 _0 j( q. k+ {
NULL,

& ~# R* e, K  x" ~6 TNULL,
+ h1 w' P- _" x3 q$ t
: c5 T5 V9 S$ w+ uDMUS_SEGF_REFTIME,
" M- m" n8 a) `( V/ A# V: h
0,
$ \7 Y/ {5 o: U7 k7 m
8 j4 A) W% @9 M4 _  T4 INULL,
/ k/ s! ^) l" l9 `0 X& I" p) S
NULL,

NULL
2 ]7 x) I' j- g% @* H9 l) N
);
- I" Z) [/ U- U/ ?! }+ J
) i$ O" I$ @; k) }1 o* _pSeg->SetStartPoint(0);
0 H  u6 r0 d% g: f
% l0 J" L- ]0 h) a, P释放DirectMusic

1 i* Y. o7 Z- Q3 p) W! W% t0 G, ^pPerf->CloseDown();

pSeg->Release();
& t9 h% L: h1 \  |! K. D
# v3 J+ e+ I& h* q2 Y  _pPerf->Release();

; W$ \% @- s( m7 J. ppLoader->Release();
9 u" o2 R: A' v
+ O1 ~; ^+ W- \5 ?# q; K( O4 _  

, e- k" i' i# f* C6 R7 `CoUninitialize();//停止使用COM
) T2 [6 Z- V' {+ z+ p! n
好了,整个过程就是这么简单!

当你理解后,可以自行把上面的代码封装为一个类

这样,你就可以在你的游戏中实现MID的播放啦!

1 \. t/ _* R  I3 }! ~当然,播放mid只是DirectMusic功能中很小的一部分
0 l* A+ r& f! f- @
它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
# g& L' P' J) P2 A) I% b
最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

程序下载:
+ O1 ]3 Z. _' X0 Q  e% g7 R
  

(参考资料:
9 R$ s( J$ d0 o' U8 z
WINDOWS游戏编程大师技巧

MSDN2003的DirectMusic部分)