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

天云上人

播放MIDI音乐——使用DirectMusic
; [4 e5 v: M7 I5 Q0 h- \By Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)

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

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

" E; d" g) v' K4 x/ e+ p- |DirectMusic主要有下面几个部分组成：
8 s1 [- @" S; T2 R! ?
IDirectMusicLoader8

IDirectMusicPerformance8
+ u0 o$ D$ e5 r" _, l1 @
4 R) h: j& j( N! T) F$ t1 uIDirectMusicSegment8
9 Z/ ?2 I9 w8 p9 r6 p
! Y" r9 F0 F4 [6 tIDirectMusicSegmentState8
- m( L! C% O8 P7 Y' \4 M
你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
0 q1 ]9 `: j; }1 _0 f
3 F2 Z$ @# Y5 y* s6 zIDirectMusic8
- F3 T1 {! Z8 V6 h$ B( n, A
IDirectMusicLoader8
6 K& Z" a  W0 H; A
IDirectMusicPerformance8

5 z0 [3 o* ?6 P; ^  [; ^IDirectMusicSegment8
: u2 q( V* p, d+ x/ J0 h( c
. A, `3 B+ ?9 _  M, @AudioPath
* x" Z" X+ @. |1 S. V
$ U; r' _* [6 F" W8 v! rIDirectMusicSegmentState8

如图:
8 {: M  h3 b" ]0 T! I) Z/ f3 C
                                                                                                   
8 t) F2 i4 Y3 C) I1 A9 @
  

  

  

, i2 O- Z; d; a# I  

IDirectMusicLoader8,加载器。用于加载Mid文件等等
# j9 ~% j4 a% X( @9 q% I+ W1 r
# |+ |/ L, P" U3 IIDirectMusicPerformance8用来控制DirectMusic的接口

IDirectMusicSegment8音乐数据段，加载音乐后存放的位置
8 }2 Y" f6 ~1 X' M! |
IDirectMusicSegmentState8 音乐段状态

/ T2 b4 Y% [- v# b. D0 @2 U& @顺便说一下DLS
# s6 ]2 X' B. D5 E9 o. p0 l6 s0 I
我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
/ E2 Q% l- g; Z7 h& r2 p, ]
DLS全称是DownLoadable Sounds

