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

天云上人

播放MIDI音乐——使用DirectMusic
$ Y( B6 f. ^( eBy Kylinx,2003-5-15,E-mail:game-diy@163.com
- V% [' e0 H* e. W2 q, d- x- ](转载请保证文档的完整性)
! R9 \8 q) n( k2 m1 S- V
5 L' @5 s6 D; W(本文对象：DirectMusic初学者，想快速知道使用DirectMusic播放音乐的人)
. V' d! a7 c' F: B+ w" ?
在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分

+ r2 g$ I2 L+ n8 [DirectMusic主要有下面几个部分组成：
  g2 V) \# ~' s- l
9 ~5 E) ]1 k2 i: i- H; z7 `IDirectMusicLoader8

IDirectMusicPerformance8

6 U( g$ p. ]8 k- T  _, iIDirectMusicSegment8
8 Q% }6 u1 X* H) r" D7 k
, E7 a5 z8 t4 Y. N( r! nIDirectMusicSegmentState8
4 z. N% n" a2 o. g
$ _2 X6 M# P4 J0 F" |你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现

3 m$ s* ?& }" cIDirectMusic8

+ b+ U( [$ P( a- ]IDirectMusicLoader8
" F+ b. L  S1 L1 _0 |) V
IDirectMusicPerformance8

IDirectMusicSegment8

8 |" {- u8 b& E4 f: WAudioPath
5 {3 m( T0 g  a& C+ d9 q( S
( j8 W/ x9 x( w# R- X% MIDirectMusicSegmentState8
# ?& [8 p, t' h* u; K
如图:
3 C& I* Z' ?8 F( k/ R' w+ @' R  {& |5 [
                                                                                                   
) o! W6 C$ o8 g) K- V6 G% D. O. W
  

  
/ G* k$ J3 F# _. P& y) Q
- ~( j! ~, Y3 S" |' t, ^  

0 O* ?6 C, ~3 @- X5 E7 y( f9 R  

1 `7 x: y6 Y. L  G5 m1 q6 `IDirectMusicLoader8,加载器。用于加载Mid文件等等
- X, G' L' u) S) b! m0 k
! S& u2 I4 ]% y! Y) DIDirectMusicPerformance8用来控制DirectMusic的接口

* e& T/ P$ c, x8 b& F, {+ D! aIDirectMusicSegment8音乐数据段，加载音乐后存放的位置

IDirectMusicSegmentState8 音乐段状态

: |7 `: E# x! T5 w" m- N2 U6 J顺便说一下DLS
, D; F5 q5 F2 z
我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题

$ [2 t  S8 e) w- F4 ^0 ZDLS全称是DownLoadable Sounds
# R/ ~5 X  o) G& p; s) x% t
) Q: R  j6 I1 D% h5 U7 b; p: ~! cMSDN中这样解释：
9 b8 P2 i/ p3 {- V2 q
' V. z; A0 T. C! D7 MA 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.
* E5 Q3 R5 Z1 v  W6 T
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
+ \( u: Z  r; V) \2 T; `
2 B9 p2 n0 }3 c( F$ O- @7 r使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
  i: f- m2 H9 z) |
, T$ k# b& T  B  x好了，说了这么多，该开始应用了
+ E' G# X: U  B4 @0 ~9 p8 I" p2 A
. X# `& h$ a# I! t8 G1 ]1 aIDirectMusicLoader8*  pLoader=NULL;

+ F4 a) f4 G' g% |IDirectMusicPerformance8* pPerf=NULL;
. \5 M$ h! }: o" q5 _$ S- |- p$ Q$ C
IDirectMusicSegment8*  pSeg=NULL;

4 t, H8 A6 x( [3 x首先，初始化Com
9 V! w6 T& N0 k7 m) K, e
(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)

HRESULT hr=CoInitialize(NULL);
3 }) j1 b1 ]$ ~2 V- ?0 s! Y, j( L* m
If(FAILED(hr))
$ ?6 j  h  @0 G8 r: M# T
1 v9 U/ t. K2 Z( [% \4 u{

9 e; T; c: c$ n5 G6 c* l# U4 W   处理错误
8 b$ |' C+ ~* a0 N" E
9 ]* R. {1 g; g. D6 s5 ~}

4 b: C" e6 \; e3 C8 i4 M  q4 Q以下为了方便，省了错误处理
* B/ P$ A  b# n, N+ }* L
6 |+ x% z# V: p, A下面创建加载器

9 @' b% F6 Q: l9 L# N2 H9 s7 jCoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID
; R; n+ k) ~% c7 T! J3 h9 R% Q
NULL,    //不是创建集合
$ D2 R  u6 }& D' ]5 z: \- s+ M1 m
CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicLoader8,    //接口的GUID
; F; y4 {: a# p8 I. t4 [
: d: g  H: E" e" o1 d, C(void**)&pLoader);              //被创建的接口指针

; m! P8 h8 w  C4 j创建“表演”，（控制器）

CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
, V! d* ?! {. `; ^. u
4 Q& g: r( U% p  s3 WNULL,    //不是创建集合

CLSCTX_INPROC,      //创建的环境

IID_IDirectMusicPerformance8,   //接口的GUID

; d& I" f8 B/ D0 K(void**)&pPerf);          //被创建的接口指针

" v3 `/ R$ d6 H初始化声音通道
- l8 d3 \) E2 q) Y/ ?
pPerf->InitAudio(
1 w+ f% B7 U9 u, Q2 V+ @: i3 `
    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
  R; l, a1 M% N3 X: Q
    NULL,//DirectSound对象的指针，同上
7 D- H! V& V3 b5 _
    hWnd,//窗口句柄
) N$ F/ L, X' `/ T- l9 _
5 u3 J7 k% C- j; g; P9 P    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

    64, //音乐通道数

    DMUS_AUDIOF_ALL, //声卡的所有特性

3 R1 S6 _1 h4 v' i    NULL // DMUS_AUDIOPARAMS对象的指针

* C* O9 G' b) ?+ c+ o9 @  );

好了,初始化Dmusic完成
2 m: l* v7 W4 w0 B
5 Q) C; J. v  ~9 D. M* O& c- q下面读入mid文件

  

