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

天云上人

播放MIDI音乐——使用DirectMusic
2 O2 T+ E8 I2 r; \7 t  [By Kylinx,2003-5-15,E-mail:game-diy@163.com
5 |) z  ?2 q1 }8 V2 }/ z5 P. @' {(转载请保证文档的完整性)
. I0 _: V0 Z' F0 @/ C
' u. U* _" [, e. R( _(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)
+ }& Z- ~+ m8 x9 B7 U$ S1 o. ]" r0 ?
( m! w( S5 v4 s+ K; z在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分

$ U/ L; W, ?" {8 GDirectMusic主要有下面几个部分组成：
" {! n0 c5 I* y6 G: M
IDirectMusicLoader8

1 {( ^% ~& a" r1 ~IDirectMusicPerformance8

& ?  R  v  B/ H. BIDirectMusicSegment8
7 T# p2 V, D2 R6 F
# E( G; H  S/ y6 }) w# IIDirectMusicSegmentState8

你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

4 ], E/ B/ ]/ B# p# C' _/ CIDirectMusic8
; j  K) y) ~& H! T5 J1 l7 G
) ?) r- K' a( {8 I) dIDirectMusicLoader8

IDirectMusicPerformance8
0 k, Z* R' G0 l1 R5 N, K
- s" s- {  u/ e; \7 SIDirectMusicSegment8
2 B# |# y/ ~+ g  ~
AudioPath

- w; u- y6 A( ^1 S, b& SIDirectMusicSegmentState8

如图:
" m. `4 A) f" Z3 @
# l; A: H' t0 n7 L9 Q                                                                                                   
6 [# I1 F! G$ f2 Y  T, F- D
/ H/ `5 F, r7 a1 B, A: @  

* o' f! v! G0 g  
2 e  V2 t$ [3 S& S
  
" w1 N! i; ]% }) b- f' `
  

9 k' t- _" }* n/ [! Y! m! Q- U$ pIDirectMusicLoader8,加载器。用于加载Mid文件等等

IDirectMusicPerformance8用来控制DirectMusic的接口

/ a1 |4 n- X: L* |, Y. nIDirectMusicSegment8音乐数据段，加载音乐后存放的位置

# F( E4 k, T2 N. e4 z  W0 j( H1 DIDirectMusicSegmentState8 音乐段状态
- P# w# X. n6 m: C
* i: y9 I0 H' O: I顺便说一下DLS
; l, Z( ]$ ~9 b$ ]
我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题

DLS全称是DownLoadable Sounds

MSDN中这样解释：

A 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.
# k9 K2 K# k: k) i7 W9 Z2 l) J
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
4 X( b0 P: A; a% Q' f; [% J
使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
5 G5 y/ L2 _8 S8 Q- c
: k  O3 s7 k) E2 g好了，说了这么多，该开始应用了
9 q7 @8 |. b# o
* Q4 O$ X  {, }! B7 y+ B7 eIDirectMusicLoader8*  pLoader=NULL;

% A0 V; r( [  J) A; X) c9 A4 g; lIDirectMusicPerformance8* pPerf=NULL;
# H2 T3 E" \) h8 c0 x
6 m! D. o, s  hIDirectMusicSegment8*  pSeg=NULL;

! i) C+ P  r; F3 Z6 h5 N* K! N; g首先，初始化Com

# q2 Z/ P$ x. R+ Y# c# P(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

HRESULT hr=CoInitialize(NULL);

