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

天云上人

播放MIDI音乐——使用DirectMusic
. e8 P) n& ~; FBy Kylinx,2003-5-15,E-mail:game-diy@163.com
; j3 j9 O9 G" v  b; \/ v) ~( Y+ x(转载请保证文档的完整性)
% Q0 n5 U2 o1 E/ b7 F& A, P
(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)
# h( X2 @) ?4 N: o4 Z4 Z. L" E+ W
: u7 ^$ D/ {/ ^2 f$ m' K' u3 Q在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分

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

IDirectMusicLoader8

: N5 i- O! t# B" B8 T3 |IDirectMusicPerformance8

  e2 g% g& p5 ^% p. MIDirectMusicSegment8
6 [1 g# ?' n. d1 X8 X0 X
IDirectMusicSegmentState8

/ Y+ }, C8 S# G你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

IDirectMusic8
2 L$ |: p3 |% [! k
IDirectMusicLoader8

- H/ W  P. u8 z- z+ oIDirectMusicPerformance8
4 Z3 o  K8 B4 P# Y
, o! x( a! G  y6 O1 }) \IDirectMusicSegment8
1 C' ?. R! G7 y5 d
AudioPath
& T6 ]9 r% X, s( @7 _# M
: d: j! ~. Z7 a8 p( _% ^; O7 cIDirectMusicSegmentState8

如图:

                                                                                                   

" |  }* Y2 H/ ~( B$ j  
9 L' g2 _3 w9 G2 P# j
! ^0 r4 ?2 n! z' |+ \  
7 ^5 b! Z3 k4 y7 n5 p. F
  

9 N6 j) S7 U& U6 H& ~  

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

IDirectMusicPerformance8用来控制DirectMusic的接口
4 J% h3 ?: I! T, ~0 d' ?3 V/ _
. E9 y/ F7 E* t' s( GIDirectMusicSegment8音乐数据段，加载音乐后存放的位置
+ v' f3 D" L9 ]; p( u
6 o* t  T! ^4 `4 aIDirectMusicSegmentState8 音乐段状态
5 A+ q3 S5 c+ K& u, [8 s6 c$ Y! K! X
顺便说一下DLS

我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
/ s3 L- O1 w' W/ `# t9 ^
* ]$ ]  ^" u0 ~: l& IDLS全称是DownLoadable Sounds
- f9 T( Z/ A1 n" F! z5 T
MSDN中这样解释：
5 A* L$ Q' B' i& P; ]! C
6 Z' A) g; b2 p, [. d1 D6 R" U$ jA 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中
, ~! V$ y+ q$ H9 T7 J+ g: K1 g3 n
使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
9 s, `4 @: h; O5 \' D
" q1 ~, q* d- v* |- N& T' z9 d2 ^# a好了，说了这么多，该开始应用了

IDirectMusicLoader8*  pLoader=NULL;

IDirectMusicPerformance8* pPerf=NULL;

. J7 b# K, C+ }# ^+ IIDirectMusicSegment8*  pSeg=NULL;

首先，初始化Com
; p; P. H5 X( \) M7 k; E
0 |1 i; m6 M/ @7 v+ q# W0 S(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

) k# l3 O( O: g4 L& l0 cHRESULT hr=CoInitialize(NULL);

: }2 H2 S' n/ Y) R" p5 M  u% o& q; C3 K; qIf(FAILED(hr))

{

$ |( e0 Z  u) g+ }9 k8 f* u$ F" F   处理错误
% C/ _  O& \( N8 |1 g
" d; w6 \5 A8 V# U+ |}
# u# @4 ?4 ?. T) N+ ?& w
" l0 N% ?' j+ U) O! b4 F以下为了方便，省了错误处理
; M2 O( K; S& d8 C8 i% b5 Z6 o
下面创建加载器
- f+ w6 K$ N1 z; h
) b" A& ?9 Z# J% G. i' R% eCoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

NULL,    //不是创建集合

+ @( o* \3 a/ l* w; B+ L: e& `' Z1 RCLSCTX_INPROC,      //创建的环境

