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

天云上人

播放MIDI音乐——使用DirectMusic
0 r2 t: m5 k& H; K  n" ZBy Kylinx,2003-5-15,E-mail:game-diy@163.com
6 M$ l" i1 a3 J. ](转载请保证文档的完整性)

6 t, \! m, s& l# y& K(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
1 e/ x( L6 o% i* U; w" C, Z* v
4 u, F8 Y4 A1 gDirectMusic主要有下面几个部分组成：
  O: H" y7 D! C5 X! s/ i$ h3 W
IDirectMusicLoader8
' T  ?+ ~1 e9 I" @- v: Z4 [
IDirectMusicPerformance8
5 \% D/ ^) s' b$ Z  B4 I
IDirectMusicSegment8
5 k8 x+ n. T: d3 L! s1 q
4 Y3 Y7 P; ]% g* e5 C3 bIDirectMusicSegmentState8
9 O" K& a' b0 K: X
. n9 x$ j4 c+ Z+ ^; h2 o+ o你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

( q9 N) d! t0 m* ?$ H; S  ~# EIDirectMusic8
9 S) J: n+ R+ K% T8 _1 _
IDirectMusicLoader8
8 p( x9 f8 t+ J+ V
IDirectMusicPerformance8
( |8 U& c: Q. r. w. J% A2 j" t" Y
' b# C+ D* n3 e7 X  t5 A3 oIDirectMusicSegment8

* J, A! T5 ]3 R, _5 x* UAudioPath
6 V7 }4 W% f4 E. f+ U1 _8 r
IDirectMusicSegmentState8

, X5 F' e- V- W/ O! a" {: s如图:
0 P. n5 P0 t& G$ N+ v
                                                                                                   
0 b8 q9 M" z( N2 {
  

! ]& f; x. u2 I* f  

  
$ x. h, w; H: T+ ~7 L
  

7 R* g/ O6 r/ j% \. |9 ^8 SIDirectMusicLoader8,加载器。用于加载Mid文件等等
: J( _9 w# q* i: m5 C
IDirectMusicPerformance8用来控制DirectMusic的接口
3 r: v) c% H3 m% f
8 A8 T4 X5 O! M1 A3 y1 b9 h) {* LIDirectMusicSegment8音乐数据段，加载音乐后存放的位置

) e" @# ^. Y4 r# lIDirectMusicSegmentState8 音乐段状态
( S; K& @6 P* s
顺便说一下DLS

我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
2 Q8 D7 o  n5 U( a
DLS全称是DownLoadable Sounds
! M; Y4 P! K! p( T' X+ R
MSDN中这样解释：

$ p2 y- O- Z  r/ KA 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.
' q1 `% W* J# Z! e; @$ P& x
& X3 u# b9 m$ D6 ]原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中

+ a; e  n3 m6 _8 \  I" N0 e使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
1 u) L7 x$ R' I& T/ z. e: q4 n. v1 m
- f9 W' i! k' g' R" R% _好了，说了这么多，该开始应用了
8 [8 E- r  I4 o3 }1 u
IDirectMusicLoader8*  pLoader=NULL;

IDirectMusicPerformance8* pPerf=NULL;
; Q% x2 u4 V& j* `& F9 }$ {
IDirectMusicSegment8*  pSeg=NULL;

首先，初始化Com
3 z$ _! w  f+ V9 w0 q, {
(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

HRESULT hr=CoInitialize(NULL);
1 R! ]2 ~7 I) d1 p- u2 b1 v% [1 i
& K! [2 f/ p& ~" @1 ?1 ]5 JIf(FAILED(hr))
+ A' g) Z( _  g' X
( h0 C8 F: g; z1 u. V0 C{

   处理错误
- {; @- E5 {4 V: |
1 W8 p8 L3 M# G: H+ f. Y; Z& M}

7 o6 p& M( J, j) w- A% P" F以下为了方便，省了错误处理
) k* _" w- z& s1 w2 r- E$ I
, c6 R/ N' ^% y( j9 I: |下面创建加载器
; ~" l7 f: H8 M5 f3 R
3 w  G) O$ L8 p& t1 ~& xCoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

NULL,    //不是创建集合
% s% t& }4 O8 ?: {3 v* ?) |7 H# |. q
/ @2 r9 p, o7 f" ]* NCLSCTX_INPROC,      //创建的环境
' ]$ s8 J/ v" F( B0 ?/ e
IID_IDirectMusicLoader8,    //接口的GUID

(void**)&pLoader);              //被创建的接口指针
) B& w& e0 d5 j1 ^& v  t( U4 |
# X5 U' c- k3 p% `1 X& V创建“表演”，（控制器）

# C5 e$ [% c; R0 Z" p& g+ ?: bCoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID

NULL,    //不是创建集合

* n' ~2 z+ w+ O7 nCLSCTX_INPROC,      //创建的环境
2 e, Y: |: s% T
' t. h0 s9 R  N( D- DIID_IDirectMusicPerformance8,   //接口的GUID

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

3 }0 K% x, g. C: c- }; P初始化声音通道
4 n' c  E* h- C; \
pPerf->InitAudio(

