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

天云上人

播放MIDI音乐——使用DirectMusic
By Kylinx,2003-5-15,E-mail:game-diy@163.com
9 a9 a; T/ p# k& {(转载请保证文档的完整性)
9 h; y0 b0 ]2 _: Q4 v
- n) L8 v& a4 O( n9 g/ w(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)
4 D  X7 e% P# E7 n+ r
  |3 e# E* [( p% `) d6 c在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
+ Z. {* v0 q7 Z* G
( @( |9 N' c, T& hDirectMusic主要有下面几个部分组成：
$ M7 i7 l4 @' o- L: u9 W
IDirectMusicLoader8

4 Y; C0 {, y0 x7 SIDirectMusicPerformance8

* S6 f" f7 F8 @/ AIDirectMusicSegment8
5 V* x6 ~5 l& L, |6 J6 ~
IDirectMusicSegmentState8
6 k  U9 _: ]) }
你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
4 L1 p( `; d9 g6 M7 x+ f- N; v
IDirectMusic8

IDirectMusicLoader8
/ t. C# R- r5 I
IDirectMusicPerformance8

IDirectMusicSegment8

AudioPath
. f' K0 {* D7 u! G8 ?
IDirectMusicSegmentState8
& E# u1 X. [, e: o. {3 V- n8 u! d
如图:
4 L, f1 }2 c0 `% k  j  [" p
                                                                                                   

% {: l  Y1 h4 N# G, C; d0 m  

  
/ U) ~0 [: ^* \- I
  
# T5 |% B0 h& K5 G
  
+ _* Z& R2 n2 X; z% h+ X
IDirectMusicLoader8,加载器。用于加载Mid文件等等
# f# y5 k) R, `0 l7 \
1 N4 Q# s4 v; E+ FIDirectMusicPerformance8用来控制DirectMusic的接口

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

IDirectMusicSegmentState8 音乐段状态
, M( m7 a  G* i2 {# F! k
9 _4 Q0 X8 H/ o6 ^8 ^' w' i顺便说一下DLS

我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
$ }2 I8 V" Z; t
. t" E+ [7 q  w6 jDLS全称是DownLoadable Sounds
" y. l5 I# ~9 Q( R# G
MSDN中这样解释：
% n6 r/ x& U. {. q
7 g# W/ A9 i6 p) PA 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中
! i3 R) e& x; q1 p3 ~/ f
: p% X3 I! [" Z0 e使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
& Z% }, _: c7 i+ {& e
好了，说了这么多，该开始应用了
/ J: V' G" _2 D* f, \
5 g% s* n, z5 E: Y! u: V' O5 B- nIDirectMusicLoader8*  pLoader=NULL;
: H: ]$ k0 Y% ~' Z- @
IDirectMusicPerformance8* pPerf=NULL;
6 j% V: W) v3 L: k
IDirectMusicSegment8*  pSeg=NULL;

8 z. J# g! y$ S; g  v首先，初始化Com
& Y. l. V5 j/ |' A+ p! |8 y
4 X- H( L! \5 Z(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
' u9 ?: [% Y* A
HRESULT hr=CoInitialize(NULL);

: ~9 H, C0 y& {& MIf(FAILED(hr))

{
& s: N2 U( O  ^* [# d+ k
   处理错误
5 M- L* M2 k0 s# ]  C
+ N' D7 @) r% X}

1 i/ t1 `* S/ }" z8 ~" I2 F4 V以下为了方便，省了错误处理

下面创建加载器
& i3 R7 U* a% u" k7 }
CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
1 ~- f! N0 ^8 V' p. l/ m
# M/ T! r' f0 a, F  gNULL,    //不是创建集合

! F+ K3 V6 d3 [& s+ H2 ]CLSCTX_INPROC,      //创建的环境
% X  C. {6 h% J; J, d* f
IID_IDirectMusicLoader8,    //接口的GUID
. o9 R: M3 Q! {: |
(void**)&pLoader);              //被创建的接口指针
1 q+ O' q. ?7 A" C
创建“表演”，（控制器）
' G3 O4 f8 C; ]
CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID

# f+ n* c2 e" e/ |' Y- M$ zNULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicPerformance8,   //接口的GUID
. P- k  h5 a8 D5 k7 I# f% \4 W
(void**)&pPerf);          //被创建的接口指针

初始化声音通道

pPerf->InitAudio(
" J" v  Z- X) x( e0 w0 g
# J; i1 [! Y: @* f% J    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
" R7 n1 Q& O3 t
% c, E- F+ G, \& c0 j& k    NULL,//DirectSound对象的指针，同上
, ~% ]5 R6 Y  H' K5 V
( B2 `5 i$ c5 s. I/ _# j/ i1 ?    hWnd,//窗口句柄
4 s0 C* q  @8 i& C
    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

    64, //音乐通道数

    DMUS_AUDIOF_ALL, //声卡的所有特性
* o2 _# K- U: X7 g: ]
    NULL // DMUS_AUDIOPARAMS对象的指针

, \, D  B- v$ l  \  `- i  );
7 [# D, j- Y5 s* ?9 c
3 C4 [7 L( E, a/ ~7 r+ _好了,初始化Dmusic完成
6 G  p3 v3 S, z5 ~2 w
下面读入mid文件
% @/ v; @# |9 o4 b: |. l3 j% l: X
  

pLoader->LoadObjectFromFile(
- Z' N3 P: R( a0 K( r
                CLSID_DirectMusicSegment, //组件的GUID

                    IID_IDirectMusicSegment8, //接口的GUID

& W+ H+ i( V. _' E: [                    file;//文件名,注意用Unicode
) g0 e! Z$ Y/ a5 j6 W" m
                   (void**) &pSeg//音乐要装到的段

3 \( f9 {- |% c( ]. h! {/ k  );
9 g# m, v' }. E" X& h3 p
从ASCII转换到UNICODE的函数是
9 k$ f2 X/ }8 J; t' ?% b5 m
7 C0 O+ U" b6 x比如
/ Y( g/ `/ b: o4 l. h# u5 k
' l" o( I0 j. m- {3 `const int MAX_FILE_LENGTH=128;
" P% J9 p' f5 U# Y+ A
: u" P9 C2 [! U& f" E% \& T; M) U$ uWCHAR UnicodeFile[MAX_FILE_LENGTH];

, z! S9 m0 E2 w# e* bMultiByteToWideChar(
# Q/ \5 X, i/ D# ~- u  Q
CP_ACP,//ASCII码

   0,//
4 {7 h  l5 G# M
asciifile,//要转换的ascii字符串

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

# o" |3 N8 i. N3 [5 u                        UnicodeFile,//转换后UNICODE存放的地方
2 H" j: b# t; q$ b: c
MAX_FILE_LENGTH);
2 M* _; U- K4 O% [: h
$ c4 i9 p% C8 I' {9 ~6 D下面播放mid音乐
2 f/ k$ }+ c, T3 ?4 t
pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
1 a. b. q/ m7 n/ b
pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
7 E5 p# ]; Q1 ^1 Q7 I; }
pPerf->laySegmentEx(pSeg,//要播放的段

0 o6 K: `6 f4 `3 r& zNULL,//保留,必须为NULL

NULL,//pTransiton

# W+ |$ w* E$ ^/ T) J0,//播放的标志
! a6 T* n& L+ G7 q
0,//开始的位置

: v2 O* }2 s4 m2 t8 ENULL,//用与接收段状态的指针,如果不需要,就为NULL
* u1 v9 Y. U6 s: e
+ t. e6 f4 C0 Q# F5 B8 ~NULL,//使用默认
8 U' N4 u& u$ L3 R
/ {+ {2 X, I& O( D* p8 D5 K* QNULL//默认的AudioPath
6 A. Q2 w7 I2 ~" ~. y; T" b. r0 I
6 c4 k- b( I4 [9 t3 x);

暂停播放

MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型
! u3 N& O8 g; A  c4 g# ?+ D
, H5 i$ Q3 C- V3 r( m* dpPerf->GetTime(NULL, &mtime);//得到暂停的位置

, V1 ?4 W9 C+ f! N: c5 `停止播放
$ x/ x1 Y' J0 f  x, c
pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止
0 t4 ^% H' X9 X% S3 ^3 M  n
NULL,//段状态

( s" ~, e! ~* O* V: O* l! b3 J0,//多少时间后停止,0表示立即
% _- ?9 N- x1 \2 `8 G- x' y) z
0 E; O# ]/ h2 U0//标志

);

从暂停点继续播放

pSeg->SetStartPoint(mtime);//播放点
4 D, L" V; F: o/ c- D1 w
1 G2 ?% q7 Z6 X4 NpPerf->laySegmentEx(pSeg,

5 a8 i  e/ }+ ^NULL,
) i6 w( S9 y2 @7 o, C4 n
NULL,

2 W/ W1 z* w# h$ Z7 B; TDMUS_SEGF_REFTIME,
( D( o; v& C4 F9 P! S( ?
0,
; C! I4 l4 Q. h$ g' F) Q6 y
; F  V/ P; ^: k3 p7 O+ G+ GNULL,

- _8 y, D' Q; u( E: k4 |' b$ N1 D- s( ^NULL,
1 ]) K7 z, ]! |5 H& @
NULL
& M9 v4 j  V& e# X! t
);

pSeg->SetStartPoint(0);

+ X& w9 p1 L4 g0 F8 d释放DirectMusic

pPerf->CloseDown();

$ q2 F* [) t- R+ o: g4 S1 apSeg->Release();
6 n0 g; j- G5 Q* b, Q
pPerf->Release();

& w: [2 n3 t0 ?# MpLoader->Release();

  
+ m4 x) ~4 k* W* ?
CoUninitialize();//停止使用COM

好了,整个过程就是这么简单!
7 B+ S* M" e$ f5 {
& y7 P: h) r! n+ k0 n4 _) m当你理解后,可以自行把上面的代码封装为一个类
9 o2 }, W8 F# x
这样,你就可以在你的游戏中实现MID的播放啦!

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

; h4 |0 M  h7 \& N: m2 L( O- V它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!

2 W0 z9 E2 {9 e9 R最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

程序下载:
3 z) I4 v; E/ l
4 t' L6 c: B1 b: w5 j) {9 Z# L% n  
8 ]) g( ?' K# d# K. ]
. `" v. b; z4 T& b/ ~(参考资料:
5 b- g8 F! |- C3 Q8 S
& R0 h) V$ t/ B$ p, wWINDOWS游戏编程大师技巧
8 `/ Z" Q! g+ q3 ?, Z
MSDN2003的DirectMusic部分)