MSDN中这样解释：
2 G. V/ s/ K& w1 ^
- G% K* J1 `, A. J3 lA 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.

原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
# \+ Y0 N' w* T* q% o. E/ o
使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
4 Z/ N* f7 `0 T  p
* E5 Q5 n0 j4 R3 L  R( S  ~$ G' d好了，说了这么多，该开始应用了
% I8 f3 W8 b# s0 r
! [8 h  [' t# ~+ S9 S7 X' D9 {. N6 g1 YIDirectMusicLoader8*  pLoader=NULL;
% f7 K4 P/ E4 Y* H- L( O
IDirectMusicPerformance8* pPerf=NULL;

IDirectMusicSegment8*  pSeg=NULL;
5 q# U- ]9 l; K! t
- d7 J( Y( p* P* ~首先，初始化Com

(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
9 C! _; G3 i1 A5 x' \  \- t1 u
8 m% {. d! w9 q7 x2 ^6 ~( gHRESULT hr=CoInitialize(NULL);
5 C, [4 C+ Z0 O/ q. R, [: g0 ^
5 p9 B, y# ?" R5 Y# a& N* YIf(FAILED(hr))

{

   处理错误

}
; v( \  m: ^( P% E
以下为了方便，省了错误处理

下面创建加载器
6 r$ F+ q$ g! s* u) F( z6 x) \  ^
CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
1 _, T6 r& N8 @( |
3 |1 _& D! i6 ]. SNULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicLoader8,    //接口的GUID
/ R; x3 c( s4 m3 k
+ |. J+ s1 g0 L! _" o! O(void**)&pLoader);              //被创建的接口指针
1 _, N1 V0 p" _9 ?  u1 R' z
8 J4 K$ \/ T0 F创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
$ B( p. D' D* i) R5 F
! O# ^0 l' D) `: O5 oNULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicPerformance8,   //接口的GUID
. k$ V+ Y7 D- _5 Q
(void**)&pPerf);          //被创建的接口指针
0 j; t' |. n$ N4 e
' D2 E0 @( q- ^& N初始化声音通道
; }8 R1 ~+ [. Y3 v
  V) W) W2 e( p  B2 zpPerf->InitAudio(
3 G" g- v7 L$ ?
    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
% w9 @% e/ J. {2 g% a
5 P3 N1 ^6 K& Y- @4 a* l1 J% c    NULL,//DirectSound对象的指针，同上
% Q9 S( C6 I% X0 ~8 u0 ?2 j4 D8 B6 z! _
% o  y8 N4 w. P: {# q, I7 d* l    hWnd,//窗口句柄

6 c/ J0 u& S" S+ y$ E0 U0 Q    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

- ^# p' k9 a" N9 n    64, //音乐通道数

    DMUS_AUDIOF_ALL, //声卡的所有特性

, W$ }9 ~* D6 ~, b    NULL // DMUS_AUDIOPARAMS对象的指针
1 u4 C  _* Y2 g
3 z+ o$ ~4 h% F2 i  Q% j6 U  );
# {/ H& K, O5 ?5 S+ {& j
好了,初始化Dmusic完成

6 B0 |- I& |3 p/ H0 n; g下面读入mid文件

- h& \1 u4 Q2 ^0 j- X5 z  
! [) J+ h3 |, m
& f# T4 @$ Z+ Y3 T& k% X$ qpLoader->LoadObjectFromFile(

                CLSID_DirectMusicSegment, //组件的GUID

                    IID_IDirectMusicSegment8, //接口的GUID
2 |" _, i/ U! p
+ S/ V& K+ t( w, z% N                    file;//文件名,注意用Unicode
. M( _! B  n, |9 e( `1 @+ B
                   (void**) &pSeg//音乐要装到的段

  );

从ASCII转换到UNICODE的函数是
  @' W  ^' L! b) E; l
" h1 \- e. ]% j2 C比如

* x  b$ |9 Z1 }  G/ _- g# I* Vconst int MAX_FILE_LENGTH=128;
5 G( m  s9 _2 ~7 }4 f' L+ E5 x
WCHAR UnicodeFile[MAX_FILE_LENGTH];

MultiByteToWideChar(

. l& }& D; w3 X0 G2 FCP_ACP,//ASCII码

, j( y/ o, X/ c1 Z, D) K4 Q   0,//

+ s2 a! _' k3 N0 P% {5 ~" _! y* P3 D% v- Rasciifile,//要转换的ascii字符串
# v& V' O" p% D' }
7 D( W% E& }# B) d -1,//要转换的字节数,-1表示以’\0’结尾的字符串

                        UnicodeFile,//转换后UNICODE存放的地方
0 A% b; E8 T( s2 S
MAX_FILE_LENGTH);

( m) Q2 T( Z* L6 _下面播放mid音乐

pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
  T+ m* f7 T8 P1 l3 i
' C/ o+ d9 F9 X' UpSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
% M) U% k4 Y  q- _2 {4 d
pPerf->laySegmentEx(pSeg,//要播放的段
$ s! [+ w7 ?; a8 K" a5 i* L
NULL,//保留,必须为NULL

NULL,//pTransiton
, f6 x/ n* ]6 v* M- E0 @. i
% R$ j0 R: B; n) l5 x0,//播放的标志

; ~7 I9 S3 R- R$ Z, f0,//开始的位置

NULL,//用与接收段状态的指针,如果不需要,就为NULL
6 y: W$ U- e6 b, D4 L
/ v3 }+ T" Q0 N( J7 T8 LNULL,//使用默认
$ L- W* F% Z% G
- L, i" e9 @6 p# x' {/ r3 tNULL//默认的AudioPath

);

+ P, i( M2 o% P" o& j) S暂停播放

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

pPerf->GetTime(NULL, &mtime);//得到暂停的位置

+ u0 F) a7 O: h5 D; I停止播放

pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止
& ^5 a' q; U. [2 O& `  S$ s; D
, O) S! @& D4 ]! c! C2 \NULL,//段状态
+ T( y5 d3 n) @9 J; ^
$ f# a2 H/ j( S, F+ V0,//多少时间后停止,0表示立即

0//标志
4 n5 u' n6 A5 n
);
1 M, r# Y: y8 J9 r; b) s
从暂停点继续播放

pSeg->SetStartPoint(mtime);//播放点
: a$ ~8 {2 v$ b2 @
! Y, L2 Z, T- P" [% P) ]pPerf->laySegmentEx(pSeg,
0 Y: t2 {+ x( h' v  v
" ^% X. G+ ^0 v; l2 YNULL,

NULL,

DMUS_SEGF_REFTIME,
  m1 b. j) q$ f# Q* `; ]* \# v1 q* u
% j$ i( q3 |6 K$ _: [5 p6 e0,
9 D4 I; F; m3 K- {3 Q& ^
NULL,

NULL,

7 D+ n# V0 q1 t6 MNULL
+ u& s( A. u% i
  m& ^7 N# p+ U) n. A5 U);

pSeg->SetStartPoint(0);
* G- o& v, N' |  x8 s! D
释放DirectMusic

0 e7 t: B7 ~* V8 W" z8 KpPerf->CloseDown();

- ~+ l  ~! _4 P  v2 LpSeg->Release();

0 H3 _2 \/ t# Q  _* w* LpPerf->Release();
# z/ n# B6 O8 z" H& v
pLoader->Release();
  p: z. m* ~9 `  b  i  J# A9 ~
  
) |% O: w& O& d, k6 u& D
CoUninitialize();//停止使用COM
) R7 P$ E0 p, j
, N7 e5 F' P6 w7 g好了,整个过程就是这么简单!
" Z2 W- e! S7 f0 l( e4 x
' H; V, z0 _" @3 v当你理解后,可以自行把上面的代码封装为一个类

这样,你就可以在你的游戏中实现MID的播放啦!
1 ^/ T/ t  ?. \0 U: k& e
当然,播放mid只是DirectMusic功能中很小的一部分

- t! {+ R: n% ~- o9 o7 g它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!

7 K8 a. j2 U+ Z% b/ ?; l8 r最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
1 K% L* M$ x. A4 U( v. N, Q
程序下载:

4 i% e3 k" ^% d1 f8 Z2 \  
9 `$ ^& s" _6 p1 w" E. c
/ E' K8 s5 j- J/ ^4 g(参考资料:
" {, u4 `% X# T$ I( P0 t( b" v
$ K: _: c: x, y' P$ nWINDOWS游戏编程大师技巧
: a2 G0 w5 P, [$ J
MSDN2003的DirectMusic部分)