$ \+ Y, D1 f% h& M1 |2 }- P+ H    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
, X- H# s6 a  O# E  J5 J
6 g% }% M$ X0 Z    NULL,//DirectSound对象的指针，同上
5 `( r7 P, X# g- O& i! M
    hWnd,//窗口句柄
0 u7 v$ V- T' u  b; E
    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

    64, //音乐通道数

1 I9 `# O$ k' P$ [    DMUS_AUDIOF_ALL, //声卡的所有特性
9 n5 g( Z: m2 o0 j; y9 Q7 {
    NULL // DMUS_AUDIOPARAMS对象的指针
, D& j7 {7 n0 C  ?
  );
9 ~2 ^5 R/ t+ C% ]' i; O' z
好了,初始化Dmusic完成
# P5 _% h! T7 E( c/ ?* a* F6 D: I
下面读入mid文件

  
. k7 n3 o) e4 o
pLoader->LoadObjectFromFile(

; s- E( ^2 p- f6 w" A- j                CLSID_DirectMusicSegment, //组件的GUID

                    IID_IDirectMusicSegment8, //接口的GUID
4 o! {0 f, h' N' p7 ?: p9 B7 ?
5 _6 \- x6 I% n6 G                    file;//文件名,注意用Unicode

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

  );

1 `4 ~4 R2 ^) K' @: h& f, F3 L$ _1 \从ASCII转换到UNICODE的函数是

比如
! s& F3 u' o2 E( i
const int MAX_FILE_LENGTH=128;

WCHAR UnicodeFile[MAX_FILE_LENGTH];

3 B( F; m. E9 H" q3 _MultiByteToWideChar(
# w) Z6 Z7 U9 X( Q9 r  q: T. Z( l
+ J  S/ n0 x) ^CP_ACP,//ASCII码
& ^" X* ]: ~# n2 F' S. A$ V3 K/ _$ _
' @6 a6 x, K* ^, r   0,//

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

-1,//要转换的字节数,-1表示以’\0’结尾的字符串

- z' e* H  [+ D2 ?3 B                        UnicodeFile,//转换后UNICODE存放的地方
5 G. g1 D: }7 O
MAX_FILE_LENGTH);

7 G+ O/ [$ S: W5 X+ G3 F下面播放mid音乐
. m' v1 E( c! m& j0 ]
% g, f9 ]# ]7 ~pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
3 B7 t7 h8 Y( s( e* m
pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
) E* G. t8 s2 v+ M* G; d
. I8 k# q0 c* u- K+ l8 ^% S$ _! z9 ?pPerf->laySegmentEx(pSeg,//要播放的段

NULL,//保留,必须为NULL
1 e# @6 C+ W. u' @; z4 q
NULL,//pTransiton
5 d* {# [% x% V% x; s; g9 y! i
+ C1 P; ~, G. _) M0,//播放的标志
4 X/ @& B9 ]6 H5 ^
0,//开始的位置
) {* b/ K+ [8 b2 P9 [
, X3 P. B" H% K0 q8 K% x# q5 kNULL,//用与接收段状态的指针,如果不需要,就为NULL

NULL,//使用默认

* {7 b8 N$ Z8 ~! ?4 n- [NULL//默认的AudioPath

3 l- v  y- v( n);

& Q/ t* @8 v/ P/ {* P暂停播放

( g" B# s) _, x" K7 b' M- A( j8 yMUSIC_TIME mtime;//MUSIC_TIME就是一个long类型
9 q( Q: k& c9 \- ^9 `( L; ~
) A0 p1 {' \& l4 o. @" _pPerf->GetTime(NULL, &mtime);//得到暂停的位置
# S3 s; `5 P5 T5 s; i1 m1 l$ H. C* N+ O
停止播放
/ r" X# t6 c$ d1 F% \2 M
6 Q& R, A* h( d; t4 u) B+ k5 IpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止
( w- J# K" r7 w& N
NULL,//段状态

0,//多少时间后停止,0表示立即
' @& m. y9 }- T
" @4 l5 v- c3 V0 A2 q0//标志
+ J7 X8 G' i6 a: c3 z
3 j% E; n( X$ w2 Y2 Q);

从暂停点继续播放
6 C, D: {. x; P4 k$ c
1 C& i4 P! n% c7 \! N$ z/ Q4 B* E7 _pSeg->SetStartPoint(mtime);//播放点

pPerf->laySegmentEx(pSeg,
1 R& b: O* w* p9 S0 V
  \  {& W" y' D! WNULL,

+ K4 F: J: b4 qNULL,

DMUS_SEGF_REFTIME,

, s+ |: P1 i2 a0 {* a2 z0,
! s+ v. [& y# \
5 [; C" q) o) Q$ SNULL,
  X; k$ P7 _$ Q5 l5 O; c- t
NULL,

NULL

! b7 K' a! C" ]' Z7 E, w);
* Z3 f8 O: {7 F0 ]- V" O
pSeg->SetStartPoint(0);

释放DirectMusic

! U! W; o& v( v+ j3 U' b# ^. hpPerf->CloseDown();
6 j0 `1 |1 T+ z7 U/ x( h0 I# J
5 a2 b0 L1 a! \! `$ o" `9 Q: _pSeg->Release();

pPerf->Release();
% N/ X/ E( M$ j' r2 t
# v0 n" \$ A% G9 WpLoader->Release();
: B  ^5 H! x/ I' i3 K- U
6 O* V4 Z6 W) h4 R0 ^2 q: ?  
0 j6 i% i% O4 _  u7 O9 c2 q, n
CoUninitialize();//停止使用COM

" d- m6 W$ G/ ^6 u! M8 L好了,整个过程就是这么简单!

当你理解后,可以自行把上面的代码封装为一个类

8 \) V# R: {( ~" C* D8 T* @) a' q$ }这样,你就可以在你的游戏中实现MID的播放啦!

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

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

8 N& H2 ]( F6 b! P, A2 C最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
9 W7 a8 A2 f; u6 K
3 a9 R( Z2 X2 G程序下载:

  

(参考资料:

; b+ O7 R! [$ W2 f  w+ g. t2 F! H, bWINDOWS游戏编程大师技巧

, _9 L9 O  z0 I) h2 Y+ sMSDN2003的DirectMusic部分)