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

天云上人

播放MIDI音乐——使用DirectMusic
+ s* [$ ~2 \$ p  e& `- BBy Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)
) _5 G! ]+ E5 C& p
(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)
8 q( q' F; l+ p# d
6 L8 n8 x; D" j) j# ]# s5 b; j& h在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
8 u' w8 `' w- a: z2 N- g. Z
5 p7 v# x) O3 y4 K" t: P2 z+ C: \5 g8 DDirectMusic主要有下面几个部分组成：

IDirectMusicLoader8
# ~6 Y1 }1 K; C; r- i
) n+ ~# v- P; i& q2 q3 CIDirectMusicPerformance8

1 V: Q0 |2 z  ^2 d+ Q$ @: IIDirectMusicSegment8

) b% c' d* I% {5 l- |3 EIDirectMusicSegmentState8

* \0 \" B% T8 T( D7 ^4 r5 a3 Q  |$ `你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

IDirectMusic8
3 z' ^+ S' |: J* J0 l9 |& q
1 q9 w! n( R5 \$ ~4 S6 v3 u0 eIDirectMusicLoader8

) z5 k' z+ F7 _0 V* ~IDirectMusicPerformance8
/ @4 O2 R! X+ b1 ]) v* b
" E6 ?' _" H1 N% C' ZIDirectMusicSegment8
5 _! d$ o/ ^$ c# U$ b3 i
AudioPath
2 ~  J" r2 m2 A/ ~* {' s
/ p7 ~9 \1 Q5 ^0 [7 Y5 VIDirectMusicSegmentState8

如图:
6 ^  q) M+ P' E* [/ R! ~1 C( w5 }
                                                                                                   
. {) h5 ^( h/ k$ @
6 O" D1 ~/ u. `  
; z1 D* ^! |! t6 U, b' \
  
& \9 d1 M+ ~+ R
# {# k5 ]& f5 F7 m  

  

: K5 [- |. B- {IDirectMusicLoader8,加载器。用于加载Mid文件等等
4 e9 r5 j1 V8 r1 x3 Y5 O
2 {/ P) x" Y4 k$ B: y9 n$ RIDirectMusicPerformance8用来控制DirectMusic的接口

IDirectMusicSegment8音乐数据段，加载音乐后存放的位置
! }* y( m# e6 \+ O
IDirectMusicSegmentState8 音乐段状态
4 N, d  Z, T8 x0 ~2 N. t
# }) t8 A! C9 b( Y" m0 N4 {1 j顺便说一下DLS
' Y( m! H/ `4 @/ H5 R& x
我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题

DLS全称是DownLoadable Sounds
3 V: k% R% y5 F' z9 ]& N7 T( Q
( E9 i. ~1 y1 c9 e7 ]" K+ f  [, v5 G8 R" kMSDN中这样解释：

1 b- N% O  |9 I/ |9 T, aA 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中
+ ], p$ R6 L8 y+ u# Y" _9 L* |
使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
( f& z. h# z3 d0 o* c
8 d, u1 n9 N0 _) G1 {* }9 d1 {* e好了，说了这么多，该开始应用了
* u/ U1 y& f+ i' _1 ~9 ?
9 \- _  c+ p. l- F3 w. k3 SIDirectMusicLoader8*  pLoader=NULL;
# ]0 }  C. m& z: R( P
IDirectMusicPerformance8* pPerf=NULL;

! q, M  ~! i" ~IDirectMusicSegment8*  pSeg=NULL;
" j+ U2 p; N' W
首先，初始化Com
7 r( O$ d; {1 o( }3 b) o! n. L7 {- }: x
(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
7 {' @* V& `: f2 r: m4 Q2 r
HRESULT hr=CoInitialize(NULL);
0 g. h1 L8 t" V$ l$ d1 V0 i
If(FAILED(hr))

{

) z7 O6 D: \1 \( w$ i0 b   处理错误
9 ^" Z+ V, M+ L, ]4 K
5 U9 Z' `1 t. u( F* c}
% x# {7 R2 k9 W+ R5 v" v( Q
8 s: n) n' l/ G1 v- Z; F- E! @以下为了方便，省了错误处理
( b8 _" {1 P' J
下面创建加载器

CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

NULL,    //不是创建集合

  P! B, Y0 ], R7 \6 qCLSCTX_INPROC,      //创建的环境
3 y+ t# _6 s& a/ y, ], a4 j' n
+ F; w' o2 A- a2 CIID_IDirectMusicLoader8,    //接口的GUID

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

创建“表演”，（控制器）
( }! v! j, m4 w, `- {8 t5 G2 {5 _
CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
# ]1 |$ s" t3 c6 @  k4 \
NULL,    //不是创建集合
# y0 X! G3 ?8 [% J
: x- Q; \5 Z+ k! E5 {* l# H# uCLSCTX_INPROC,      //创建的环境

( f4 F. [* N# W, O& q8 PIID_IDirectMusicPerformance8,   //接口的GUID

( Q" T/ q" U4 o0 z/ y  \' d(void**)&pPerf);          //被创建的接口指针

  g- g' _* @8 G) |* \初始化声音通道

pPerf->InitAudio(

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

7 I. N, U' Q! u6 o    NULL,//DirectSound对象的指针，同上
6 D, i; G6 i0 z' p4 \$ R
9 O; ~$ M1 D. d    hWnd,//窗口句柄

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

0 ^8 R+ m3 y9 v$ u5 z$ A    64, //音乐通道数

  f; L* y7 M  l; f5 n    DMUS_AUDIOF_ALL, //声卡的所有特性
. u" e8 ]3 H& y5 f
    NULL // DMUS_AUDIOPARAMS对象的指针

  );
: `0 b: U- e& _6 `& ~. h+ w& t
好了,初始化Dmusic完成
3 W. R, p# P0 F0 [
! W5 j2 }4 l! |下面读入mid文件

' E1 D! q: k: V$ |% M  
3 `" f1 V8 {8 {3 n7 C) _
  E0 |" `5 N( X& r. w" L. V1 i; EpLoader->LoadObjectFromFile(
% K! x- ?5 t' c- ]) ]0 F9 z
- h# D$ k; n% ~+ @0 e                CLSID_DirectMusicSegment, //组件的GUID

, i# j8 ^4 T; s3 b* `4 R                    IID_IDirectMusicSegment8, //接口的GUID

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

' f, P9 w4 Q: }2 T                   (void**) &pSeg//音乐要装到的段
- B/ C) V. x  {6 w
  );

从ASCII转换到UNICODE的函数是

比如
$ Z. I$ k+ k! R
const int MAX_FILE_LENGTH=128;
# R, [2 @# D% O% S+ d- z* c
WCHAR UnicodeFile[MAX_FILE_LENGTH];

( `& W+ D* I; m) S9 A% R$ z- XMultiByteToWideChar(
- y* N. @( w+ w
CP_ACP,//ASCII码
7 {0 K9 [9 R5 i0 I5 ?
4 R% f- E/ ]8 `% n1 E/ [   0,//

+ J; r7 C$ q$ Qasciifile,//要转换的ascii字符串
% V. i. m" s' e. J
-1,//要转换的字节数,-1表示以’\0’结尾的字符串
1 e1 Q! R, C5 x7 F  ^
                        UnicodeFile,//转换后UNICODE存放的地方

MAX_FILE_LENGTH);

下面播放mid音乐
& ~2 L+ R  s. u
: I" F2 T6 M/ B; D$ p4 \pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
+ U$ b0 w; `8 d2 D: S+ V
6 L2 `5 s  T" }4 B& ]6 W8 upSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

# m4 S. V5 x3 ]' k8 w0 ?1 YpPerf->laySegmentEx(pSeg,//要播放的段
/ v9 C5 Z3 _# _4 [! g( P9 u8 o
2 i3 D) B$ g; ]. ?" h9 m, a, iNULL,//保留,必须为NULL

, W7 Y: _8 x/ RNULL,//pTransiton

5 b  I0 z/ A) y9 v0,//播放的标志

0,//开始的位置

) s3 d* Z1 K/ v$ LNULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认

NULL//默认的AudioPath
5 d/ ^2 I. ]$ j
);
4 u9 P3 ]) O% M) |& I" U9 H$ u( U: E
" a1 C; o0 w# J* U- Y) }暂停播放
+ j! v. F/ x: r
MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

