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

天云上人

播放MIDI音乐——使用DirectMusic
By Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)

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

! l0 J! k8 O& Q1 R4 t  `4 y/ P  O在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分

DirectMusic主要有下面几个部分组成：
9 z( J& Z" R- Y" S$ u  [9 {. F
IDirectMusicLoader8

  S5 ]) x9 [9 D: o& g7 V/ k0 EIDirectMusicPerformance8

IDirectMusicSegment8
: w/ }- E; X  v3 w$ M
IDirectMusicSegmentState8

你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
1 V. ~8 k1 F' O, \: |
IDirectMusic8
& ^9 v3 q5 J, x) {9 T4 b2 ~2 T
6 l, ^! O6 P) o+ `- VIDirectMusicLoader8

0 p* n6 @4 r) {" j6 S  f& cIDirectMusicPerformance8
. \! r2 g+ e. x8 x1 b- b7 @
% i: Q# X9 j: V9 y9 k6 A$ AIDirectMusicSegment8
% K% C2 m9 l8 ^
AudioPath
* y; n  J& c' e$ f2 L. I
' e9 G  G/ k4 l, m7 E3 T" Z1 }" XIDirectMusicSegmentState8

9 V4 k) q% R$ |, \# y1 m如图:

                                                                                                   
$ w" Q' F4 P8 ^/ g, H- b0 a- q
8 T/ @0 l) p, \5 e  d2 b; y" x  

; m4 ~6 A! L8 e+ F. u- m  

1 T& ~. I& h4 a3 U  
/ M  A. P# h  X) f9 L% ~
/ Z+ G! f: R( w5 `  
0 u) g+ K% i: R& c7 \; u
, V8 b% e7 d! q: M' J' ZIDirectMusicLoader8,加载器。用于加载Mid文件等等
5 o$ o. N: T4 {
IDirectMusicPerformance8用来控制DirectMusic的接口

. V- b* U. V5 ^5 E9 YIDirectMusicSegment8音乐数据段，加载音乐后存放的位置
9 O  ?8 a1 [3 H; i
- M6 N% t. l- ]2 e; J) }IDirectMusicSegmentState8 音乐段状态

2 c' i- @6 d$ C/ `. _7 C顺便说一下DLS

0 a3 L6 F" u4 S6 q# y) t我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
2 O: k. n  T/ y6 B6 [6 K' @6 g
, w- l1 r, n+ ]DLS全称是DownLoadable Sounds

MSDN中这样解释：
% k/ L- L" ]6 l. C4 x
* L* U) Z: f* m& KA 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.

# g" e' x" x4 r/ p* u原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
9 A0 V" ?* i& s) l6 z& q9 q' y0 r
% v" ]3 d7 ?1 y) S$ w( F9 H使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
$ m  I" W, i6 D! n5 S6 K
" \" y$ m# \% p& j; Z2 `好了，说了这么多，该开始应用了

& b, c9 U, w) J: @& {IDirectMusicLoader8*  pLoader=NULL;
% t; I5 M& ]' c- ]% w
' c7 E* H0 j& G2 L1 |9 oIDirectMusicPerformance8* pPerf=NULL;
4 X0 S* b# _3 n' v
IDirectMusicSegment8*  pSeg=NULL;

9 }. ~1 P2 D, T首先，初始化Com
0 L; T9 G. U$ M. x3 u
4 p$ I6 Y9 |" `* B  |' C; {+ [(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
2 s( t) d" P5 r
) v) d7 H7 J; \HRESULT hr=CoInitialize(NULL);
& B# X- y# _' E( t, I) p/ E: N9 H
* {$ _) E) X5 o0 XIf(FAILED(hr))
; A  A& ?# Z, o
{

   处理错误
% O5 O  l1 O# ^+ j2 v! I% A6 o
  }5 ~  B3 R4 R2 H% k}
- l$ \7 [+ S4 ~# x0 s
  ^- |8 n( {8 f以下为了方便，省了错误处理

下面创建加载器

& S) u. O8 }. Q3 a+ K- lCoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

NULL,    //不是创建集合
) ?& y) B0 r/ D2 Z) p
CLSCTX_INPROC,      //创建的环境
8 Q2 V3 o: ~0 O' j
# s9 n2 W# B/ r+ ~IID_IDirectMusicLoader8,    //接口的GUID

$ P5 w' H" b; a+ @) A(void**)&pLoader);              //被创建的接口指针

创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID

$ Z# _. B/ _; i" y% t) s4 LNULL,    //不是创建集合

