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

天云上人

播放MIDI音乐——使用DirectMusic
By Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)
8 F# y- N# s1 \3 ?
(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

  H7 r0 `+ k/ F( f在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
3 I; A6 {: N1 p9 f: k& ]9 a
DirectMusic主要有下面几个部分组成：
1 Z9 p' o2 c5 O8 |
IDirectMusicLoader8
. [6 y5 s! |0 n3 U" s
% I4 q5 X# n( U3 @6 g( d$ {IDirectMusicPerformance8
- X( }. ]7 H9 ?" q% |' a2 I. `
3 q, c$ h; t1 m9 H5 FIDirectMusicSegment8

% v3 e% Q+ H3 E$ \. P$ eIDirectMusicSegmentState8
- r( U; z+ c4 `. `! F
  ?4 n# m- g' g: Q) ]0 ?, G3 I$ U你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

IDirectMusic8
/ q3 J* f4 S1 t& }" J3 [
# ?- c) v. Q6 P. ?, kIDirectMusicLoader8
3 k6 y% h! y8 R, [3 ]6 N# V
IDirectMusicPerformance8
# s0 t: S( s0 v1 ]5 _
5 Z2 z- _; c2 `* e) R: jIDirectMusicSegment8
* j/ r7 V9 p5 K6 r/ u+ s; D
/ D) z# j/ N$ MAudioPath
6 B" s- x) p) [
( n5 F" s% M( O- [, J7 BIDirectMusicSegmentState8

9 I$ W4 k) y# V- F; R如图:

                                                                                                   
9 U2 e3 `; O( B. n! u4 j0 ~1 W
  

4 d3 }5 m0 W# H; j  Z; e7 f  
) u5 w$ p$ F9 W
  

  

IDirectMusicLoader8,加载器。用于加载Mid文件等等
' E+ k  _9 \% |
5 a# a1 k& P& C' ?0 `$ [. hIDirectMusicPerformance8用来控制DirectMusic的接口
' Q, S8 f0 m6 y  K. Z- q
IDirectMusicSegment8音乐数据段，加载音乐后存放的位置

: c# V9 a" J  }IDirectMusicSegmentState8 音乐段状态

顺便说一下DLS

) X; A; f$ L9 o8 U7 f% H( G0 v我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题

. a8 ^/ H& s3 KDLS全称是DownLoadable Sounds
/ ]) E9 v) ?6 b5 H, ?2 X1 ?; e/ W
# `! i+ H0 X5 SMSDN中这样解释：

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.
7 p$ `- f) Y# ?2 F
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中

8 Y1 q& o7 E/ V! B! ?+ L使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
! v6 J# }  M. Z7 p) D: C
好了，说了这么多，该开始应用了

. Y' S$ X- i) X7 u- k+ IIDirectMusicLoader8*  pLoader=NULL;

2 Q4 R) v3 H5 c& _8 Q  AIDirectMusicPerformance8* pPerf=NULL;
# R& q5 q4 n% S3 c0 y9 K. w
5 L3 t' A9 U4 C) x, h, V# OIDirectMusicSegment8*  pSeg=NULL;

9 @; u8 v) S) a1 r( P" [首先，初始化Com

(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
/ Z; D7 ^( \7 h7 k- N* |8 y
HRESULT hr=CoInitialize(NULL);
1 b# ?1 X, x" Q
If(FAILED(hr))

{
4 ^3 K+ A& X% R: R9 H; M
! _  }  I+ R+ v, R- n   处理错误

}

; @( {7 d) @$ ~. E$ x3 u& u以下为了方便，省了错误处理
+ R4 Y( h* l9 M  N6 H3 L0 q
下面创建加载器

CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

NULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicLoader8,    //接口的GUID
  S! L; ]- P7 s5 x$ q
(void**)&pLoader);              //被创建的接口指针

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

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
! Z6 \. |# b& g" f9 U. r5 @
! L7 x( w$ C2 ZNULL,    //不是创建集合

# e* j2 n6 ~" n0 }+ aCLSCTX_INPROC,      //创建的环境
- e: v) E- c1 y( f" r! j
0 L- W$ p$ P0 V" r) z  x1 v" mIID_IDirectMusicPerformance8,   //接口的GUID
. N+ b  i% k7 X7 a( s* `8 }* Y
(void**)&pPerf);          //被创建的接口指针
6 u8 \2 E/ }6 K$ ]
初始化声音通道
& Q" v0 U" C2 x5 W" n% i+ @" c% R
pPerf->InitAudio(
% h( V2 H3 l7 N7 c6 V
    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

    NULL,//DirectSound对象的指针，同上
6 t8 \, G. S! {2 d; J' ]6 t
    hWnd,//窗口句柄

    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
+ b+ p. B8 Z* r
* K2 Z( W! i. t" j  {9 D& B    64, //音乐通道数
. h( D6 Z+ G! k) a' w+ h
3 q3 c3 F5 I2 P1 j/ q+ P& i. L    DMUS_AUDIOF_ALL, //声卡的所有特性

    NULL // DMUS_AUDIOPARAMS对象的指针

  );

好了,初始化Dmusic完成

- N8 H& e! |- {) s0 g, g% M下面读入mid文件

, u' @" n4 E- o2 v! t$ {9 O6 m# W, q/ L  

pLoader->LoadObjectFromFile(
, O+ W9 J& c  j0 L
                CLSID_DirectMusicSegment, //组件的GUID

6 r% M& B% j' O, z                    IID_IDirectMusicSegment8, //接口的GUID
, D) Q3 k* l  |
: Y5 g8 F# [+ M1 v5 g                    file;//文件名,注意用Unicode
& K+ d0 N4 D; _6 ~
                   (void**) &pSeg//音乐要装到的段

  );

从ASCII转换到UNICODE的函数是
0 j( I. @/ \4 K- n6 ?" f
; q1 M, R7 t# ^  |比如

& a3 c6 _( T8 N. G1 Sconst int MAX_FILE_LENGTH=128;

WCHAR UnicodeFile[MAX_FILE_LENGTH];
6 e  n$ C0 J8 ?; v+ M3 r+ V1 }: h0 Z* b
MultiByteToWideChar(

# O" w- v2 G- S' d( g( B+ gCP_ACP,//ASCII码
: C  s* H; V" F8 C% t6 p0 F5 s
   0,//
$ v7 H$ F0 k# T  s" m' L
3 _4 }$ ]& y; o( o# casciifile,//要转换的ascii字符串
6 x" |. I! e' a+ ^. Q) r+ u$ Y+ \
6 c8 \4 G2 O5 ?" e4 o/ b -1,//要转换的字节数,-1表示以’\0’结尾的字符串

6 k2 R% y$ w4 }( a                        UnicodeFile,//转换后UNICODE存放的地方

0 z0 T' ?1 g' IMAX_FILE_LENGTH);
  D7 A( n2 c0 i5 S+ o3 ]
  V# A1 N% S0 @" ~下面播放mid音乐

2 \, s) S6 I0 m; N2 F! ^0 Y' KpSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
! S0 N& Z, J6 w. E; N' D( T
7 j  [# D' J  O& F0 bpSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

; a3 h+ w4 u; \4 SpPerf->laySegmentEx(pSeg,//要播放的段
$ u3 g% t: ^/ f/ K+ Q2 O& l" l0 \, [
! T7 k# Y, W) ]* UNULL,//保留,必须为NULL

7 m/ ^- N) J. U( ANULL,//pTransiton

3 \% B* @) i) u7 a. i: K4 [0,//播放的标志

% J  f" S' f: ?9 U0,//开始的位置

: X: d* ^8 Z; t4 V" cNULL,//用与接收段状态的指针,如果不需要,就为NULL

; I2 d& ~+ w% N- A/ @2 ?, gNULL,//使用默认
7 o  z# d& e+ d0 z
NULL//默认的AudioPath

);
9 k) W) a) g; F+ v/ I0 L' E
3 a1 r: v, g* m* e8 o5 n4 I暂停播放