If(FAILED(hr))
+ O) g" ?: s3 r. d; [
9 R, M6 {, r) @9 {{

7 d# Q! Y( }2 n+ H5 K, }/ W1 z3 C   处理错误
+ `" u/ A# l( f& T: J4 z# Q6 o% g* T! N
}

以下为了方便，省了错误处理
+ ^6 {9 J1 V9 S2 J+ A. m
下面创建加载器
3 Y3 J9 f+ I8 p5 d) n- X6 w
CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

+ J! f; F. i; I1 Z/ \' ~* J. i- bNULL,    //不是创建集合

1 G; ?$ t" a. Z% q- X% V8 G! dCLSCTX_INPROC,      //创建的环境
! z2 t, s+ L9 j( v9 j* g4 Z
$ m, t# X2 I; c% b4 \2 u% Q: {IID_IDirectMusicLoader8,    //接口的GUID

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

0 {+ r( h) Y3 W) q5 a2 w创建“表演”，（控制器）
+ J! I5 I9 K1 b# `1 Z+ Y' ]" ?
CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
! T3 R* i. O' w: |8 X; k9 |
NULL,    //不是创建集合
3 K3 X2 O8 i) W' O* u5 j" E  b
* u& j) O0 F' ~) |9 K9 i' r) p- lCLSCTX_INPROC,      //创建的环境
+ y' c9 {+ C% j$ w, O" O( N
, N. L4 v# r; a) `IID_IDirectMusicPerformance8,   //接口的GUID

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

! [- m+ @. G0 d) }" d3 H初始化声音通道
9 Y4 N7 w0 q  P+ c: l) T' B7 t8 Z
pPerf->InitAudio(

1 v. A0 R: i, }, o    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
* r/ t) a; K2 M# _5 x* X
    NULL,//DirectSound对象的指针，同上
: n  F. A5 ^5 H0 S0 R+ P# y
# |3 |0 e' i9 P; M. L" r    hWnd,//窗口句柄

    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
* L4 i1 E; h9 }/ }: |6 p2 Y2 A# k/ s
4 e* \+ R! b' p- L% _" F8 J    64, //音乐通道数
* g6 r" u/ [) ~% K( V
3 A/ l+ P' ]! U( Z2 w* [$ [: s    DMUS_AUDIOF_ALL, //声卡的所有特性
4 h% ~  F; A, u' i( @
    NULL // DMUS_AUDIOPARAMS对象的指针
# Q+ B- N& Z; |$ {) ~5 S+ G" V
  );

好了,初始化Dmusic完成
8 b- M; S6 s$ B8 Q1 S: t
$ K2 ]7 Z5 e8 a  B4 V# M7 y1 q下面读入mid文件

+ v% t5 H  H; f0 v) Z% k  

% q* b' k0 d4 wpLoader->LoadObjectFromFile(
2 V# Y; ^3 L. @% _& L$ O1 ?2 A- B
' t" \, L* F! q1 P; A9 n9 F                CLSID_DirectMusicSegment, //组件的GUID

; w# t. f1 d# `& p4 T8 o! I2 F$ O                    IID_IDirectMusicSegment8, //接口的GUID
8 R$ K3 I6 F) A7 n% @6 O
, ~. n2 ]3 ~+ E; n' f3 v5 p7 K* Z                    file;//文件名,注意用Unicode
2 G: p0 g/ }: W& [
                   (void**) &pSeg//音乐要装到的段
6 L; o# s2 n( \$ j, i9 [! u) V- R3 z
0 p% [# t0 ]4 H! x4 K: S# e* y( T4 R" h  );
2 \. [5 x' W8 B& D
从ASCII转换到UNICODE的函数是
( C4 }* h% v# K0 q- O( L' s' i% A
比如

( z! x" o4 N  c8 r1 @8 sconst int MAX_FILE_LENGTH=128;
' s1 _( \) W$ L" E/ _+ O4 W+ `
WCHAR UnicodeFile[MAX_FILE_LENGTH];

MultiByteToWideChar(
: ^6 \; H; ]! z9 _8 t
: b5 d% m$ B% ACP_ACP,//ASCII码

: ~% t9 d) z- j* d0 N9 p   0,//
$ A6 F8 F) ]; n  `5 @4 |; C
asciifile,//要转换的ascii字符串

) U0 w6 ?& M; }( c# A7 V2 {1 Z7 U -1,//要转换的字节数,-1表示以’\0’结尾的字符串

; U/ e! b7 H* d( G& C# E                        UnicodeFile,//转换后UNICODE存放的地方

% z$ M1 n( u3 X. H8 v& p0 i+ KMAX_FILE_LENGTH);

下面播放mid音乐

pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
, [5 l6 E# f2 |$ ^
; w9 y1 `1 O2 ]& \pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

