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

天云上人

播放MIDI音乐——使用DirectMusic
% N3 z, g, y' ^' eBy Kylinx,2003-5-15,E-mail:game-diy@163.com
(转载请保证文档的完整性)

1 K( S8 {8 a! Y& y8 [  S(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)

在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
5 m; \7 X8 M6 _1 ^, w
* {7 v9 e! D: ]0 Y/ kDirectMusic主要有下面几个部分组成：

: P& j0 S1 S7 }' U! k2 mIDirectMusicLoader8

# a! ]9 D. j& hIDirectMusicPerformance8

4 ]+ m$ C. [8 f5 l) f# O; [IDirectMusicSegment8

1 v" k: [, C' I; c$ t  sIDirectMusicSegmentState8
6 \% ?- H( |3 r
你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

IDirectMusic8

+ c! E' ?# P( S. VIDirectMusicLoader8
& d9 f7 a: L4 V  H
IDirectMusicPerformance8

IDirectMusicSegment8
% A( e. P9 v3 Q5 v/ [
AudioPath

IDirectMusicSegmentState8
9 s, p& H/ M7 q1 K
( X- D" M) Q4 `! f如图:
; n3 t: H# y; I% z, c0 i/ Z
                                                                                                   

  
- c8 P# X* m2 h2 E0 ~
) _  D! N. c2 x- I; `$ y* G  

  

  

" q3 X) H9 e3 j1 @& GIDirectMusicLoader8,加载器。用于加载Mid文件等等

IDirectMusicPerformance8用来控制DirectMusic的接口
& }" T' E- q# ~' D
IDirectMusicSegment8音乐数据段，加载音乐后存放的位置
7 f" }$ @2 T+ F% v* U! [
IDirectMusicSegmentState8 音乐段状态
5 Q( U' r' q5 Q& `  a" Q
顺便说一下DLS

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

& i+ X7 `% X$ A; ?* H# TDLS全称是DownLoadable Sounds

: V9 E- G7 n% ]. dMSDN中这样解释：

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.
% ]0 v- i) _  i( `) W" H
# P5 Q3 z2 S# [. ?' ~% ]原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
* \& |/ Y9 y2 r) M! Y
" F" Y$ u+ p3 x) e使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
) l5 z; Q- g9 F7 n
8 d% R0 o: Z6 h8 i) k  z好了，说了这么多，该开始应用了

, u& K! O' Y9 i' r4 ?. V  y' ]IDirectMusicLoader8*  pLoader=NULL;
% Z% a9 y$ e3 w  Y
5 f/ ?6 A2 \) ]/ dIDirectMusicPerformance8* pPerf=NULL;
0 g2 O  i( v( ?; m: l: {, W
5 [& l8 [8 p; x" c, ~: r9 q7 A6 [IDirectMusicSegment8*  pSeg=NULL;

首先，初始化Com
7 ^! W  H$ x8 K8 J' N6 T/ ~0 ^
3 h6 G0 A; G9 R( w( U  S5 I& z; f: }(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
0 k, o7 y0 o5 W$ H, \
9 S/ `, }' d' d6 q% v6 mHRESULT hr=CoInitialize(NULL);
  w5 T1 N4 _. L
If(FAILED(hr))

{
( b% ?' u9 t5 j% ]* `
   处理错误
: b% d. s# [9 R
}

以下为了方便，省了错误处理
: ^5 z- P# ^& R
下面创建加载器
* ?  f! u) f1 h5 y( H
CoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
; d6 r. w; Q1 C! V8 p% }
NULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicLoader8,    //接口的GUID

- d0 M& ~" g7 ^% {7 o7 t1 a' ?(void**)&pLoader);              //被创建的接口指针
6 S* M% V8 [8 R! t
创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
- Y6 r% C" P* U. G. c
NULL,    //不是创建集合

8 N  ]0 K  B1 N: u' {CLSCTX_INPROC,      //创建的环境
  g5 x/ M7 B+ g3 U4 m
$ W8 s+ n% N+ _3 k. s7 PIID_IDirectMusicPerformance8,   //接口的GUID

4 B( b* ^- U: }7 Q(void**)&pPerf);          //被创建的接口指针
; u2 K) l8 ]5 p4 P+ I
. U" j3 z# K9 I6 q* p初始化声音通道

pPerf->InitAudio(
, a& Q* G- _6 |/ u
1 J# a) t7 R- s9 J% F' P  K& `    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行

    NULL,//DirectSound对象的指针，同上
. v5 J9 P1 [, x- @
( s8 P0 h1 |" ^2 M. W# D: ~+ E    hWnd,//窗口句柄
8 i* T6 |" Y9 t
    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响
: o5 L" X- U: r' S: g
- I; |& N. `8 l/ m    64, //音乐通道数

    DMUS_AUDIOF_ALL, //声卡的所有特性
9 r0 b/ J+ Z, q5 r* k9 }/ p: x2 }- h
5 d2 h6 C7 y9 r6 d    NULL // DMUS_AUDIOPARAMS对象的指针
: J! b  Y) Y" W: f( g0 o
  );

好了,初始化Dmusic完成
: `& `( f! s' B# X
  H2 @) [1 q3 t0 J, W/ E下面读入mid文件

% U6 m+ N, ^8 f: n% j8 O  

3 F/ L6 C9 O+ \' GpLoader->LoadObjectFromFile(

" ?# A/ `. C- K8 d% [                CLSID_DirectMusicSegment, //组件的GUID
2 R0 C1 w) s7 o9 o) G3 I8 N6 t( L
                    IID_IDirectMusicSegment8, //接口的GUID
8 f' z( ^! g5 Z' Q# ?+ h+ v% z
                    file;//文件名,注意用Unicode
' F  L9 W! H) T! p
                   (void**) &pSeg//音乐要装到的段
- J) j$ q' m- Q. s; k1 _
8 ], m& g- e5 r* n- ~  );
  f, @6 {. P; c) K5 L
从ASCII转换到UNICODE的函数是

+ w- h# W$ g. P+ N/ \0 L比如
3 p' M" N( n5 s5 @5 y
const int MAX_FILE_LENGTH=128;
) ^/ l, x2 s! c2 g2 S7 n+ P
' @3 t; Z) d# E& d" aWCHAR UnicodeFile[MAX_FILE_LENGTH];
# i$ |0 [! N( h, F9 h7 F
MultiByteToWideChar(

CP_ACP,//ASCII码

   0,//

/ ], W% {3 i: U$ X, |. u9 sasciifile,//要转换的ascii字符串

" U8 W' @& Y0 d. b* ? -1,//要转换的字节数,-1表示以’\0’结尾的字符串

                        UnicodeFile,//转换后UNICODE存放的地方

" \1 F! x) L2 d( K0 OMAX_FILE_LENGTH);
7 J# @2 k0 E; W
下面播放mid音乐

pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
6 T) o) F# s3 b, q8 R! P
pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

