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

天云上人

播放MIDI音乐——使用DirectMusic
8 S( p4 P8 q- L. |2 H$ lBy Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)
: L7 {9 Y, w1 G9 ^; G5 m
( g; ?  U- d5 ~: Y(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

- W9 |7 P3 h  v- O* ~$ L. {在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
6 [; A+ V/ f$ s
" a4 d' a/ P) y4 J# E3 ZDirectMusic主要有下面几个部分组成：
9 w0 _9 c! _8 r' W5 c
, J3 C7 q: J0 W* @2 a4 S* Y8 m! Q8 {IDirectMusicLoader8
& m3 g; @$ @7 \# e3 f
4 Z3 [7 |/ T" y* N: }* n3 U2 N* VIDirectMusicPerformance8

' g* F( j6 B; ~1 |+ nIDirectMusicSegment8
0 J0 i# O4 F# R4 b" e
7 l' I7 n1 ^2 bIDirectMusicSegmentState8
/ s: D( J+ X6 P9 ]; `. P
+ j' K7 H! I/ _$ T你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

; U9 @7 \! V8 E* f- ]1 KIDirectMusic8

% e6 g2 n- s0 G2 y) iIDirectMusicLoader8
8 b3 m% ]& v& Q- O4 \+ i5 h& [- f: q# _- Z
IDirectMusicPerformance8

IDirectMusicSegment8

7 Z8 v' V0 \. C) `/ Q6 k7 r, lAudioPath
) r. l  K) B& s/ A: {' M, H- G
( p( I# m* ^6 n0 a; R$ {1 ?( m; xIDirectMusicSegmentState8
3 S) E: {% V5 r7 o
0 ~* [& `% \" |, A% Y9 R如图:

                                                                                                   
$ {2 m! D) E$ j( x5 D+ m
  
6 ]+ J4 S0 I8 |( c2 b$ f) a- [
2 w" p* e% H% P; A% g# e* u  
4 h1 [1 W2 F2 g8 D
6 N0 u( q8 E' z. J5 w  

: A. Y/ K0 l- e4 C# Y* ?$ P  

IDirectMusicLoader8,加载器。用于加载Mid文件等等

2 ~4 |: X% q" a2 Q4 ?. Q% A% TIDirectMusicPerformance8用来控制DirectMusic的接口
, ]% w9 ?3 W! d# i* p
! \. V. q! W- T: Q' CIDirectMusicSegment8音乐数据段，加载音乐后存放的位置

7 b6 m/ i5 z* g0 I: T' r/ ^9 o- nIDirectMusicSegmentState8 音乐段状态
3 D% M: c8 x4 g4 f' ^4 W" w
" ~: M2 [1 |9 x  `( G6 x9 w  t顺便说一下DLS
4 D( m5 w- C5 f, m/ ^3 o
* v/ @6 @& y' U8 O, I. J9 J) t我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
/ g- m, b8 S! ^2 T' @  \; w
DLS全称是DownLoadable Sounds
5 h/ |; [0 n9 r  m7 p
$ b5 {9 H$ a) Z* Y- Q. G( m, QMSDN中这样解释：
  p) x' B- f- a% T2 E$ X
4 [, ^; C4 Z( N- ]8 B- q6 g8 x3 `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.
) e) l9 V$ x! m3 x- y9 n
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
8 \7 C# d/ P& o/ `
使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）

好了，说了这么多，该开始应用了

1 K8 [. V# @+ \# ~* G/ V9 z' hIDirectMusicLoader8*  pLoader=NULL;

IDirectMusicPerformance8* pPerf=NULL;
  ^. |( l( c& I  U; h
) R1 j% X! s$ j, B' mIDirectMusicSegment8*  pSeg=NULL;

6 J7 o* O; p) b" J3 _- _9 t% @首先，初始化Com

* R/ I) e, Y6 d1 K1 z2 t+ p( r(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

$ _5 b+ l7 Y% n/ h$ cHRESULT hr=CoInitialize(NULL);
: J3 [$ j7 ~! P6 W: ~% J
If(FAILED(hr))

* @; d$ k- z" c: ~{
* x0 H$ @) M# n' ?7 ^* d
   处理错误
, M0 A0 g. U" E& o5 |' M+ _
}
6 ?" `4 v4 |; o5 i6 w: |
以下为了方便，省了错误处理
& Q% x+ m6 U  m/ @
下面创建加载器

; |# r7 ^; x1 J+ {) cCoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
0 F1 [+ T. a, G% z9 P8 f7 j% E
# M- j" ^; z' m$ |  ~NULL,    //不是创建集合
: y4 h8 P, n# i9 `  E6 `, i5 H; _
: s( z6 h$ E0 B( C5 QCLSCTX_INPROC,      //创建的环境
! w: T7 g7 i4 d: M
IID_IDirectMusicLoader8,    //接口的GUID

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

7 J( a. W/ j8 B% @创建“表演”，（控制器）
' f! E1 N# T' X& w! g
CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
) v7 z5 W% g, @) t- Y" d3 d: d
" @. Q* J4 d+ ^( j/ `" GNULL,    //不是创建集合
, K4 T: @, Q6 f8 d
CLSCTX_INPROC,      //创建的环境

7 \9 d8 ]# y4 x4 vIID_IDirectMusicPerformance8,   //接口的GUID

! q) ]6 d9 H6 _+ p. ^) ?4 w(void**)&pPerf);          //被创建的接口指针
5 u- @3 @# d% u$ u
初始化声音通道
7 K6 w- y6 C3 f) h( [' e
9 R2 Z7 @' Y2 ApPerf->InitAudio(

6 t" \- I+ Q& w5 }. ]% @3 D' {    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

    NULL,//DirectSound对象的指针，同上

" N& u3 B: ~: W0 h8 O! F/ j# T# U( @    hWnd,//窗口句柄

    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

    64, //音乐通道数

/ V" ~9 x8 X$ ]    DMUS_AUDIOF_ALL, //声卡的所有特性
/ H# C: @- h8 o$ E- \' G
    NULL // DMUS_AUDIOPARAMS对象的指针
' t/ h0 Z6 |  w% k
  );

4 }, Z9 x9 q1 k0 K好了,初始化Dmusic完成
' {* G, h  M) B# T; |3 W
) o1 U- o. |: N' ?$ V: ^2 n0 l下面读入mid文件
4 s( l# x/ V; s' O& l
  
/ M5 g) }0 F/ h; M, n
pLoader->LoadObjectFromFile(
' J  k4 i) ~/ L' X* g8 x
                CLSID_DirectMusicSegment, //组件的GUID
7 |6 ?9 h2 A9 n! i
* O6 i) E# h5 ^1 z                    IID_IDirectMusicSegment8, //接口的GUID

+ h8 W1 H" s$ |( P/ M" U4 m& D- ?                    file;//文件名,注意用Unicode

* n# e: L& E& ]" X7 F                   (void**) &pSeg//音乐要装到的段
3 t% P1 p3 [, ?4 B( m
0 o, ^$ o, i# l0 k  );

% y1 l( k* Z% Z& m/ R从ASCII转换到UNICODE的函数是
; T- M$ ?6 c" d/ J7 v7 i4 Q! r
) g" n* t- {( Q6 e2 X! g比如

& ^5 m0 f9 q- Dconst int MAX_FILE_LENGTH=128;

WCHAR UnicodeFile[MAX_FILE_LENGTH];

. n: v; J3 a7 a2 `& J1 t8 u8 v* N' {% Q% V6 DMultiByteToWideChar(

CP_ACP,//ASCII码

   0,//
+ U1 d4 ~) v/ }9 x7 I
asciifile,//要转换的ascii字符串
1 f+ W; j5 ?* R  T9 `
. w' `" U: c5 ?5 ]2 l3 j8 X' F -1,//要转换的字节数,-1表示以’\0’结尾的字符串
: r- I, N6 M3 `( H5 S
1 L1 {0 K2 W( a, z; m7 N5 a1 h7 H                        UnicodeFile,//转换后UNICODE存放的地方
  ^4 X( ?$ h" n* l9 N, L9 G) F
/ K2 @2 v, r" `5 [1 ~MAX_FILE_LENGTH);
0 k& K1 ~( X" d$ r) E5 E! |
; W0 A+ s, B& P5 n+ I* {下面播放mid音乐
6 V6 A2 Q: n* u2 g6 m+ |( J, B9 G0 \* h
7 K2 \. @7 S9 e: d. d9 }6 k; KpSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
3 |) p  ^0 V8 e
pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
4 p, D7 J7 A9 b
pPerf->laySegmentEx(pSeg,//要播放的段

NULL,//保留,必须为NULL

+ t$ l. d1 [1 m! H+ q4 k# FNULL,//pTransiton

0,//播放的标志
8 ]2 p/ v) Z3 X: d7 e; }* z
, l" S  Z9 a: ~  b9 S0,//开始的位置
) T  ~' \/ D8 H0 y1 C% h9 R5 G
NULL,//用与接收段状态的指针,如果不需要,就为NULL
# [0 O% h+ r; ~; A6 {3 _1 T3 C
/ b3 A. z7 ~; \: s7 W3 f6 oNULL,//使用默认

5 T3 Q$ F' s  ?9 O5 G' H5 X5 S9 H, J2 F9 lNULL//默认的AudioPath
& E" t; D- r5 `
$ o" i: Z. Q2 s);
! A  K* x) N& ~. k! {
暂停播放

MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型
4 S  a, E/ ]0 Z& Q8 r1 ?7 o. B
+ ?' |9 x9 k( l' d1 n) o% FpPerf->GetTime(NULL, &mtime);//得到暂停的位置

( U$ E5 z4 k0 u, Y8 e停止播放

pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

NULL,//段状态
& R2 X7 P0 j1 P2 b8 a
0,//多少时间后停止,0表示立即

( U; b8 C: l, ]& b* o6 e0//标志
3 z' l" G" X# [% l+ V
);

; ?$ h8 t' K1 D8 r8 h0 k从暂停点继续播放

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

pPerf->laySegmentEx(pSeg,

NULL,

NULL,
+ |$ i9 @; s9 R3 I4 ?
# m2 ~( x0 q' b$ |. l$ R9 dDMUS_SEGF_REFTIME,

1 M6 F- B+ }1 H4 |. N6 j4 e( T9 W0,

NULL,
- @/ S. M! M: y' Y" G9 I4 B! P, @/ P3 N
NULL,
5 n  i+ b! C8 _0 O6 F, I
( x% U0 H, Y. ~1 h) `( s0 q! bNULL
% [2 P# d1 z' O4 B* u
0 I, P. R9 G" W) Z, _);

pSeg->SetStartPoint(0);
: t* d$ h# M4 F1 Y: C7 H7 b
释放DirectMusic

pPerf->CloseDown();
: T$ ?9 L* o! }
, ~- m# p" c: T9 O: {( NpSeg->Release();

pPerf->Release();

1 D  A# v" h. R3 h7 d. spLoader->Release();

  

- V" t" o9 Q9 H# N) aCoUninitialize();//停止使用COM
  h3 P: S7 p3 t& T* q8 Z# U
$ U0 \: ~/ b1 B  z* I; M6 [好了,整个过程就是这么简单!
/ I. Y+ _7 h2 U
0 }8 z. X% w1 u: e: o! f6 m当你理解后,可以自行把上面的代码封装为一个类
2 T1 v/ X) c7 K9 ?, E% X( K
这样,你就可以在你的游戏中实现MID的播放啦!

9 z  O& E. k# S' {* T0 I* D当然,播放mid只是DirectMusic功能中很小的一部分
1 K! c4 {. w% V: D+ `/ y8 X7 L
( \- [+ t( N7 C& Y+ s它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!

+ D# G8 b# R8 ?最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

2 q; u6 `+ V6 l- _5 ]+ |程序下载:

' x3 l0 v, h2 |$ F+ U& c2 |1 e  

(参考资料:

: c! c0 w& b( S: `# H! `& c, y: BWINDOWS游戏编程大师技巧

MSDN2003的DirectMusic部分)