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

天云上人

播放MIDI音乐——使用DirectMusic
By Kylinx,2003-5-15,E-mail:game-diy@163.com
" J2 D6 N# T  I% s5 \2 [! t2 d/ }(转载请保证文档的完整性)
) P- O& y) e" j3 W
(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

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

DirectMusic主要有下面几个部分组成：

IDirectMusicLoader8

IDirectMusicPerformance8
( b' k/ j9 R6 Z
9 R) {5 p1 J4 b0 ^6 Y0 @IDirectMusicSegment8

& \1 b( w. O6 ZIDirectMusicSegmentState8
9 g1 X0 s: Z# t4 u3 @3 c: D* ?
  W. P5 Y" e! q5 q3 c' s你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

! Z) G) d4 N$ M! NIDirectMusic8

IDirectMusicLoader8

8 y8 j/ v  L; u6 sIDirectMusicPerformance8
% n; }1 y7 T0 z# A# k
IDirectMusicSegment8
& y6 \% W& \1 v8 {
# x7 P$ W" {* `AudioPath

( \! l6 j, F: e/ JIDirectMusicSegmentState8

如图:
- u- [3 X4 Z" g4 Q; ^( r" Z
                                                                                                   

  

  
$ H% Z3 R6 V$ O: W4 h  l
6 k4 A5 J. w" r6 v  

- K; ^+ r1 c' D1 ~/ s3 b& @  p  
7 d; R' ?, O) d. |' M8 b
IDirectMusicLoader8,加载器。用于加载Mid文件等等

9 r6 X4 U% i/ k0 LIDirectMusicPerformance8用来控制DirectMusic的接口

IDirectMusicSegment8音乐数据段，加载音乐后存放的位置

IDirectMusicSegmentState8 音乐段状态

顺便说一下DLS

我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
" p$ @8 i8 L5 Y- T1 g; E
DLS全称是DownLoadable Sounds
! O* {, c" e$ W* J0 F( l
2 w* b$ ^" G5 [7 N" C( [6 [MSDN中这样解释：

% t/ S; r, x: K* \  i- o: GA 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.
1 g; w' S# D' `7 N" ?9 L# D
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中

使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
, r9 P, F2 _6 f7 h- \2 I% G
; J) C5 v1 x+ {8 _, q7 K& R好了，说了这么多，该开始应用了

IDirectMusicLoader8*  pLoader=NULL;

: ^, z  z1 f4 a% VIDirectMusicPerformance8* pPerf=NULL;

# ~7 G0 p) i9 @6 DIDirectMusicSegment8*  pSeg=NULL;

# H% k. \# I& Q1 m首先，初始化Com
/ r/ |% K* s% Z1 u  ]3 M/ t6 K$ v
(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

HRESULT hr=CoInitialize(NULL);

If(FAILED(hr))

# x+ M. U( y, r7 e. ^: o{
6 A# B: d6 r7 M* _1 {- Z
! C0 ~% X3 I% ]9 h$ l/ B( T/ w* g5 |   处理错误
, A3 k! ]  W! S! j
! @# R2 r6 M; d+ w}
9 T0 N: z  I' Y9 S% L- V
以下为了方便，省了错误处理

6 w7 v' q/ n. v: r, j/ g+ }# K下面创建加载器
5 l3 B$ t  S6 K  D2 k* `& U5 ]* D
7 x6 Y5 t" }" \1 B: F; \7 |CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

% J- T. }4 k+ Z. l% b& E9 sNULL,    //不是创建集合
0 ^4 c2 ?" T' V) K
8 E2 W" w% n$ b5 ?- S3 RCLSCTX_INPROC,      //创建的环境

2 |# A9 G$ b- g' F* _  }IID_IDirectMusicLoader8,    //接口的GUID
0 `1 X% @& z2 r
(void**)&pLoader);              //被创建的接口指针
+ a% c; z3 h; Z1 O$ o; A: ^; k
% o& n' A' d  v1 _3 l/ ^) c创建“表演”，（控制器）
% l' d4 F; p: Z
CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
  L3 q9 i/ S- B( s, B" r
( o  z' O/ }9 Y( y- ^$ VNULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

  j, {, u& [: ^2 GIID_IDirectMusicPerformance8,   //接口的GUID
, C. Q5 P; A7 _7 b& w
(void**)&pPerf);          //被创建的接口指针
! Y$ r7 d- ^0 [, m, U+ J
& P: y+ g" ~9 c初始化声音通道

+ S- S# k+ t' @7 N. epPerf->InitAudio(

    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

    NULL,//DirectSound对象的指针，同上
- a" x: G( [- E% D9 P4 e) `9 p' k
2 _0 l! R4 Y' s% B' i* Q    hWnd,//窗口句柄
1 a7 Z5 ^4 e% R2 O# r  h
    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

+ A5 V- u2 U; W9 h9 I    64, //音乐通道数
0 k% ^5 v; w/ [
    DMUS_AUDIOF_ALL, //声卡的所有特性
% T  m/ f3 ]0 s4 n2 y
5 s  @: k; e) k% Y    NULL // DMUS_AUDIOPARAMS对象的指针

+ t/ v7 `- W, e; P( v; R: ~  );

好了,初始化Dmusic完成
" c" r2 E) E6 J- z- p7 {
下面读入mid文件
+ u8 `3 g5 N/ s7 U" ?
  
+ Q" ?* j/ a+ Z
pLoader->LoadObjectFromFile(

* M- t5 z' P- Q. k0 X8 {2 B9 X8 F; _                CLSID_DirectMusicSegment, //组件的GUID
. X4 ]( `! Q3 l' R- f
                    IID_IDirectMusicSegment8, //接口的GUID
6 s$ m4 V& R2 \( s0 y# W
                    file;//文件名,注意用Unicode

                   (void**) &pSeg//音乐要装到的段
* W- j; @7 \1 |: S9 C
- M. t& l2 G, a9 i: X  );

, ~: ?. p- r$ r5 }* W* U$ Q4 A/ {4 c& P* j从ASCII转换到UNICODE的函数是
% |& ~) G& _2 c* P! h: M& l
7 i0 B0 c* H/ ]' a) B, e比如

const int MAX_FILE_LENGTH=128;
  }9 c1 k7 w- C9 F5 F
WCHAR UnicodeFile[MAX_FILE_LENGTH];
: M& ^. X: ~& R1 }4 M' ?2 A+ h
MultiByteToWideChar(
3 a, X, j5 Z6 W: y' i- X
5 b7 x" A, W- p7 Y# G: PCP_ACP,//ASCII码
4 K9 `  e* Z: X' u1 ~& e! g
   0,//

% h% X1 ?; q# Y* ^8 F" sasciifile,//要转换的ascii字符串
1 _* s# k) Q) K
-1,//要转换的字节数,-1表示以’\0’结尾的字符串

                        UnicodeFile,//转换后UNICODE存放的地方
/ w/ j1 K# R- D- B2 @5 s2 A8 j8 Y
* D( s) P& W9 HMAX_FILE_LENGTH);

0 X2 x) _  V) x9 f- y- }1 j下面播放mid音乐
0 z- n2 v! ]2 k
pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
* B- a2 r% i3 o& h7 u: d% E) q
; }7 B& `; M' t' O8 R5 ?5 o9 MpSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

- [0 ]. K; o! ]. b/ |' _pPerf->laySegmentEx(pSeg,//要播放的段

NULL,//保留,必须为NULL

NULL,//pTransiton
3 e5 i  j3 |( c& q
4 c/ D. a7 \6 F4 R0,//播放的标志

% M4 C+ d0 o* e' J0,//开始的位置
! ]6 h5 S( Q( Q1 L6 g" q. W
NULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认

NULL//默认的AudioPath
& ~. q. c7 z6 c" l
  v& l" J+ B7 T8 M- s! F- p0 U5 V);
7 J# o: ^* `7 o' q' K  f
暂停播放
5 y, m. r2 n, S. X: b0 U
* @5 K8 @$ ]5 M9 u8 iMUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