IID_IDirectMusicLoader8,    //接口的GUID

(void**)&pLoader);              //被创建的接口指针
, N; V  s( [( Z, U& P( J+ J9 }4 s
创建“表演”，（控制器）
# I! G7 G( N1 ?1 J8 v
CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
; Y1 J7 {3 b" M' m% v, S" P, R1 v
- ^- w6 K& E/ ?1 m* @" ~( ONULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

& b6 k0 y  C/ s+ W) I% C4 TIID_IDirectMusicPerformance8,   //接口的GUID

(void**)&pPerf);          //被创建的接口指针
* N* _! F. j% ~4 Z
/ t8 B( x5 i/ l- n: b/ J8 H初始化声音通道

pPerf->InitAudio(
2 f" J# r& o$ ~
0 s$ C/ q* X7 b$ E) f1 `    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

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

3 ~: `6 x% M+ F2 N% H  u    hWnd,//窗口句柄

8 b2 z$ u% o. G# ?- \  @1 F9 S, W    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
) {8 q. g: R* ]) E, z" p* J
    64, //音乐通道数
; ?& v8 ?- Y3 F
    DMUS_AUDIOF_ALL, //声卡的所有特性
4 ?6 B$ L5 P3 p8 q- W" `
" t3 C+ u  E6 x' r/ h    NULL // DMUS_AUDIOPARAMS对象的指针

3 ?2 y: K' ]& F1 }  g" ]  );

好了,初始化Dmusic完成
. V# k4 v. n# q/ _- ?* C9 B
5 g, ]* c+ C. F& }* p& ?下面读入mid文件
& m. b) V' @; h6 a% g# I
. g1 V/ K; F- N( Q  
! B. K8 M7 R, K/ x9 T
! V; y1 y. c4 n% c7 Q# opLoader->LoadObjectFromFile(
1 Q& [" t: A$ d+ S
$ E* E1 b* }2 [                CLSID_DirectMusicSegment, //组件的GUID
: }+ G- \* P; R1 o& u* \
                    IID_IDirectMusicSegment8, //接口的GUID

8 P" n: I$ W1 v( A: e  p! Y$ U                    file;//文件名,注意用Unicode
# S3 i1 u; R) U# D  ?
                   (void**) &pSeg//音乐要装到的段
- k( B( l1 s4 t/ G6 C( [; p5 H) d
  );
" S& h' `. |8 F$ w4 S/ C2 z& y
1 _* z! V+ }2 y6 s从ASCII转换到UNICODE的函数是
3 ]0 X! E& |  ^) |% L2 \  K
0 O9 O4 s9 f; h! d- [2 W7 [. O1 M/ y$ B比如
' T3 v2 k& R$ [3 ^/ t/ x$ m
const int MAX_FILE_LENGTH=128;
  p; B" w3 e+ G" L4 Q$ t+ r2 A9 l
WCHAR UnicodeFile[MAX_FILE_LENGTH];

# G: s0 v1 [& t2 `& c& fMultiByteToWideChar(

+ Q4 M2 p5 t6 P3 V* l/ S8 QCP_ACP,//ASCII码

   0,//

asciifile,//要转换的ascii字符串

-1,//要转换的字节数,-1表示以’\0’结尾的字符串
, I$ K- R6 o1 E: b+ ^
! O$ ?, u" h+ i& O) j                        UnicodeFile,//转换后UNICODE存放的地方
% {# o/ O# x) E( s- J! l, \
MAX_FILE_LENGTH);
3 V7 _% J6 @! D
3 q0 D$ Z! m. z: S( {下面播放mid音乐

5 Z/ _$ h; e8 w1 \. `9 DpSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限

8 Y* `$ X$ Z  {) i+ v& wpSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
- Q) i) b0 K; }8 A' V; v6 L5 R
, e" [1 Z% G; v# C, M% R5 ?  D! xpPerf->laySegmentEx(pSeg,//要播放的段
) d  S: Q! _- L
* |, L) u; g( K# z& aNULL,//保留,必须为NULL

. K. x! t& z) d7 V5 _8 W! INULL,//pTransiton
. |- ]- N6 W1 V
  p+ l6 k5 V2 y. w0,//播放的标志

