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

天云上人

播放MIDI音乐——使用DirectMusic
By Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)
9 M4 v) h3 q3 o( H7 v9 X
2 g0 o! z/ O( u$ R( y* m9 L& h(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
+ o( F6 J  V* r" f) t# n
) k8 g. u$ f4 L9 l$ I+ DDirectMusic主要有下面几个部分组成：
) o) I. H: ^% e
IDirectMusicLoader8

IDirectMusicPerformance8

; T: h! Z! @  T6 W7 jIDirectMusicSegment8
: ^+ b8 u/ |" r* t* _# X8 c$ X
IDirectMusicSegmentState8
1 W3 Q9 |! K% [) D) A
你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
9 o1 I& m" b5 o5 F) I
IDirectMusic8

7 y* a& H7 w( e& M5 sIDirectMusicLoader8

- P1 `2 _3 }8 e4 P' z6 |IDirectMusicPerformance8

IDirectMusicSegment8
2 s( L5 D+ M1 n* T! t
AudioPath
8 y$ c) |! Z2 v! R
6 M6 t  z& N  J( k7 K+ ?IDirectMusicSegmentState8

9 M' o4 L/ H6 c* L% M9 e! N3 o/ }1 T" I如图:
, {5 a1 V' s: N* D8 L
; H$ k+ U" Y; _" M  \, j                                                                                                   
9 z7 U$ P8 W3 l
  

: m- v: ^9 C- E* f  
9 {3 u2 _# M& Q" }; r9 p
- e/ h; R8 J- e% P' \, l+ ^  

  
9 x8 i9 E7 j* J- ^% w5 i
IDirectMusicLoader8,加载器。用于加载Mid文件等等
& k2 W. s2 u+ R* Q5 W
IDirectMusicPerformance8用来控制DirectMusic的接口

IDirectMusicSegment8音乐数据段，加载音乐后存放的位置
. Y4 J' t( l( m7 Y2 k
- G1 X* u5 [+ Y9 N3 [% QIDirectMusicSegmentState8 音乐段状态

, `/ A8 |, i4 e1 i0 i5 Z) ?3 P顺便说一下DLS

) }7 `$ ?3 f/ V/ u我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
$ I% z7 T  t$ d5 s1 V# K" D7 f9 e
. Q; L$ B, r: \9 G% V  a; ]DLS全称是DownLoadable Sounds

MSDN中这样解释：

% y5 `% B' Z% T7 z  F8 d$ t; fA 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.
8 v- m1 I& D" f' U
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
, o* X$ C& k1 b) `' X1 F
  L6 g# Z2 n4 Q, z! G" w使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）

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

IDirectMusicLoader8*  pLoader=NULL;
7 X0 N4 P/ _6 L1 C  p& p9 @; f
& J7 C& X* j* }; k+ ^" z4 EIDirectMusicPerformance8* pPerf=NULL;

& {9 g+ }, ], K4 c/ fIDirectMusicSegment8*  pSeg=NULL;

首先，初始化Com
8 s  @( g9 W- ^; L" ^$ @+ k: K& w% s
(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

2 t( L7 t. w- T7 F2 g+ LHRESULT hr=CoInitialize(NULL);

; Z* ?6 j% x6 i" V, }0 OIf(FAILED(hr))
+ ^; F; L; _, }& Z
2 h: f; H0 M2 ?: W' V0 U1 v2 j" h{

/ l8 o& ]! }! ~& [, }   处理错误

. `  T% T! U" A9 C- d( w1 I5 V}
5 \, y3 q+ y8 X+ s+ o  k( j
以下为了方便，省了错误处理

下面创建加载器

8 h) k( c6 N: [( \+ k1 DCoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
( E& W0 {* T+ V: u0 T
/ I5 J: E6 e2 ^/ v% {NULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicLoader8,    //接口的GUID
+ Y/ @& A* }" `! h: D+ A3 Y
6 B$ t8 z8 G9 _% a(void**)&pLoader);              //被创建的接口指针
7 Z3 j1 v3 W$ r. q( S! A1 A
创建“表演”，（控制器）
" }: j% o3 H4 |7 ?
( I0 x7 m# Z/ A# F# @CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
+ g( i5 k. h- f8 P4 _/ W0 c
NULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

  l' C+ h" Q* t6 GIID_IDirectMusicPerformance8,   //接口的GUID
. x# R3 v; h, R' M* k% r" d: o
& [7 W: X. ~! z; G(void**)&pPerf);          //被创建的接口指针
' H! o4 U, D& M( P/ D& H& j
. e  ]' Y7 ]: S$ I* U4 p初始化声音通道

pPerf->InitAudio(

2 Q2 }7 p4 @  w: ]6 L- e, A, k5 N    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

    NULL,//DirectSound对象的指针，同上

    hWnd,//窗口句柄
+ V9 k# E+ B6 P2 o% b+ x) R: o
3 d3 R5 \* n4 K    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
5 \! Q9 S% j% n' C# o
    64, //音乐通道数

% B! a8 g2 \# k# l" c- r+ u, t    DMUS_AUDIOF_ALL, //声卡的所有特性
( J6 {4 w* B! z- C
    NULL // DMUS_AUDIOPARAMS对象的指针

  );
5 o) S+ Z2 i7 P7 |% _
6 W  W% K3 ~/ x- q& C7 d好了,初始化Dmusic完成
; Y& }8 Y/ `; O4 a# X) P
下面读入mid文件
+ ]! @/ v& m+ {# t% x$ V
  
+ G3 @9 h! Q9 j& J% z
pLoader->LoadObjectFromFile(

                CLSID_DirectMusicSegment, //组件的GUID
$ [4 O- P* _; p4 }; Q$ O1 u
3 H4 f/ K: j% }# I  }                    IID_IDirectMusicSegment8, //接口的GUID

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

$ F9 z( y4 Q; ^- ?                   (void**) &pSeg//音乐要装到的段

; ]2 S/ K4 f. v% M6 ]' _6 U: w  );
" C: V- H( U9 w' L8 q* s
从ASCII转换到UNICODE的函数是

- f6 j7 H; F! _, b2 b' ^比如
6 A* D  c) u* H- ~/ D( N& D
- G6 B% t, J. Z) A3 `: B: s) Rconst int MAX_FILE_LENGTH=128;

2 k6 L6 M# @& Y" w7 X: K( v) n3 \6 ^9 mWCHAR UnicodeFile[MAX_FILE_LENGTH];
# }( w2 I; l; C+ y5 q! q) _
MultiByteToWideChar(
3 @& _. c  C' q! _/ U
CP_ACP,//ASCII码
& x  z) T' J7 h/ v2 |) ?! k
   0,//
$ I! A0 b7 `: Y4 ~1 q- q1 F7 n# H
asciifile,//要转换的ascii字符串
  n! j( o6 a- B& v/ Q. q
/ M1 N' Y. }9 T4 a. p0 F, @ -1,//要转换的字节数,-1表示以’\0’结尾的字符串
1 O6 j1 p8 P- L4 u( T5 s  ^7 P+ G
                        UnicodeFile,//转换后UNICODE存放的地方

MAX_FILE_LENGTH);
/ b$ q  a  o3 p* ~8 w) j
+ H& r1 l( ^2 A# D% c下面播放mid音乐
: z3 J! e, W: V# z! ]9 Y" m& T: v
9 @" S* T- t! UpSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
: y& A; w9 ?# ^7 S+ M/ I$ i3 L+ f1 S
pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
5 E+ b; n: t: H" E6 c
pPerf->laySegmentEx(pSeg,//要播放的段
$ G8 h, c- {5 X( y. V! s
NULL,//保留,必须为NULL
( ^* }. |& i3 R( V# {
NULL,//pTransiton
7 \3 e5 E% q) w2 `$ q5 @( G8 v
' h6 r3 @' Q, Z# ^, D  N- ~  X0,//播放的标志

! O0 Q' |+ h2 G2 N7 s$ y0,//开始的位置

4 v% w9 H1 w4 {' aNULL,//用与接收段状态的指针,如果不需要,就为NULL
! \1 u) m( ~! f$ b/ [: W  F
NULL,//使用默认

NULL//默认的AudioPath
0 s2 ^# o, s. F0 v# @* v
);

7 X% s- Z, V* t' Q: g, Y暂停播放
) i4 [4 w2 Q/ ~# g1 Z* U1 b  m
! D% b# I( D6 _( gMUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

& h- Z: n  ^8 npPerf->GetTime(NULL, &mtime);//得到暂停的位置
! ~% k% {9 z" i# i
停止播放

' e" C' z9 S) c7 ^0 I8 i6 A- \pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

5 a1 }. }& [0 ~: {  ?NULL,//段状态
5 Y" s4 H4 f& }0 p9 q/ }! v0 P
0,//多少时间后停止,0表示立即
9 l# A6 l3 e, r# S! J5 q" v+ T
" g1 M- o/ r+ R3 |3 D0//标志

( C5 R! |9 Z' T/ {* C/ v& B);
  K  M4 w# E1 n
  l# Y. X3 b) _& o+ ]- I$ ^; T, t从暂停点继续播放

" |5 O! w# ?3 ]3 ~7 i5 tpSeg->SetStartPoint(mtime);//播放点
3 }6 [9 }9 S! `" i
pPerf->laySegmentEx(pSeg,
# E0 p4 h: B4 |" M% H/ z- [, v
NULL,
% @1 Q4 Z- T/ K
2 b0 J; k- U# C9 l7 e, l9 u; bNULL,

0 I" z0 |; p5 }& ?DMUS_SEGF_REFTIME,

7 |& m. n" h7 U& a# x" h0,

- ~. a0 l5 V/ Q2 f, I* ?NULL,
- j8 ?4 E8 D! S" L+ Y
NULL,
: d: S# u$ |" V3 c. a
& \5 Y9 w. }4 u3 DNULL

);

pSeg->SetStartPoint(0);

释放DirectMusic

pPerf->CloseDown();
5 N+ E% M6 _5 n
pSeg->Release();

pPerf->Release();

# E/ d# \; v* N8 E9 B# b  T- JpLoader->Release();
( c% [) b1 {. S
  

CoUninitialize();//停止使用COM

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

" w+ y9 l! z' E% y" H% |( t当你理解后,可以自行把上面的代码封装为一个类

这样,你就可以在你的游戏中实现MID的播放啦!
' k" U$ ~. R$ @  B; p- q' [
; K! b! B: A6 d8 r) b: g: l4 }当然,播放mid只是DirectMusic功能中很小的一部分
8 i1 ~  H* h9 t9 p
, S1 O# Y% c/ P/ l- ~8 w它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!

最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

/ D- y0 n& f- l# G& m7 X4 l程序下载:
6 v- \" z' V  {* C/ Y
: ^6 a; X" P1 \$ J3 c* Y5 O  
: b+ t" o' K6 L1 q! f8 L) G
(参考资料:

2 d4 T/ i: {; l# E6 kWINDOWS游戏编程大师技巧
6 L4 U+ w# U  w9 s% [/ ~8 {
5 i' @# O5 `- F5 NMSDN2003的DirectMusic部分)