pPerf->laySegmentEx(pSeg,//要播放的段
  W9 [! {! G/ H5 Z! G2 y
/ \0 k0 g' M  {NULL,//保留,必须为NULL

NULL,//pTransiton

* i, e- j& n. [8 k* N0,//播放的标志
$ h, I0 q5 E+ x& ?1 W3 |& d
0,//开始的位置
* X2 O; y. l+ N8 Z' S
NULL,//用与接收段状态的指针,如果不需要,就为NULL
8 g4 I" A  S& w7 S& K
NULL,//使用默认

NULL//默认的AudioPath
/ u; C6 @3 Z  K
! h( H7 r, y# V; b2 a3 p);

: |$ h1 k; J8 T1 y# H0 ^暂停播放
; X% C9 L/ B; e$ x) w7 p/ t. o
MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型
. c% H( w5 x, d4 Z% L: w8 i/ C2 L
pPerf->GetTime(NULL, &mtime);//得到暂停的位置
9 B. t- A7 Z! X; b! J: L6 G: Z
5 H. q  {6 Z7 E9 H- Q2 N停止播放
4 v& m# _2 J- O) g  p& d
pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止

NULL,//段状态
- ~* O! A- O; j
9 ~6 b1 x8 ?) N" J9 s0,//多少时间后停止,0表示立即

0//标志

: F% E* \3 j- _3 N8 L$ m0 g& F# H);
; p/ d) Y' a" k" T- d0 U1 S. F
" C- x, A7 D& \6 D( j5 E, U" y7 |从暂停点继续播放

# b1 `1 k, z' G3 R  @pSeg->SetStartPoint(mtime);//播放点
# a8 N. T1 c8 s  F
1 O% ]- V$ M' G9 q7 _( x" h0 n5 lpPerf->laySegmentEx(pSeg,
: q/ H7 \+ T6 G8 R5 R! k2 `% Z, I
NULL,
( ]& E/ ?* g& m* y( W' x
NULL,

) b" Q" ], ?5 e/ u- yDMUS_SEGF_REFTIME,
' E% o2 \6 o- H( ?9 {! n5 f
( N6 ~1 l1 N8 w, |7 r! o" t0,
) d# c$ i! `# a
NULL,

NULL,

NULL

);
9 N6 \' C" O2 I' ]: b) `
9 D" n2 N4 @( {2 b$ apSeg->SetStartPoint(0);

+ g* f4 S, |: R; U$ j& v释放DirectMusic
$ w* J5 H% u# a6 L+ u2 |( P
3 V; H, c0 [, B& c4 RpPerf->CloseDown();

pSeg->Release();

0 {- U0 F" ]6 u& C% O0 rpPerf->Release();
- K) u6 u! b; \/ k' j
pLoader->Release();
+ Y4 s( B4 y& T' C. w# ?
& ~* P) F* W5 R  q! w  

9 N. P8 g$ `) L$ _CoUninitialize();//停止使用COM
$ ?. K8 e6 Q5 N
& O# K: }- Z4 H! P% E4 i4 b2 A好了,整个过程就是这么简单!
5 l; D7 s) a8 j, K" M# R6 ?
$ L# x: S1 o& c9 g9 b" q当你理解后,可以自行把上面的代码封装为一个类
- [  }9 O. o- q; }  O. k! Y
4 o; Z- h2 P: S这样,你就可以在你的游戏中实现MID的播放啦!

当然,播放mid只是DirectMusic功能中很小的一部分
% ?! i9 t) G- a4 |( q+ _
它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!

. s& u9 l( g& N! O最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
+ \  [( O* A+ H6 |
程序下载:
( i* h% B3 K) s  |) X8 I
7 C, S: Q/ h& E, ?6 Q& R  

(参考资料:

WINDOWS游戏编程大师技巧

MSDN2003的DirectMusic部分)