pLoader->LoadObjectFromFile(
0 \3 h" |8 L0 @/ |) A- N5 S
5 k' C. g0 ^7 t* h# |9 |# M  V                CLSID_DirectMusicSegment, //组件的GUID
( V. T& x. Q! z8 U( V7 \' h- V3 \  r
                    IID_IDirectMusicSegment8, //接口的GUID

( t3 d# F+ r$ n' q                    file;//文件名,注意用Unicode

% C# |6 U. ^$ x/ O                   (void**) &pSeg//音乐要装到的段
& p0 E4 f$ m+ I8 f: z$ o
5 T: @8 G. z# W5 c3 J' S  );

9 v' Q# e! t7 U* c, A从ASCII转换到UNICODE的函数是

5 d, W( H6 r, n7 V比如

/ {1 K, y" i5 V. Z/ dconst int MAX_FILE_LENGTH=128;
1 y1 k3 U! F9 h
, H( \) y' e9 O# m  T1 NWCHAR UnicodeFile[MAX_FILE_LENGTH];
2 R2 x- v) B: A5 R# \
MultiByteToWideChar(

CP_ACP,//ASCII码

# E- j" Q' t8 \# N3 D% t7 u   0,//

: Q9 S5 R6 m+ y& m; h- Masciifile,//要转换的ascii字符串
- ^8 B$ y0 F8 \( w4 h+ H- ^6 T9 ]+ {
-1,//要转换的字节数,-1表示以’\0’结尾的字符串

& B7 \7 S$ U/ c; o# a* D/ o% \( j                        UnicodeFile,//转换后UNICODE存放的地方
( v" Q0 G3 E- }! z: _
! M0 X; S# \% P4 s  [' HMAX_FILE_LENGTH);

" M! r% M2 L! R( u下面播放mid音乐
  R' W. u6 _* G; N0 x5 |9 Z9 N
7 s& l2 K/ L# j1 q. MpSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
4 Z: k! B; D- k6 B1 O
pSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

pPerf->laySegmentEx(pSeg,//要播放的段

NULL,//保留,必须为NULL

8 {* U  f: Q; {9 M+ Q  ANULL,//pTransiton

0,//播放的标志
& z. `& \0 [, R
0,//开始的位置
7 T6 n) [0 ?8 t) w8 h
  h( c; b& Q* {$ D. F% s7 ~4 QNULL,//用与接收段状态的指针,如果不需要,就为NULL
3 `& t" T( \+ R5 l, }& o' w5 V
NULL,//使用默认

. ?/ B8 \& i: ?1 SNULL//默认的AudioPath
& S; x7 E2 e8 V# n1 q: |) g* f
8 d6 p9 h  t) \( y3 X% S! O% h; a! I);
& Y# _# R( a* }* A5 q9 H
& t/ T( G6 W$ I& m2 Z9 _' L暂停播放

MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型
; g1 ]- S9 M# t9 C
pPerf->GetTime(NULL, &mtime);//得到暂停的位置

停止播放

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

NULL,//段状态

0,//多少时间后停止,0表示立即
$ i: S7 ]7 s" G! n
0//标志

);

& Y1 @& f. H2 e7 F2 U; W7 n) q- Y从暂停点继续播放

6 T* P1 z  Q1 npSeg->SetStartPoint(mtime);//播放点
* v& U# ^. m3 j) E
pPerf->laySegmentEx(pSeg,

NULL,
1 V( p8 q/ q; L( c- I, |
NULL,

" m$ R0 @& f- z" I- `) P* Y- T7 cDMUS_SEGF_REFTIME,

. @9 ^- i+ ]7 E& s% L4 Z1 r+ J' }0,

+ p) }, L/ V1 V2 h7 r* ~) KNULL,

NULL,
( o/ q, w; a  B% r: J& a
! Z- s1 h! u- VNULL

);
; f1 s8 Y) S8 W! S6 z. {1 U* E+ m
pSeg->SetStartPoint(0);
  T, c  }/ Y! W& P& m8 i
6 Y7 |6 x- \/ S1 ?释放DirectMusic
8 c' v8 }' X+ m/ H$ ?( R
pPerf->CloseDown();

pSeg->Release();

pPerf->Release();

% `- o9 z/ D8 Z+ t9 OpLoader->Release();
  V' n( o! j3 Y3 o
  

% J7 d1 w& k1 P- E1 rCoUninitialize();//停止使用COM

好了,整个过程就是这么简单!

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

* a' t5 ?( ]# i$ J) g这样,你就可以在你的游戏中实现MID的播放啦!

: ~  p( j. |# g当然,播放mid只是DirectMusic功能中很小的一部分
! Y3 t, K! {: L9 F, t; B& C- i8 |
它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!

最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！
9 l3 p2 [4 g# r  X
程序下载:
+ y7 @5 O* F( n- P3 t4 p
' m# k3 ]% y* ^  
! R3 J" Z$ M9 o# U. u: ^5 w
(参考资料:

9 d+ P  N9 k: v% d* T0 [WINDOWS游戏编程大师技巧

  i  U: H5 @3 Q% zMSDN2003的DirectMusic部分)