$ ?( C( R0 V! r( G: XpPerf->GetTime(NULL, &mtime);//得到暂停的位置

停止播放

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

NULL,//段状态

0,//多少时间后停止,0表示立即

' H& q$ J: b( L9 S. u0//标志
! p9 W+ ?3 p6 A7 w" ~
& x. F; B5 {6 f$ m: a: F) K3 Z9 P);

" c1 S8 `4 I* n6 M% Q从暂停点继续播放

pSeg->SetStartPoint(mtime);//播放点
6 b6 M* V4 H! L% |; |3 X7 \
pPerf->laySegmentEx(pSeg,
/ Q3 u& [' }" {" L( {+ v8 [# j, o
2 A! n7 L1 |, m! W/ SNULL,
5 R: i# G. R) b+ @( \  f/ r
NULL,
% e2 m# g- |5 ^8 j. ^5 R; r
# S/ U4 C5 r- S' F* n: O4 S4 VDMUS_SEGF_REFTIME,

0,

NULL,

NULL,
5 l' n  R  F, C. r* V6 R+ f$ p
NULL

);

pSeg->SetStartPoint(0);

: R3 A0 h  p7 \  W2 Z! F释放DirectMusic

9 s: p: y0 Y3 \7 [9 tpPerf->CloseDown();

pSeg->Release();
* S% R# D: o2 }1 z2 C. Z
pPerf->Release();

* `! p" P1 o6 D! XpLoader->Release();
3 W# i( K$ H' P9 s& M9 D  b
) r2 q+ a6 |( T6 o7 M  d$ t( W  

CoUninitialize();//停止使用COM
' ^* P5 o" d4 r# g) j2 S) d
& x5 {6 M) G/ s% h好了,整个过程就是这么简单!
" x1 y; V" q- I3 E: J
当你理解后,可以自行把上面的代码封装为一个类
6 F* {9 L, r$ z, t5 ~
这样,你就可以在你的游戏中实现MID的播放啦!

当然,播放mid只是DirectMusic功能中很小的一部分

它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
2 J) t  ^# l1 [5 }6 x
最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
/ {9 R& @' g+ S) F+ L, F, z8 D
程序下载:

" c/ \. u3 n: Z3 z; |7 }  

(参考资料:

WINDOWS游戏编程大师技巧

MSDN2003的DirectMusic部分)