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

天云上人

播放MIDI音乐——使用DirectMusic
3 V* [( r  B2 h# V$ Q1 _By Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)

(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)
6 {; g- s+ U  j, w0 J3 T6 S
在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分

DirectMusic主要有下面几个部分组成：
" R0 x+ G! m" f" \
IDirectMusicLoader8

& [6 B1 w# U% p! M8 Z/ q; I. yIDirectMusicPerformance8

8 b% n2 }6 {3 t* l4 J+ ~* pIDirectMusicSegment8
! Y/ q- l* a7 [: U9 s* a0 m2 K
IDirectMusicSegmentState8

你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
/ o: v- E+ i% l/ S# |9 J
IDirectMusic8
. D; b7 B8 n" f0 U( q
IDirectMusicLoader8
. w4 \. d8 ^. L- [# z; x1 @
IDirectMusicPerformance8
4 Y( I8 J8 `0 o# d& M$ v9 Z" f
IDirectMusicSegment8

AudioPath
- R4 s3 d/ e; m$ \! H  g; ?: n
IDirectMusicSegmentState8
0 Z2 M: i/ ]3 }! r- w% g
如图:
( @4 u! ?9 ^' O( N; s% L0 N
9 R$ p: O( h$ `' m" U" p4 x3 n                                                                                                   

! U; K) k7 B* a& r. ^# r  

0 @* W( n) s! F+ `, d( {$ A  

  
" \# Y* M( n5 H9 ^
6 [0 \8 U; ]- E8 ~# a  
5 y( q. x$ I# n7 [5 s
IDirectMusicLoader8,加载器。用于加载Mid文件等等
4 t' i: M: v- Y4 q2 h( v0 F
IDirectMusicPerformance8用来控制DirectMusic的接口
+ j  ], L/ z$ @, C0 n- G, i7 E
IDirectMusicSegment8音乐数据段，加载音乐后存放的位置
/ w" Q( Z0 R+ R# S/ i
IDirectMusicSegmentState8 音乐段状态

: j! x; H5 |; _) `& Z顺便说一下DLS
" f5 I9 J9 e. G* N+ |0 I
' o: e1 o6 H  q/ p  f% F我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
2 L/ A3 U$ o, |1 g& t- l$ I
DLS全称是DownLoadable Sounds

6 k2 J% Q" A: c" f% z- cMSDN中这样解释：
) }- w* e- u5 s: n
6 d) f) Q. j- A  d/ T9 TA 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.
7 V8 x  e% ~& Y& H, L, `5 ~8 d
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中

4 h& W% R$ }1 u- k, n: |% q使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
6 M. K  s4 s1 c0 w  ?/ a
好了，说了这么多，该开始应用了

IDirectMusicLoader8*  pLoader=NULL;
" `0 T5 \8 p. t4 C
IDirectMusicPerformance8* pPerf=NULL;
2 O' @$ {- x' B, B$ S( n. k
8 |( V' u2 o5 z. _# T/ \7 PIDirectMusicSegment8*  pSeg=NULL;

  Z# O" @3 c3 P- X: ?+ i首先，初始化Com

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

HRESULT hr=CoInitialize(NULL);
( ]7 M. _9 i! q6 M. [$ |* m/ z
! Z. U8 n2 m. e) j# e# D2 k6 }If(FAILED(hr))

{
2 f( W4 d4 |2 q% N6 `' D* p
   处理错误
% e6 f8 n5 R* Z1 }3 i
. Z: i; ~2 I* m  R- z: A}
8 G7 z8 {, K0 z, g$ P
: q/ J0 v7 D. |4 }以下为了方便，省了错误处理
2 U* W3 o/ L) R# ~4 t& T* h
/ M/ M& W$ t, g5 _; z1 b; w下面创建加载器

CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
; C: M' K6 Y) r" K( B
NULL,    //不是创建集合
" A  R# j) e" R
5 o- U1 t3 A. A% b4 F: bCLSCTX_INPROC,      //创建的环境

6 u/ g( g( C$ ]* v7 p; `" mIID_IDirectMusicLoader8,    //接口的GUID

(void**)&pLoader);              //被创建的接口指针
$ h- `: q% b$ u0 o( m- E" G. Q
- J7 M. [8 Z: V6 L& X) z创建“表演”，（控制器）
+ G( I' T! ^; A% _+ E: I
CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID

NULL,    //不是创建集合
8 b  r6 g* Y- b- o
, L* p2 d1 L# u5 p. v' Y: DCLSCTX_INPROC,      //创建的环境
3 j. H/ ~9 i  `' Z/ B& G* }! J
IID_IDirectMusicPerformance8,   //接口的GUID
8 w6 t- _  t2 o, S+ x
(void**)&pPerf);          //被创建的接口指针

初始化声音通道

* i4 {" `0 m0 j4 ppPerf->InitAudio(

. a# t' K5 j" B' j4 X0 v    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
* A- P* A% B6 p; c. i8 W, T
    NULL,//DirectSound对象的指针，同上

! I- W) A' i  ~) t" K    hWnd,//窗口句柄
. E# G' Y3 Q0 f, z
    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
3 B" J5 Z9 b- B' V* y7 D
8 }2 g4 |1 b1 e: {4 j9 V* H/ x    64, //音乐通道数

4 ~/ t" A  H, \1 J    DMUS_AUDIOF_ALL, //声卡的所有特性

    NULL // DMUS_AUDIOPARAMS对象的指针

  );
% ^# q- z; O, T8 g3 t
好了,初始化Dmusic完成
6 K% q* `- g: P& E& |1 t6 Y
' C9 Q" s- j: F* p下面读入mid文件
$ n) @! I2 U- l9 V& K3 _6 A
  
2 F( q4 H0 m$ U6 K3 w
* [/ G3 F5 W% ]/ D% lpLoader->LoadObjectFromFile(
5 E! Q' B; W+ l# L1 a6 T
6 R; H" `. P  B/ y1 n                CLSID_DirectMusicSegment, //组件的GUID

% Q5 t7 p/ d3 t# s) i! o                    IID_IDirectMusicSegment8, //接口的GUID
+ Z; h# T2 H8 \0 o0 n+ c* h6 B
( v5 x1 G2 u2 ~/ W8 [8 \# E7 L6 J                    file;//文件名,注意用Unicode

                   (void**) &pSeg//音乐要装到的段
3 _1 C/ r0 U9 F: {0 y. J. d/ ^% v9 k
  );
7 l# X4 {- v$ ^  K% I! @  O1 H1 R6 e) g
# \$ C/ V; v% O5 N0 |6 ]从ASCII转换到UNICODE的函数是
" T/ a& U$ p3 b) h5 b7 f$ M  f9 |3 _
比如
' M4 m6 c! |+ \- a6 a! i
const int MAX_FILE_LENGTH=128;
5 k! N5 R" R+ Y; m
WCHAR UnicodeFile[MAX_FILE_LENGTH];

MultiByteToWideChar(

% E9 r, \9 B) A6 E0 z- N2 d3 FCP_ACP,//ASCII码
2 ?" d9 Y& I! P. r
   0,//

asciifile,//要转换的ascii字符串
6 _% ]4 i& Z3 Q1 j4 |: R
' y! V* b# A- V# f( Y% F -1,//要转换的字节数,-1表示以’\0’结尾的字符串
) ]3 l! ?7 m; s. f; y* H. L/ v) O
                        UnicodeFile,//转换后UNICODE存放的地方
7 g1 D* i0 \4 z
2 V* w* X3 n! aMAX_FILE_LENGTH);
; F' D5 ]* D3 W
1 q/ l8 A4 E' L下面播放mid音乐

pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
- p$ {; ], k( U1 v9 p: M
pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
$ y! v6 A9 \$ d' Z4 B) O) m
. M3 J5 v6 t9 P, @# IpPerf->laySegmentEx(pSeg,//要播放的段
) P  ~7 u: Y7 c/ I- ^
$ r  m( K- h& h$ kNULL,//保留,必须为NULL
! O- l3 t: X+ r& G% h
NULL,//pTransiton
+ R5 `9 Y0 I, \7 [1 j$ o
0,//播放的标志
2 e8 p6 P% l) |: C3 k" p
$ Z; P# E  g* ]; t1 f0 D* N1 ~9 A0,//开始的位置

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

, h: G& Y8 P3 f& N" L) p6 k  zNULL,//使用默认
# |1 J/ @4 {$ ~+ x9 h: c
NULL//默认的AudioPath
  ^* H- k6 v. x9 {0 c
);

暂停播放

0 Q/ E1 ~8 Q! C* CMUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

/ I  f8 ^7 ~, Y5 t5 Z3 \; L" Y" mpPerf->GetTime(NULL, &mtime);//得到暂停的位置
) r# |& }0 m2 u$ S" B: F! h- ^. E- f
停止播放

# |; H; x+ B% P! B6 LpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止
9 {- ?7 M+ f. d
NULL,//段状态
$ w) ]. o# E( M9 ?' Z7 D, i
! }8 V# J$ }, ]7 G0,//多少时间后停止,0表示立即

* }, S! n, w6 n0//标志

2 E) k1 O. L; T: ]. h: i. F);

3 N; h7 m- X  n5 O从暂停点继续播放

, V3 q" C/ A+ E2 j: R8 K; ^- A  }; npSeg->SetStartPoint(mtime);//播放点
: M6 }7 }. x7 A( ?; ^
pPerf->laySegmentEx(pSeg,
) [: N# z( B3 ~& e! X
NULL,

NULL,
3 @2 F+ r- y) `0 d
$ P; i4 ~+ U0 ^! ?DMUS_SEGF_REFTIME,

0,

NULL,

; n% i/ g( d7 L; w3 l' y- GNULL,
+ _  k% K6 q2 M' C5 u2 |8 L
NULL

);
" C2 I# x! S( `
pSeg->SetStartPoint(0);
" |! |9 H/ d& e$ _
释放DirectMusic

/ f- r2 ?8 Y/ ppPerf->CloseDown();
1 H  j" u. Q* `; P
# b+ H+ P1 b' q. ZpSeg->Release();

pPerf->Release();
0 E1 _6 a" i4 s. J: ?( b
pLoader->Release();
- ?7 O+ v% E0 Y9 T0 k
  
9 m! p$ ^3 N2 T
CoUninitialize();//停止使用COM
6 n  b$ _  ?4 s5 k. f
* x% r. @, I. K5 i! a; h& W好了,整个过程就是这么简单!
5 `& c* O( K% L1 }: y; G
3 A# ?) p$ D, G2 U+ {6 s5 o9 F当你理解后,可以自行把上面的代码封装为一个类

4 \' H; x% e8 J9 W+ ^9 S这样,你就可以在你的游戏中实现MID的播放啦!

7 r' e. H" H* E当然,播放mid只是DirectMusic功能中很小的一部分
( Z+ F4 c6 f. @9 n
3 s  f0 l' W+ V, V& W它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
* ^9 D3 S2 R( P1 m( Z! [
& n" q8 L" d$ e8 H6 e最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

* f/ N# S1 ^4 N. Q0 T程序下载:
# Z8 r$ i! P9 u  }0 M( t) _4 Y: V
5 R8 P. _9 Y0 S  m3 W2 H  

(参考资料:
" Y  x1 n; a# S3 T
1 E* K8 o) h9 c/ J4 |. z7 _WINDOWS游戏编程大师技巧

/ O, Q7 @' V% Z6 ~8 t. JMSDN2003的DirectMusic部分)