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

天云上人

播放MIDI音乐——使用DirectMusic
2 w8 U* w! u/ BBy Kylinx,2003-5-15,E-mail:game-diy@163.com
+ m5 f: M' ?6 p$ m7 E6 ?2 `+ C(转载请保证文档的完整性)

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

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

. @3 @% f8 L0 e' e4 D5 C" nDirectMusic主要有下面几个部分组成：

: {0 V$ Y3 e. S- l# E' e- PIDirectMusicLoader8
. a6 [" Y0 X( G5 d
IDirectMusicPerformance8
/ [( I% `$ P# c- d4 O7 k/ j
IDirectMusicSegment8

2 g4 q( e7 M1 R$ a* M3 S6 u3 r. _IDirectMusicSegmentState8
+ c% O5 U' z: X' S/ I; Y* o9 i1 x" n
你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

IDirectMusic8
& ~) e% {) _7 D& _
IDirectMusicLoader8

0 n/ ?" X- s  C! b7 P, v! \IDirectMusicPerformance8
. h$ L# }& k) P0 \2 G) d
IDirectMusicSegment8
+ N* `) {, j: f
AudioPath
5 b8 L. B- I: o4 I8 i2 `
0 n1 r% N% G3 v( U6 D- jIDirectMusicSegmentState8
7 D3 f$ c1 Y4 p# m6 O; S7 G$ q; R
如图:
! k8 ?$ p- u7 \* z- Z/ t
' [% q4 N$ f6 _" Z1 U! M                                                                                                   

. s; A) D# |# c4 a% |1 B  
! {) e2 O, t3 e  t/ q
4 P+ u/ ~0 }- y4 s- x7 k  
7 S5 |& {% g+ a8 s
  
7 b9 h) e( P8 W( O2 C8 x2 e. y
  
0 K, @6 t5 W# S9 e5 s7 P: c
& D; r& D  @  E5 K7 C) cIDirectMusicLoader8,加载器。用于加载Mid文件等等

6 R: u- [" q. OIDirectMusicPerformance8用来控制DirectMusic的接口
. p! w- J' d$ \. _3 s
7 r( \6 d+ L3 {! T6 a$ SIDirectMusicSegment8音乐数据段，加载音乐后存放的位置
# m  b- @+ t7 E$ _  x8 A; L
! W% B7 c/ F" R7 m7 a8 yIDirectMusicSegmentState8 音乐段状态
. G3 f0 s! P' X- M  U6 w1 ^
$ q; D' ?2 O4 `顺便说一下DLS

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

DLS全称是DownLoadable Sounds
0 i0 K# u' B' d$ x, w
MSDN中这样解释：
: m6 i$ y2 p! e
* J7 b) w& t7 F/ QA 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.
* z' w0 l$ M$ k5 H/ _: B% N
% z2 K! {3 q( V原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中

使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
" R: H/ u9 v* b. o" C5 }. y
5 Y0 c2 B& B' _* \8 G4 x好了，说了这么多，该开始应用了
1 D; C) D1 X: ?  K5 q) P
6 m6 a' L" h7 c2 u& p1 M; vIDirectMusicLoader8*  pLoader=NULL;
6 p2 @, q) ~3 n) I) z3 v
IDirectMusicPerformance8* pPerf=NULL;

IDirectMusicSegment8*  pSeg=NULL;
& [) a3 ~6 s; ?+ S& M- f: T
5 u8 z; i3 E7 x: j首先，初始化Com

7 J$ `* T, i# V' u(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

3 b# m" K. x; {6 R! F$ i! RHRESULT hr=CoInitialize(NULL);

If(FAILED(hr))
: O* O( h+ {4 I/ P' x7 K! a: [. y
6 X! Y$ [; _  G' e1 }9 C{

6 {- f- ]/ k6 c+ x" g+ G* C   处理错误
& e% j; `) Z, t0 ?6 l$ [) S
}
, w7 Z9 Q/ W/ o* b" N
2 {4 F9 c; b- X  H2 O以下为了方便，省了错误处理
2 G: R' R) k- g* @4 \
下面创建加载器
3 n* j: |% C* `/ K5 \3 X
CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

( p4 f9 N' W, G, k- U; N* M/ NNULL,    //不是创建集合

5 {5 N6 |0 J1 d' ^7 |- P+ j) U/ ?CLSCTX_INPROC,      //创建的环境
! T4 ?% |. ?0 @$ \, W& @
7 b2 ~) }9 g5 `0 |" N4 rIID_IDirectMusicLoader8,    //接口的GUID

3 i" F! W& E+ w$ @. D(void**)&pLoader);              //被创建的接口指针
# D" P* }0 l: U5 X+ ^
+ r) C2 W. k% e0 G1 ^9 C& b创建“表演”，（控制器）
  a+ l; f$ e3 y% _/ E% I
CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
( U' }) T+ o5 A5 c( m
NULL,    //不是创建集合

2 \3 n. Z+ S/ j7 y+ u" B% U; f- RCLSCTX_INPROC,      //创建的环境

IID_IDirectMusicPerformance8,   //接口的GUID

(void**)&pPerf);          //被创建的接口指针

