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

天云上人

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

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

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

/ E7 b* q, V" C0 l/ FDirectMusic主要有下面几个部分组成：
3 N, w# A! s  r7 E
! @! L. S# e% \3 r* a$ EIDirectMusicLoader8

+ U! K' [4 y) [' k( {IDirectMusicPerformance8
5 S5 L" O6 F8 ]+ b: Z
  z; \: s2 j9 q( }0 p1 G3 m8 M: @IDirectMusicSegment8
% e9 N9 W0 g" \/ N7 Z
IDirectMusicSegmentState8
8 j. E% Q. F) u# u% s5 ?- B" Q
3 j% {) D6 ^# }- Q你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
' {. Z# i# o  `# H& u) p; F
' @4 b$ j* M( m8 n$ e; p# fIDirectMusic8

IDirectMusicLoader8

, {# a6 i+ \& V0 d1 f9 YIDirectMusicPerformance8
/ m. h' D" q2 N% M
IDirectMusicSegment8

$ d+ @/ p- N( O( L& F$ _AudioPath

% j/ S5 Y# w9 g1 VIDirectMusicSegmentState8
, h, ?* p" t# i' c! m
5 z. U9 J* ^' W0 E/ O6 d5 K9 L6 C如图:

) A- E/ p' e1 Q0 U& Q                                                                                                   

  

  
9 q$ Z/ M1 G3 T
  

  

  U5 A0 P- L2 S' |- r: \% m+ jIDirectMusicLoader8,加载器。用于加载Mid文件等等

' m* O4 [; T& e4 N% XIDirectMusicPerformance8用来控制DirectMusic的接口
! m3 V7 g: {5 f( h7 q
IDirectMusicSegment8音乐数据段，加载音乐后存放的位置

IDirectMusicSegmentState8 音乐段状态

, H; j- E& v- W1 V$ i顺便说一下DLS
+ E8 V# |; e# }0 k+ G0 c+ ^1 K
: S. Z% I" ~$ N6 g我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题

DLS全称是DownLoadable Sounds
' Z8 L0 ~3 P2 j, o# `
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.

原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
4 q: u; g* q+ _' b- R
' J+ e4 [% W6 k+ E" W使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
. N/ G* A2 `5 l( f1 v3 i
/ \3 W6 z, U0 p5 U好了，说了这么多，该开始应用了

IDirectMusicLoader8*  pLoader=NULL;

7 I9 ~- X. g6 R5 DIDirectMusicPerformance8* pPerf=NULL;
% `8 g& }# a7 b. J
* Q7 u8 V% o- D$ A- ]/ bIDirectMusicSegment8*  pSeg=NULL;
3 ?: k, n+ Q" R1 y* b2 D: U. _
; A& C) e: D' T4 x" u2 F  H- [: E首先，初始化Com

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

HRESULT hr=CoInitialize(NULL);

4 Q5 P/ A% G6 n7 d: D3 m9 UIf(FAILED(hr))
5 Q% V" U# @  \4 z% Y. W
# r  F- [, o) \0 l1 f: C/ u  l{

   处理错误
' U+ q% W# ^2 F# z5 ~
}
' S3 L. B& q$ h& ]6 _: T0 t
  X* O3 F( K2 E- o+ o* Y2 F/ P- \以下为了方便，省了错误处理
. B" i! C5 X8 {+ i
  K2 B5 w) s. {4 h/ z下面创建加载器

0 E* O! G; a  G$ VCoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
1 m2 x) @$ b. c7 M) P$ ^
NULL,    //不是创建集合
) S* s& L# y# S6 v
& L7 `: I: s: W4 h# B% M* \CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicLoader8,    //接口的GUID

) A' l  R$ h- _- m& h1 z(void**)&pLoader);              //被创建的接口指针
; t$ _. M% O8 ^
创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
' f5 x: U3 O* f7 w- S, G  T
' @, v: c8 C% VNULL,    //不是创建集合
3 V6 |" Q- @$ ~5 g  P
CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicPerformance8,   //接口的GUID

(void**)&pPerf);          //被创建的接口指针
* S3 W9 Y8 l, q5 b8 L
初始化声音通道
. {" D! ]" a/ k2 A; E
pPerf->InitAudio(
: N7 M5 {$ c- [
+ {$ m( r: K5 ~8 O) N) b    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
3 k0 X* e1 N3 h! R* e
7 @- |- S1 I& F3 @* i; L8 c: W  ?    NULL,//DirectSound对象的指针，同上

    hWnd,//窗口句柄

9 f  H8 Y' T9 Z; }! ~    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

    64, //音乐通道数
5 B& ^# ~4 [9 @1 d5 N8 V
    DMUS_AUDIOF_ALL, //声卡的所有特性

* T7 G/ g7 s% k) y2 R    NULL // DMUS_AUDIOPARAMS对象的指针

  );
9 D. P5 G. k7 o3 o/ N
4 c6 x7 P! R; ~3 n& d' T# e. M好了,初始化Dmusic完成
* ^6 D( ]5 d2 V0 T& f+ S9 R, U
下面读入mid文件
6 H8 V% `- a1 x
: R0 ^9 @- S8 m$ e) J  |4 L2 M  
5 o# p6 V% D6 v" Y( r6 q, V
* p& W4 j1 J% h6 u4 A' y9 ApLoader->LoadObjectFromFile(