1 o7 U4 b$ N2 g2 O7 \MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

0 s0 }! @+ J; y8 [  n1 x  g. jpPerf->GetTime(NULL, &mtime);//得到暂停的位置

停止播放

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

' G" ~+ ^/ h4 r8 E" U+ d3 vNULL,//段状态
( K" w. e$ S( A1 X" c9 v3 S$ S
9 t* Y/ _" m2 u- Q0,//多少时间后停止,0表示立即
- H3 t# l* x  i. o, l4 t
4 L* R8 N- a$ B. u8 g7 _0//标志
: M0 G$ ?& [. \6 H( A" W
% g" a. P- E3 ^* A3 O+ \);
" m: Q& r+ C+ C
从暂停点继续播放
7 |) v* L, e6 O- a, ?! F% _; g) Z
, [7 q6 c+ @$ I' FpSeg->SetStartPoint(mtime);//播放点

pPerf->laySegmentEx(pSeg,
9 T/ p* K0 A' k3 N% L  H
; O* \+ i3 ]# @7 n- `NULL,
* F3 e8 B! u( `+ _9 @  V8 o
NULL,
1 |& P7 X' w* F, Q7 ]2 j
# r6 ~7 j9 H; x1 u# o0 wDMUS_SEGF_REFTIME,

0,

NULL,
4 `' X8 A4 S) [8 C3 V* E
NULL,

# g" [: V* M1 ]0 _3 yNULL
" d  m' F& Z' i! ?. B
);

pSeg->SetStartPoint(0);

释放DirectMusic
* f5 k/ M: J, I( T+ j
pPerf->CloseDown();
/ q* l8 |" T9 Q8 s2 ~# n, s
pSeg->Release();
1 r- d( d) ~. C; O! Z: }1 A
9 k! g6 f) t, E4 }8 K# R) ~pPerf->Release();

pLoader->Release();

- f: G1 x$ T/ B5 y9 _  
+ R' Y) I* B4 S" f. h* W) z0 Y
# s/ `4 Z& Q# H- A+ G! O9 vCoUninitialize();//停止使用COM
( m- B0 f5 P; \
: x- f5 p: b0 _7 J4 |+ E  v7 o好了,整个过程就是这么简单!

+ A6 h1 n- L* c$ k2 t* s当你理解后,可以自行把上面的代码封装为一个类
. c- H8 [7 q$ P
这样,你就可以在你的游戏中实现MID的播放啦!

+ E. R4 x9 g2 k5 b' I# B& W当然,播放mid只是DirectMusic功能中很小的一部分

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

# B+ E) x( V* W- w2 a! o最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
# ?! k$ G6 X2 P7 d2 L2 \
程序下载:

  
7 L  }+ `/ `& Z: k
7 Q, G5 T/ c1 F5 d3 q7 v  t6 w(参考资料:

WINDOWS游戏编程大师技巧
' j; e- [% T/ V) ?
* C% v- B3 Z/ f% y8 ZMSDN2003的DirectMusic部分)