9 M/ x" ]# l2 U* |CLSCTX_INPROC,      //创建的环境
& v. _! b$ R' U' s
! S' |3 t, f% I/ a/ dIID_IDirectMusicPerformance8,   //接口的GUID
( T6 M, I/ Q/ v' C0 s  X2 Z
$ o1 g; @  [* U; j(void**)&pPerf);          //被创建的接口指针

5 P( Y) f  \/ \# F/ E初始化声音通道
: A& [* F+ A* U0 ^# ]9 H- c& h! o
+ I" E7 G9 S& t# k! spPerf->InitAudio(
2 q8 H3 P! a0 F
    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
4 z! o7 L7 Y3 N$ E3 B" }5 @+ Y
    NULL,//DirectSound对象的指针，同上

    hWnd,//窗口句柄

    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
+ g% O8 j# o1 w1 g# `
5 P. c% F9 o; h* p! L    64, //音乐通道数

0 M; B# n0 [0 Q5 x3 Y    DMUS_AUDIOF_ALL, //声卡的所有特性
5 K, T1 T4 Z% [5 b  L
    NULL // DMUS_AUDIOPARAMS对象的指针

  );

好了,初始化Dmusic完成

9 b) o+ e% Z$ C/ C3 C' y# e1 O下面读入mid文件

, t& G2 I) F# v3 S: v2 F- K. `0 X' M  
2 {/ |6 h* b! T% H3 P
9 j% Y: ^4 f4 M! PpLoader->LoadObjectFromFile(
! n6 r2 |9 p& v4 F! u
. c; ?( ]- x- b* S                CLSID_DirectMusicSegment, //组件的GUID
; Q3 m, _) W9 V8 Z2 \* D
+ F: k# F/ M& k                    IID_IDirectMusicSegment8, //接口的GUID

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

                   (void**) &pSeg//音乐要装到的段
6 R8 Z! b4 B( d6 q% u( `! g
  );
/ {+ y8 P" c% U6 `' `% v
. `$ u2 o, F( p7 t从ASCII转换到UNICODE的函数是

比如
! T3 g( t. ]& j' y- [
const int MAX_FILE_LENGTH=128;
# o  v5 R5 ^3 j: H$ V
+ u6 r1 [: X8 rWCHAR UnicodeFile[MAX_FILE_LENGTH];

MultiByteToWideChar(

6 K8 I% M/ L4 xCP_ACP,//ASCII码
, q5 z+ X! e# M% L. x& p1 _
2 U; c# z" v6 V  s8 e+ j   0,//
% h: T7 f8 {. r6 d
1 }( t0 {1 j9 V- z, ~1 h" ^* Basciifile,//要转换的ascii字符串

-1,//要转换的字节数,-1表示以’\0’结尾的字符串
& ?' ^) d$ q. I* N! B& y
& F6 R& Q! v4 |. L                        UnicodeFile,//转换后UNICODE存放的地方

3 f; S8 e' u. X: a/ u: z; PMAX_FILE_LENGTH);

3 w% k9 f( k% N/ K, Q; e下面播放mid音乐

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

% {* \' _5 m  a2 u4 `pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

pPerf->laySegmentEx(pSeg,//要播放的段

NULL,//保留,必须为NULL

NULL,//pTransiton

0,//播放的标志
; z5 x  `8 d0 F; c$ W$ H
0,//开始的位置
& g/ O: g8 u4 Z( h9 R. c
" d* L* W& t) b& ~NULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认
' {, p- i  q, D* ~
$ r9 W4 j# B* |' v/ v2 jNULL//默认的AudioPath

: Q( d+ ~  B9 x0 I$ U);
% U5 F+ n( ]6 h3 o6 \0 [, F& H
暂停播放
- T, _. i  Y0 N6 H* \8 A' [4 y# s
! a  \8 S7 ?) M& ?9 R7 uMUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

& M% ~' ~( T( T4 g, M/ ApPerf->GetTime(NULL, &mtime);//得到暂停的位置

$ _+ x, W% J4 s. E" _停止播放

; X4 d( l0 P& t; g, i+ hpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

NULL,//段状态

7 k, v" a  m. q' Q6 {) N5 J0,//多少时间后停止,0表示立即
: d8 T9 {- V! m
( `& V& B+ s" s  S  h9 X  L" ~4 h* _0//标志
; W4 ^0 a) D& _& c$ t- S( P
1 c& k) ^1 b& G* V6 _);

& L3 M, v0 M# m从暂停点继续播放

pSeg->SetStartPoint(mtime);//播放点
# ?& {; I5 j+ G2 W5 v- }
pPerf->laySegmentEx(pSeg,

( x7 }9 u1 \- L8 A' W4 x- ]. mNULL,
& b9 J) X# \. c4 W+ G5 W
) g+ Y& l4 }. N( K+ ^3 xNULL,
3 K6 r: l/ V' N: _% N
DMUS_SEGF_REFTIME,
( S* \  R/ a- k+ i
- w" U7 g2 r; F+ ?4 i( `0,

NULL,

NULL,
2 w8 |, J3 d5 i, J* J
NULL

) i' i+ U% h9 N0 d. Y. l* e);

pSeg->SetStartPoint(0);

释放DirectMusic
% a7 h6 _, Q& T/ a) q0 f* F" Y( r6 h
pPerf->CloseDown();

. c. l8 M  e4 @4 l8 \  r' apSeg->Release();

pPerf->Release();
3 |/ h0 v. T  p3 m( d( J# M& d
pLoader->Release();
2 }; R1 b  s8 m$ i2 x; I+ l1 X
  

+ A9 b$ O  f3 P5 T. rCoUninitialize();//停止使用COM

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

当你理解后,可以自行把上面的代码封装为一个类
: W, v/ a$ X" r( n; T
这样,你就可以在你的游戏中实现MID的播放啦!
' W0 K! |$ }: E  K5 D- p
当然,播放mid只是DirectMusic功能中很小的一部分
% u2 n- F' N& k2 s% Q$ K2 T& D
5 K7 ~+ {4 u- b+ M它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
  \" I" q: Q# M1 b1 X- h' H* e/ j1 e
最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
* |0 r5 Y1 g" T2 A9 p3 P
程序下载:
1 L8 u- m3 Q8 ^6 f
  

- u6 E! c  I' m% ](参考资料:
, R; A: R4 I/ I7 S
WINDOWS游戏编程大师技巧

. @$ V9 j1 t$ e4 l+ l+ o4 ^* SMSDN2003的DirectMusic部分)