. f2 c7 B) Z' o5 H" ZpPerf->GetTime(NULL, &mtime);//得到暂停的位置
; W( e$ K0 p. T4 o7 J" {& S
停止播放

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

NULL,//段状态

0,//多少时间后停止,0表示立即
/ v: ?; G- U- b: n: A2 A
0//标志
/ u0 N5 }+ _$ R2 A1 S
);

3 F: Z: K6 ?$ y$ J: R从暂停点继续播放

pSeg->SetStartPoint(mtime);//播放点
" S4 v# Y! c' r. G
8 U' e+ B+ l; f4 F+ D- ~  A' n* UpPerf->laySegmentEx(pSeg,

9 y4 V! }" @) K' K0 QNULL,
. U5 s+ @) c& m7 w; s  h+ o; B1 J
5 w2 B! c: C9 l; \8 |NULL,

! i3 J! X# [2 j8 D. \  ~( {DMUS_SEGF_REFTIME,

0,
* I3 u% j2 }% _/ a
NULL,

NULL,

3 e" G5 N& @) I: f. ?9 VNULL
: `: x" i$ Y( Z* C, j6 X
);
7 R3 k+ X) `2 Z! p, R7 S
% U- z2 D% v. R( V1 I, hpSeg->SetStartPoint(0);
) D7 ?, L/ D7 M# a8 u% o/ `# w
5 ~' A+ q/ Y8 t7 U% R  `% S* W释放DirectMusic

pPerf->CloseDown();

7 k' @7 f7 A1 j2 u) w6 w  s; Q0 _# i+ i! QpSeg->Release();

pPerf->Release();
! L6 K) k. U4 x" W7 X7 }% L
pLoader->Release();

% s; n, I8 F. }, D  

CoUninitialize();//停止使用COM
, j, l( j, N6 ?/ Y8 y
好了,整个过程就是这么简单!

2 j& l, E2 R- L" P. S当你理解后,可以自行把上面的代码封装为一个类

; W2 f4 E+ k' K8 v6 a% D; I1 W& y这样,你就可以在你的游戏中实现MID的播放啦!

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

" `7 W* h! m8 M. V& u0 k) e3 q/ k它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!

1 q; ?2 p9 e5 S. T7 E8 J. \最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

) h, J' S6 v- Y1 U% b2 U程序下载:

  
$ M# [5 y% v) {& W
(参考资料:
' k; F( w! T! g# @& o& `' ~) ]
0 T2 \' A, c  jWINDOWS游戏编程大师技巧
5 x% ]5 k. L; j  ]% R- q
MSDN2003的DirectMusic部分)