初始化声音通道
6 e4 R% U1 I" d' G: G
pPerf->InitAudio(

3 z) F  C! a- w( Y8 a7 Z, U4 a    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

0 `; v4 g+ p- m9 M/ C    NULL,//DirectSound对象的指针，同上

8 @' g( K9 M( v) W, C  E  \: y6 ^    hWnd,//窗口句柄

! r1 M3 J+ P) Y% }    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
2 n" }1 v5 ?) d9 f- o
- c* n1 ?+ n$ l- n4 {    64, //音乐通道数

    DMUS_AUDIOF_ALL, //声卡的所有特性

; Z& }" k) C+ P$ f4 _; o    NULL // DMUS_AUDIOPARAMS对象的指针

* ~* P( C! M- E% q  );

: @6 V# b2 F6 `+ p/ \好了,初始化Dmusic完成
- y& g$ E; r; K' v, l
下面读入mid文件

  
  }, }3 J9 K2 k. l
$ O, _! d' t0 }& m8 Y7 Y# FpLoader->LoadObjectFromFile(

                CLSID_DirectMusicSegment, //组件的GUID
9 q# m8 g* {: J' a& O. m
9 {! d' h2 }2 w! K2 d( S' _' v                    IID_IDirectMusicSegment8, //接口的GUID

# o7 [# t) L- ?1 l$ {9 `- s" _. q                    file;//文件名,注意用Unicode

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

  );
& Z3 v6 h& M% R: I7 Y9 k1 r5 R- \) j* A
从ASCII转换到UNICODE的函数是

0 }2 u( C0 j$ |比如

5 A6 U, ]8 [+ ~+ lconst int MAX_FILE_LENGTH=128;

+ n# y% t7 w; w" O0 ?WCHAR UnicodeFile[MAX_FILE_LENGTH];

MultiByteToWideChar(
7 A5 A2 K0 a1 _, w; d5 O  ?
CP_ACP,//ASCII码

   0,//
$ a( e7 a  i: K. Z
asciifile,//要转换的ascii字符串
+ `! c! M* a/ l
* _3 Z/ I% w8 P  O# e# m -1,//要转换的字节数,-1表示以’\0’结尾的字符串

' u2 r1 C$ K; q' S0 p! W) e' J                        UnicodeFile,//转换后UNICODE存放的地方
( X% Y. W8 q% N4 _7 S0 Y3 z+ g
MAX_FILE_LENGTH);
. J8 @( K! ?% N- Q" z1 {
下面播放mid音乐

pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限

* v0 b: _* k3 [9 D. Y( o' \+ ?pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
, |! o) U$ v: ^' J" b
pPerf->laySegmentEx(pSeg,//要播放的段
  S" ^+ T  u9 b0 L
; J8 s/ c' Z7 qNULL,//保留,必须为NULL
1 A6 E9 d5 h  J( X! f1 A  x
NULL,//pTransiton
' j) z+ X# W' n; S
0,//播放的标志
0 j( Y7 A7 G* g1 C1 R: G. r
0,//开始的位置

NULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认
- x! H1 T  s6 w) Y/ d7 \
: i$ a9 y' J& r( L$ b  g0 J0 F. INULL//默认的AudioPath

);

暂停播放

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

pPerf->GetTime(NULL, &mtime);//得到暂停的位置
1 ]9 H0 j; l& _+ K5 f
8 W& ?1 ]! U7 i3 a) C停止播放
" Y! r2 L( E" Q6 J
/ J- p) x4 Y3 p, upPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

NULL,//段状态

0,//多少时间后停止,0表示立即
/ N7 u3 i( f; T! N
0//标志

);
" N# P; U# F4 }
* R" ]8 Z4 n/ n& \, ]从暂停点继续播放

  r& A8 U( M2 D$ }5 |" \pSeg->SetStartPoint(mtime);//播放点

pPerf->laySegmentEx(pSeg,
5 Q1 Q! e( h0 b( ]! t
NULL,

NULL,

DMUS_SEGF_REFTIME,

0,

NULL,
! w/ ]2 X8 p) Z. p& S$ J+ f( S
NULL,

/ n" \$ |: o$ E8 D0 q6 |NULL

);

pSeg->SetStartPoint(0);

释放DirectMusic
1 S3 n) I/ L# J# N% |
pPerf->CloseDown();

pSeg->Release();

pPerf->Release();

pLoader->Release();

2 Q3 s0 q' T; a* r6 B' x) t; }  
& B9 V" d3 Z" y7 E& J; I
+ p3 I% B' z- e$ E/ aCoUninitialize();//停止使用COM
) y! H: K- w' F9 h
好了,整个过程就是这么简单!

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

- j7 r4 q3 |! B: T4 V这样,你就可以在你的游戏中实现MID的播放啦!

( v% q$ \9 u3 A: B: K当然,播放mid只是DirectMusic功能中很小的一部分

5 }  n7 X/ ~' k7 f4 G& ^! R- I它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
4 {: h4 M) C& \* d
& P5 F" Z  z2 o6 N4 g+ e5 ^( V1 r2 I最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
9 U, \0 ^( N" n/ d
/ M8 O! z! C3 x) a4 r4 q程序下载:

% S) Z) }& ], D2 e. N9 z  

(参考资料:
, C$ |/ R9 z! `& c! U- K9 k& z
# n; D, B& m% F' W4 o  kWINDOWS游戏编程大师技巧
+ c0 N" s6 v% J# y4 n1 r
MSDN2003的DirectMusic部分)