" l6 x6 W6 I: C' n9 q0 d  G                CLSID_DirectMusicSegment, //组件的GUID
4 Q+ K3 e) A; Y' \* w
                    IID_IDirectMusicSegment8, //接口的GUID
$ j2 M, C) V' Z! ]% d
) v- Z! P# x/ x! O; H1 i                    file;//文件名,注意用Unicode
% {8 P$ r# U8 ]+ m
- @1 ~+ ~. J, G! R                   (void**) &pSeg//音乐要装到的段

  );

! M  u/ e  [" i# G8 F从ASCII转换到UNICODE的函数是
! q# k9 [! n) i% G) k$ S/ F
比如
3 n$ X6 i1 C( n: d
const int MAX_FILE_LENGTH=128;
2 b  X- e+ [7 l9 J: K/ H8 {
% ^- A# }: t) b6 V( yWCHAR UnicodeFile[MAX_FILE_LENGTH];

" y0 N; X* @, O2 z" v' QMultiByteToWideChar(

CP_ACP,//ASCII码

   0,//

asciifile,//要转换的ascii字符串
- B  a% i: R) J6 t* L3 g
-1,//要转换的字节数,-1表示以’\0’结尾的字符串

                        UnicodeFile,//转换后UNICODE存放的地方

) m5 z9 k( a- M$ I4 z& vMAX_FILE_LENGTH);

2 G# Q+ T  M! {1 ^# G( v下面播放mid音乐
5 V8 x8 d" Q# D9 ~( E) n$ h, ~6 k
pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限

pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

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

NULL,//保留,必须为NULL

NULL,//pTransiton

6 o0 t6 [5 R& a9 }. o% f& t0,//播放的标志
5 s5 U( I- M' i/ a) t/ b
0,//开始的位置

/ X/ p+ a, g' o* {7 ]  _+ UNULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认
9 {6 b+ h( r6 r" {
6 D) v; g9 Q- i- r5 eNULL//默认的AudioPath

);

暂停播放

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

pPerf->GetTime(NULL, &mtime);//得到暂停的位置
! h5 C+ ^/ h9 L# l+ |7 t: G) l2 Z
停止播放
$ F% Y* U% j, m) @; G0 j; N
pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

NULL,//段状态
; y1 u9 v( W" C8 j; ?: L2 ]
0,//多少时间后停止,0表示立即
( @3 f. t1 o/ U+ d0 f( C
! F) ?- q8 n- l. S1 y9 [0 Q/ C: K0//标志
  }8 h4 A& Y2 c) l; }1 M
);

% e* \$ W. q: c( H. J& k从暂停点继续播放

pSeg->SetStartPoint(mtime);//播放点
2 T2 q5 n8 d( {6 z6 ~
& O, r  z- d" |( |* e. _pPerf->laySegmentEx(pSeg,

NULL,
3 q; f% j! {8 y+ N" G
NULL,
% x2 Q% t  a; j9 D
: R4 h+ G6 {* m. k) ADMUS_SEGF_REFTIME,

% k8 t" J  V5 G* |( c% L: x+ K0,
' V" R! G) |4 K4 G+ M- w
NULL,

NULL,
, o) e0 l/ K; X) `
NULL
& u) ~# r4 q. T. H! V7 l( I9 r
);
# K- R, j( p  j- K4 }' o3 }
pSeg->SetStartPoint(0);

释放DirectMusic

/ z1 F" g& v5 s5 HpPerf->CloseDown();

. l5 G1 M1 z. d9 i$ F5 F8 FpSeg->Release();
# r, V3 F( D  I3 r8 n2 s
, K1 D0 W; Z: S8 |2 V5 bpPerf->Release();

. d! u* g2 X0 ~9 s8 F. _pLoader->Release();
  G: z, _$ d# n* q
. N4 b0 b. a. [0 ~! z3 E7 X  

CoUninitialize();//停止使用COM

好了,整个过程就是这么简单!
" g! z) G! B& G2 W
当你理解后,可以自行把上面的代码封装为一个类

这样,你就可以在你的游戏中实现MID的播放啦!
0 {' P* }" T* }
* @) X  r) T5 m, G( f. m+ ]+ ^当然,播放mid只是DirectMusic功能中很小的一部分

它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!

! r* p5 P1 \% T最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

程序下载:
, n3 H7 [7 Q0 l+ i
  
+ O1 V# M. H0 X$ E" E
(参考资料:

WINDOWS游戏编程大师技巧

MSDN2003的DirectMusic部分)