* o+ ?6 W7 {- x# g$ MpPerf->laySegmentEx(pSeg,//要播放的段

NULL,//保留,必须为NULL

NULL,//pTransiton

0,//播放的标志

0,//开始的位置

% ^1 D* Z9 c) @& LNULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认
! b0 t0 C  z: m+ {( z
7 m/ J: W" ?+ I! @/ m- M3 E8 M) D' PNULL//默认的AudioPath

);
- h9 B( J2 g2 f, }. I1 P
暂停播放

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

pPerf->GetTime(NULL, &mtime);//得到暂停的位置
: C" m4 c1 V7 h0 Y" D1 _" g5 B4 I
停止播放
% h6 y% |% s; m7 ?9 l. l9 d# a) M
9 \, \; f9 r- w& ?  G/ @" p3 ]  DpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止
/ `) B' |. U$ |) {# _
( q; b7 T: ~3 G8 a3 ^* HNULL,//段状态

/ y. \* S0 d7 I6 f0,//多少时间后停止,0表示立即
) H( N& |+ S) ^1 `' @# k) P
$ x$ w/ @" ~" {; k! q3 W) d0//标志

);

1 c/ K% V8 R; f$ ]" d从暂停点继续播放

pSeg->SetStartPoint(mtime);//播放点

pPerf->laySegmentEx(pSeg,

! v$ d1 P2 x3 P6 ]8 oNULL,

& h! S! w5 F; ^3 GNULL,

% f; G& X# a; x$ JDMUS_SEGF_REFTIME,

0,
+ @- P: _2 f* L3 b3 `) N- d. i+ i' X
( R; G* L+ H* k: c$ c. k9 p& l3 XNULL,

NULL,
+ C/ v/ U+ D) b* H$ J3 f
NULL
# i6 o3 |5 q; S' @
# v2 }; Y* h  I9 j6 h);

pSeg->SetStartPoint(0);

释放DirectMusic

( a% k" k. e; l1 \3 ~4 e; KpPerf->CloseDown();

pSeg->Release();
+ n& O7 ]& n! _
pPerf->Release();
- e- s. C' r$ N+ T3 V
pLoader->Release();
* c' J8 V9 G1 T- b" ^& W
  
( o5 M0 a2 k# i0 e7 }4 M4 r
CoUninitialize();//停止使用COM

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

当你理解后,可以自行把上面的代码封装为一个类
8 i' ?" D3 g7 T& T  B7 W, h
8 i* `6 R- _& U5 v# V7 n1 a0 s这样,你就可以在你的游戏中实现MID的播放啦!
, r9 J3 z) ]9 n
当然,播放mid只是DirectMusic功能中很小的一部分
2 k+ G0 i7 _9 f& p
/ Y1 y+ I( R) [9 o! p+ H: F2 W; N2 ]$ B8 h它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
6 o# M) K5 @5 G  m& Y) _( }3 ~% A
最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

9 V  n8 m, x8 `" D8 p) x9 o程序下载:
0 L  s7 r- I5 `* J9 K# l
  l2 @) g" E3 Q- S2 ?( Q0 O! d0 r  
. _6 P1 |6 m6 `4 e; z# N4 g) q
" t6 l) P6 L0 b% s3 u6 `" P4 i(参考资料:

WINDOWS游戏编程大师技巧
9 Q  E+ W& C& p* Q' f* v
MSDN2003的DirectMusic部分)