0,//开始的位置
. `" }. G& s; W- W
) P8 q: k# ?6 t9 p" z4 c# ~NULL,//用与接收段状态的指针,如果不需要,就为NULL

% ^6 |6 u& U8 v7 E# i  ]* A3 sNULL,//使用默认

% S( O- f& i" _7 X+ I3 BNULL//默认的AudioPath
) r1 B) j9 I8 ^, l9 |1 d; ?3 J
2 j3 f/ h+ [8 q4 N);

暂停播放
- c  s8 a3 d" Y" ~$ L& Q. p
5 W  @, Q; v* m# EMUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

% s! z8 b  H7 u5 _, {" C  x# L* HpPerf->GetTime(NULL, &mtime);//得到暂停的位置
1 B$ E" |3 p; Z7 X2 z6 w7 x
6 A6 |1 Y* }, `3 \; G/ F停止播放
+ \. t; R$ N: s- b4 }
pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止
; h  B5 X! y/ R1 T% o5 s4 N
NULL,//段状态

' [* Z) c( b& I* d. Q% z0 x1 h0,//多少时间后停止,0表示立即

% {8 F8 l. e2 s0//标志
5 C8 h$ F" \/ E- G. _: G
);
- H" Y$ f8 d4 @1 C* B8 g' i
( ]5 g, Z6 ?& B从暂停点继续播放
* s7 I! e& t" p
pSeg->SetStartPoint(mtime);//播放点
8 B! ~  b! V! O- m7 x9 u* r3 ]4 x
# {$ J7 }, ?& b; U% ~pPerf->laySegmentEx(pSeg,
. y1 {9 O8 W0 R( C; S0 w
NULL,

NULL,
' z0 R. u( O6 R7 f* [& U
. b" M% U3 q9 Y1 a$ mDMUS_SEGF_REFTIME,
/ v$ O/ c  z. W/ W
! ?5 l$ ?" G# C) k4 o' `6 B; I0,

NULL,
; t! h$ L1 f2 |% a% q2 ^
NULL,
& R2 H. n3 b& b6 Y/ Y
1 m( ?* z  s% q- i* S& K3 L3 ]NULL
* w& e, Z. U$ h) u' N  @0 v. h
);
( B1 z# C( ]2 _1 x
pSeg->SetStartPoint(0);
6 y# E. g1 i. u: S! F* F4 }
释放DirectMusic

pPerf->CloseDown();
$ o6 L8 L" G: B+ e: S
pSeg->Release();
% b5 p, v7 {+ O4 s# {) Q, {) a" ~
pPerf->Release();

pLoader->Release();

. |7 J% Q' E2 }$ e9 p! @  

CoUninitialize();//停止使用COM
! z. O/ r/ K! b% i
好了,整个过程就是这么简单!

# W2 z+ t" |% g" H/ l当你理解后,可以自行把上面的代码封装为一个类
% {, v) R6 F% U, N& t
+ ^1 ?7 Q, u( v8 l1 h: {$ ?这样,你就可以在你的游戏中实现MID的播放啦!
' I0 R5 H4 I" m5 s( y
当然,播放mid只是DirectMusic功能中很小的一部分

* j# I* I) O. ~5 s5 o它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
/ Z" e6 y& V4 V! C0 m. ]2 E
4 G2 O* Y& n1 t2 h. ]  O7 a- `最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

" ]" w5 U" w5 A0 A程序下载:

  

(参考资料:

WINDOWS游戏编程大师技巧
! V4 I0 X. F3 `  ?  d
MSDN2003的DirectMusic部分)