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

天云上人

播放MIDI音乐——使用DirectMusic
By Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)
/ C8 J- R' t! G5 Y0 d7 M
(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)
; ?" P' {- e+ J$ ?" M
在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分

- A+ A% P7 f1 X- H; c; XDirectMusic主要有下面几个部分组成：

% Q. `# Y! G' S! p2 T4 X* sIDirectMusicLoader8

IDirectMusicPerformance8

+ I% a+ a2 R! Z' ]; i% FIDirectMusicSegment8

IDirectMusicSegmentState8
6 f, V, p+ m& i: C3 `( a; A4 j
你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

. r( ]' R/ B6 [0 wIDirectMusic8
/ s) ^+ X7 `6 T
IDirectMusicLoader8
) `. C+ u; n/ s0 I( B3 w
IDirectMusicPerformance8

IDirectMusicSegment8

; f+ T' j  S, j6 W* H6 ]* I& rAudioPath
7 ~; T3 k- c6 U- L% I5 O. d" _8 J  ^0 x
IDirectMusicSegmentState8

如图:

                                                                                                   

% K+ }, F2 w- A( b/ S+ y1 w+ t  

  
. S6 J4 `2 t8 {$ F+ p2 n1 N
  

  
2 o5 ^+ Q1 K& v- q) H* B8 t% q
IDirectMusicLoader8,加载器。用于加载Mid文件等等
) j: d0 g' P1 {" g3 W5 p% Y4 H
) _+ v- L6 t2 Y, q1 b% ?IDirectMusicPerformance8用来控制DirectMusic的接口

IDirectMusicSegment8音乐数据段，加载音乐后存放的位置
0 C5 J! V% I" c( G% R* L
IDirectMusicSegmentState8 音乐段状态

顺便说一下DLS

/ S4 u8 Z% e5 P# j& _我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题
& h$ [1 `  R1 B! B
DLS全称是DownLoadable Sounds
! X1 n' f1 I; c0 w( `' G; q, @
MSDN中这样解释：

& y5 z  [; n, v# Y. rA 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.
6 b4 T3 `0 a6 k4 r- R+ F) s
4 v, v6 C  W2 |原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
# }6 ?" @6 W) r$ \' s/ {- l
/ A# z% T6 X$ X7 ^; {+ w' M使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）

好了，说了这么多，该开始应用了

IDirectMusicLoader8*  pLoader=NULL;
6 N/ M( E/ _: D4 k; Z7 ]
/ N% Z4 z; D1 k3 QIDirectMusicPerformance8* pPerf=NULL;
  M' ~! q0 {3 k$ w% ]
IDirectMusicSegment8*  pSeg=NULL;
% X' x+ u+ e4 A; u* @; u) H8 V  g
首先，初始化Com
4 u3 n9 K8 ]7 P/ K. x
(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
+ o% B+ F( `# U0 S
HRESULT hr=CoInitialize(NULL);

If(FAILED(hr))
5 ]4 |$ i3 s: s7 F3 w! \- [
{

1 T# j* P8 {" X6 l   处理错误

0 L8 c4 Y; Z$ e1 }}
+ O. N- X& S) i& N! }
) C3 c; i3 G6 S  p* u) b+ l以下为了方便，省了错误处理
1 w9 I% x4 j1 o  M7 d& s- F
% {7 I" A& c/ k* I0 \, o' T下面创建加载器
+ O, k2 R& o, B3 C2 c' U$ d/ P
CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

2 k/ f! Z( U! L5 o. sNULL,    //不是创建集合

" C; N, y" S( bCLSCTX_INPROC,      //创建的环境

IID_IDirectMusicLoader8,    //接口的GUID

(void**)&pLoader);              //被创建的接口指针
- [$ p. q8 N# _3 ?
' B& i( a5 R- o& Y. d# ^9 [8 t创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID

NULL,    //不是创建集合

% |) H) {" }0 `CLSCTX_INPROC,      //创建的环境

- f+ S) V* C$ j3 y1 I* D6 t  {4 v- F! GIID_IDirectMusicPerformance8,   //接口的GUID
! |' S  B/ u1 D# N
% \7 `: \3 g6 c6 O(void**)&pPerf);          //被创建的接口指针
4 y3 ?1 M9 L9 N* d; e! H; R* k
初始化声音通道

$ o0 Z8 O% ^$ ZpPerf->InitAudio(

, [; B8 G4 l$ b    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

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

    hWnd,//窗口句柄
( e# h  r: l2 ~7 L+ y" v3 L
+ w8 ?, |9 ?/ H: k& z; f* k    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
8 i2 E3 E" o$ |2 G  ?# t. }
    64, //音乐通道数

( J2 T# N" @1 [8 u    DMUS_AUDIOF_ALL, //声卡的所有特性

    NULL // DMUS_AUDIOPARAMS对象的指针
1 I* P2 ^4 r: H5 ?4 \, S
  );

好了,初始化Dmusic完成

6 Z- c, @/ V# y9 @/ I7 Z下面读入mid文件
9 k& l2 v6 g# H' C
2 D% ?; F) m4 m2 X) p  

pLoader->LoadObjectFromFile(
+ ^% f9 {( O# m2 t# x+ ~0 U
% ]0 p6 M+ X3 t: v9 a                CLSID_DirectMusicSegment, //组件的GUID
" G( M2 P" d5 @
                    IID_IDirectMusicSegment8, //接口的GUID
3 H% C8 V5 p4 ^: L6 y
' l, g4 v2 w* _                    file;//文件名,注意用Unicode
$ o$ t# o5 T$ y
; O8 I7 }* W, ~, ]6 b) g5 W                   (void**) &pSeg//音乐要装到的段
" C4 ~7 t. e  s5 g. n
. V  |1 s3 `& L2 R7 R; k: ]0 B4 @2 P' [  );

, p' j# q) b4 q. z从ASCII转换到UNICODE的函数是
; N: k3 U5 B" V" s6 D
' D5 f, h' b( i% U比如
' _9 ~: X4 X) _7 f6 j# X
const int MAX_FILE_LENGTH=128;

WCHAR UnicodeFile[MAX_FILE_LENGTH];

MultiByteToWideChar(
& R# {' v: W# ^: Q0 j/ H, H' M
3 G; ^9 O/ H7 T6 BCP_ACP,//ASCII码

   0,//
% k; g* {* `8 y# R  h9 W
$ C% j% H- E! D. }asciifile,//要转换的ascii字符串
! ?8 {9 T" i! ]+ p) u
) L3 p5 j, ]9 p -1,//要转换的字节数,-1表示以’\0’结尾的字符串

  G6 u2 o) W6 A6 j                        UnicodeFile,//转换后UNICODE存放的地方
* C; p# C9 d. a1 K3 Z4 {* |- q6 H
MAX_FILE_LENGTH);
5 D, |9 p! C" D
& f, J1 ]; ?% z# z0 O  c  R下面播放mid音乐
0 R: l* r+ t' \8 z) Q
pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限

pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据
4 O! |0 i" u( z9 h. V
pPerf->laySegmentEx(pSeg,//要播放的段

4 @- Y$ X- T$ F! B6 p6 H7 X" JNULL,//保留,必须为NULL
0 [9 R% A6 I7 }6 ?3 j; v& [) N/ J) |
NULL,//pTransiton

0,//播放的标志

0,//开始的位置

/ v  j* d. Z' r" ]* y5 O& BNULL,//用与接收段状态的指针,如果不需要,就为NULL

, C- n9 e; t) C( c$ d4 N) |NULL,//使用默认
# r" Q4 X, l9 S- {
& }8 j& m8 a. M: xNULL//默认的AudioPath

3 t9 ^6 s, d$ k  p6 L) \8 t: J& i& |9 R3 p);

暂停播放

' `/ G  V* b% @: N2 ZMUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

pPerf->GetTime(NULL, &mtime);//得到暂停的位置

停止播放

$ s3 d  ?7 W: v& ?3 h% fpPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

+ Q0 j/ k* d6 gNULL,//段状态

0,//多少时间后停止,0表示立即
* b& f/ N* F5 E
0//标志
1 Q  P9 ^* I7 D- d/ |: |
);
1 W) W) C* Z3 F2 m; |# q
从暂停点继续播放
9 w6 ~2 d. I7 y+ I- Y0 s) q, L/ m. W% K1 z
pSeg->SetStartPoint(mtime);//播放点
& ~: e9 C* L) K" G) J4 q1 L+ R
* H; p9 |* ^! I& DpPerf->laySegmentEx(pSeg,
' e# x3 x( o. S
5 ^2 o1 c4 X  UNULL,

NULL,

DMUS_SEGF_REFTIME,
9 O6 o* x( x2 p1 N' T) S
8 D" S7 p# ^- q. K% H0,
0 Q% V3 s4 j$ k
" E7 Y. M5 R! D  f0 `NULL,
, P, J% [3 U, E/ c3 A& D3 ^
NULL,
$ m6 U& `. ]6 I( p: C& X
  V8 J$ \8 _; ZNULL
' ?  i9 N9 J2 R/ E# J% Z  V# U
1 V; x3 ^5 V! s# o- j9 r);
/ r% e0 c! C+ K. P$ K3 f
& |: y( x2 M: {4 i/ Z4 WpSeg->SetStartPoint(0);
' w2 H2 \+ L' _3 m2 n# }  _
; U. I" v& L6 H) L" w: r- C释放DirectMusic
% e9 @/ L5 F  ~
% M  u& M, y3 O; P, C) C3 m& ZpPerf->CloseDown();

0 Z) d6 L1 [; P0 d7 V+ DpSeg->Release();

pPerf->Release();
1 M0 W- u& x9 z/ @
pLoader->Release();
! l4 d; I: U9 G
  
2 I" U  k( X; V7 T% i. a( q
- h& k1 ?4 A+ Q% L  s8 `. a3 }CoUninitialize();//停止使用COM
: R) j/ N) Q$ ^
好了,整个过程就是这么简单!
* t! V2 n+ H& S& S3 j8 B
% A- b, z6 E4 b: R' l. [当你理解后,可以自行把上面的代码封装为一个类
- o( b  p: h& M7 M8 x4 H
这样,你就可以在你的游戏中实现MID的播放啦!

当然,播放mid只是DirectMusic功能中很小的一部分
( F7 }' M- l/ G* g" n1 `2 c& R. p
& X. ?' h+ @' P2 _/ D6 M" i! `2 F% H9 o它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!
5 @; Z% n; {4 t8 n; C/ Q
最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
: L0 T1 ]1 ~' i
8 f# T4 q" O2 {% \8 B* |$ R程序下载:

- m% q8 I# H0 q$ u* X, F# B$ {  

" |! w) c! M2 u5 b(参考资料:

/ Y$ d2 c2 g5 y9 C" w2 EWINDOWS游戏编程大师技巧
6 j! V/ s8 }' W# w7 c
MSDN2003的DirectMusic部分)