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

天云上人

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

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

( g2 y# `" {* y1 D在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
: X8 Q! f: h' A' i, d
DirectMusic主要有下面几个部分组成：

+ ]/ z* I# l, }4 G+ CIDirectMusicLoader8

( _7 I1 b, R2 O. @6 kIDirectMusicPerformance8
5 S1 l- U0 I: o5 h9 n/ [- M
IDirectMusicSegment8
$ L5 b. _! _& }( J& {/ {# X3 ~
7 ]  r2 m) F( X& m! BIDirectMusicSegmentState8
  p7 {! C5 a. W: C; w7 e( e* \
1 F; V$ |4 t) q你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
6 K% M. Z4 ^* D% m
& U3 Z) p% ~  b0 w) RIDirectMusic8

& h9 S1 L" m9 Q* \  O2 v! }IDirectMusicLoader8
0 W5 [& u' c, h+ Y2 |: R* [
+ h7 p7 Q7 h% z/ r6 c( j% G3 H4 mIDirectMusicPerformance8
. o* Q( ^+ a! @( x2 d) p
1 t8 l3 s, }0 K$ @0 o5 [5 V0 xIDirectMusicSegment8
$ v5 n$ Y8 h; u/ z; I+ _8 `; d) X
2 P# C1 B1 U. x& U- I5 K8 }* _AudioPath
. O, z% f6 g7 t: h# _( H2 W
IDirectMusicSegmentState8
% {5 P- T. v1 v0 H" O; H3 a
) G" d) Z0 O- u) w! U: }如图:
* y' |- c9 Q# x* w1 Q6 j0 D
                                                                                                   
" E, A+ y5 [/ J# Y6 ?
* T; S; _) a. _  
9 @& q0 _( O+ t
! D  v0 R3 e/ O  

- r; }" J" M4 V1 o  

  

  E/ f1 g. {* D+ SIDirectMusicLoader8,加载器。用于加载Mid文件等等
, M' d6 I2 t% Q3 v/ W' \
IDirectMusicPerformance8用来控制DirectMusic的接口

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

IDirectMusicSegmentState8 音乐段状态
2 I4 c( q' Y9 E5 \. w. m4 p
顺便说一下DLS

我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
+ x6 T, n" |! h  g+ w1 U
' K+ ?5 Q' p. IDLS全称是DownLoadable Sounds
$ P" }! t. A. c1 i
MSDN中这样解释：
# O# j4 d6 ?5 T" \/ Z
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中

使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）

好了，说了这么多，该开始应用了
! @; X- R4 \* q9 j6 x# Y. f/ {
IDirectMusicLoader8*  pLoader=NULL;
9 h5 l  e$ @% {. u# ?6 w* L
3 y3 r# S9 D4 G9 XIDirectMusicPerformance8* pPerf=NULL;
6 H. N2 Z+ k! |' d- G% ~
IDirectMusicSegment8*  pSeg=NULL;

7 I$ j7 m  z. w/ h首先，初始化Com

(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
+ m/ L9 |" D# X/ Y6 [
HRESULT hr=CoInitialize(NULL);

( Z/ K- i1 ^  @' ~; s3 {0 O: x9 ?If(FAILED(hr))

$ K* ~# i% n& W: n{
, j, F$ a- m$ Y4 w
: D4 F* S" g; Y! X0 G   处理错误

}
* G8 y$ X+ @* k: I& P& O+ h$ {
" V$ F5 |2 a$ }# s% {3 n以下为了方便，省了错误处理
7 [  p5 q+ a. g" {* u
6 K$ m! b0 \0 F* U下面创建加载器

1 y$ K& K+ r2 {5 WCoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

NULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境
: o7 ?, X' E6 F7 e
; d1 q5 j3 k, c* _+ \/ ]IID_IDirectMusicLoader8,    //接口的GUID

, a8 S) h- T) M# Y+ ~( ?& R(void**)&pLoader);              //被创建的接口指针

创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
2 P+ F" I& t& Y4 c# B- D: U
5 Y. A  {' Y7 G' rNULL,    //不是创建集合
- X/ C3 Z8 R8 |6 r, x; q! b
CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicPerformance8,   //接口的GUID

; v( Q; e8 j- d; g(void**)&pPerf);          //被创建的接口指针
: S- J) x& [" E4 ~3 F
初始化声音通道
5 d; C* h8 @6 J2 m- j
: e- _4 p$ w( J. Y8 d( w. npPerf->InitAudio(
, T4 _7 ~( {' I- J
    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

    NULL,//DirectSound对象的指针，同上
$ G8 L! X% g$ m! Q' \" A5 b
    hWnd,//窗口句柄

) D- z+ f* J" l; S* k, @( y    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
+ X! W3 C" t6 y( H" G/ P+ b# ]# d9 S
    64, //音乐通道数

    DMUS_AUDIOF_ALL, //声卡的所有特性
: q% D3 s7 v' A! K- d
7 k" r* D: f& W9 }/ h( O2 V$ ?9 E    NULL // DMUS_AUDIOPARAMS对象的指针
* w7 r( ^$ J5 j6 O% }" w9 p
5 g6 _8 \4 G- L+ R8 \  );
4 b: o# j+ C) I- b( @1 f, c
好了,初始化Dmusic完成

( z% l4 f4 k* A- F, A: C% ~下面读入mid文件

  
3 X3 O% H/ H; h4 n- ~
pLoader->LoadObjectFromFile(

8 n# Q# ?6 @; y+ E0 ?: b( `6 w: L                CLSID_DirectMusicSegment, //组件的GUID

  v7 u( c5 [( L0 q. L. f                    IID_IDirectMusicSegment8, //接口的GUID

! r* `& c5 t% c- s4 {  X5 ~3 ?                    file;//文件名,注意用Unicode

                   (void**) &pSeg//音乐要装到的段

  );

3 C8 o" I5 I) Q$ f4 @  J9 t从ASCII转换到UNICODE的函数是
5 {+ c* `6 |5 H6 I, C" u4 P3 f
比如
8 ~7 T( \& O; o/ j; B
const int MAX_FILE_LENGTH=128;
8 E% U$ U( [% T. j8 a- x
WCHAR UnicodeFile[MAX_FILE_LENGTH];
; }1 `( O' R9 Z# t
5 E, H4 z; V$ H* |( p+ T3 `  oMultiByteToWideChar(
! x7 E( X/ M1 I; D4 \' _3 Q- Z
CP_ACP,//ASCII码
% }7 S" k7 }8 C* I+ B7 j6 J
. e. |4 b6 F+ V; z5 c* k6 B5 J   0,//
6 S( X: t  q/ ^
3 e7 D% j; w  N3 Dasciifile,//要转换的ascii字符串

- u9 H( X- `( A* p) |/ M# R+ D' v -1,//要转换的字节数,-1表示以’\0’结尾的字符串
+ i9 v9 a3 V0 j- S1 D
$ g9 `$ k8 V; ^- j' L                        UnicodeFile,//转换后UNICODE存放的地方

/ `; n5 F- e3 B+ K, E, M% Z8 A! lMAX_FILE_LENGTH);

下面播放mid音乐
$ J! v8 n% ~/ ]
2 n$ Z% i3 j  X9 [0 Z9 x1 D; `6 qpSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限

pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
% U  N9 C( @4 b$ Z
1 j' X$ h+ r0 n  R  _# A. G) F7 e; SpPerf->laySegmentEx(pSeg,//要播放的段

NULL,//保留,必须为NULL

" U$ a4 F+ A5 [NULL,//pTransiton

. g* G5 ^0 j; ]9 a1 q' n0,//播放的标志
. L0 ]# q, F4 i
% i8 M( j" Q  [- S. c  \0,//开始的位置
4 E  a  [$ o$ O# `; x9 k& T& g* m& m
; P) j' [) P0 w! ]& |) b; ~NULL,//用与接收段状态的指针,如果不需要,就为NULL
! Y. R6 B1 E9 i& E
7 C1 \3 x6 Y' ^4 DNULL,//使用默认
5 D6 |# ]  Z! O5 D7 @. N# W
9 e7 q- w. i" ~* U/ r5 KNULL//默认的AudioPath
( a# [4 T/ J0 a/ X7 Y/ D
);
1 j! N: l% o: A; ?' o
' l' a; q% q/ j8 s0 y暂停播放

MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型
' `* r: W- P0 |
/ c) _0 U# D+ f; Q5 l1 {pPerf->GetTime(NULL, &mtime);//得到暂停的位置
  I0 N, X! k2 V0 P& u! U* b
0 B( k, \, j" D" Y# A& n; q停止播放

9 c" b. k* [$ CpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

NULL,//段状态

2 W/ G% Q& V- f0 v8 d7 N0,//多少时间后停止,0表示立即
3 V8 R+ B+ J$ c, E0 M8 g
1 I: E" y; M- o+ M% G! {( r0//标志
2 n8 E) p$ [' f) q
);

从暂停点继续播放
: ]( z6 ?( L( X) T* m
+ B! h3 Z9 Y4 PpSeg->SetStartPoint(mtime);//播放点

pPerf->laySegmentEx(pSeg,
+ m8 ]5 f1 v; B, l( X- D; r" r
NULL,

NULL,

' Q6 B8 u$ N# R' cDMUS_SEGF_REFTIME,

; M1 d+ G3 g. m. c/ b0 F( r, {' ?0,

7 ^0 s( I( }: Z- {6 }& Z9 DNULL,

NULL,
* G" f# \$ A+ e2 T& |# \4 s
- [* ]8 y6 l# y/ x8 {' ^0 p. {+ _NULL

);

0 |- u/ Z3 R$ q9 i, A; lpSeg->SetStartPoint(0);
$ J% m% p7 q6 m: T
7 u0 ^3 `2 i  k释放DirectMusic
! y& o* \2 T& M2 p
pPerf->CloseDown();
, \. |  {( m. l8 ~( d) J+ Q$ U( ~
# E' n# e4 T, `2 e5 P! x0 _& }/ K- }pSeg->Release();

pPerf->Release();
& a' Z+ Y0 v0 \: Q) u+ s5 o; V
pLoader->Release();
. B2 p8 d4 I- x9 X: b: T
7 Z" m. b+ B7 }7 p& a4 V  
: Z/ Y5 j9 ~2 B% y
CoUninitialize();//停止使用COM
0 E& w8 X# N" X3 H
好了,整个过程就是这么简单!
4 a+ n. y+ M% u
) S; ^. H$ w$ }0 S: T0 d7 C, f当你理解后,可以自行把上面的代码封装为一个类
6 Z& \* g" z% B1 d
这样,你就可以在你的游戏中实现MID的播放啦!
' L1 {' T) d& R9 T) @
7 w. W$ _0 m' ?* i0 B) n, v3 }当然,播放mid只是DirectMusic功能中很小的一部分
' ?. R& R0 ^1 S' q. p( A7 N. l! L
8 W+ V! @/ y" g3 i0 Q1 K它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
8 v: d9 Q; L4 @! ^+ r0 z
1 j: T, }& l. m3 q' u- ^( s/ \最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

$ p! u: N3 o+ C5 z程序下载:

3 j- ~. h' o: s" j/ [  
) r1 U/ X" ?0 g. x
(参考资料:

WINDOWS游戏编程大师技巧

MSDN2003的DirectMusic部分)