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

天云上人

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

在DirectX8SDK中，DirectMusic增加了很多新特性，我在这里单单讲用它播放Mid的部分
% @4 Q( P5 l; z' C. r4 R
7 \7 P! S* U  X% b7 S, r9 aDirectMusic主要有下面几个部分组成：

IDirectMusicLoader8

IDirectMusicPerformance8
! p) u2 q) n6 c6 k$ s9 {& D
IDirectMusicSegment8
  Z% O9 s; j( C( l8 j# B" w* ]
, b6 R  i' D. z/ I- jIDirectMusicSegmentState8

你也许会问：为什么没有IDirectMusic8 ？这个是因为在DirectMusic中，Microsoft把IDirectMusic8“隐藏”起来了，也就是说，我们不需要使用这个接口，可以通过其他方式轻松实现
4 J6 ~8 ?) r' l3 F8 w7 [# _
- Z, u) j/ |7 O+ A/ ?IDirectMusic8

) K* S) y( Q9 W! X, y- _IDirectMusicLoader8

* F# f7 Q  `9 t' f$ n- ]( L0 oIDirectMusicPerformance8

IDirectMusicSegment8
- A* a/ x; L  @: |4 z- L) k+ D
( A+ _7 W( `* L5 g2 g* aAudioPath

IDirectMusicSegmentState8

# p' L8 ]' H' i如图:

% w$ E$ j% ~  t% F% [+ l                                                                                                   
9 O2 G* ?5 h6 d2 j+ |& B
  

  
( v( v$ O6 v- s
  
* G7 ~% u# K  g: |0 c
  
' o; E1 A5 L4 {, v- l+ F) C4 _
IDirectMusicLoader8,加载器。用于加载Mid文件等等
  W/ c2 U! g, G. b) b) l
  W8 @7 g3 Q) B6 E" XIDirectMusicPerformance8用来控制DirectMusic的接口

$ j% ]7 N& a/ ]* E6 l+ A7 sIDirectMusicSegment8音乐数据段，加载音乐后存放的位置
; W6 _7 J& \: d0 e5 j7 L7 c
IDirectMusicSegmentState8 音乐段状态
& t6 o/ W% }7 b- b  H$ t
顺便说一下DLS
' N- A5 Z8 ^6 J9 m& t+ j5 Q# C
我们知道，mid文件纪录的只是“乐器”，音调和实践。在播放的时候，声卡对mid文件进行编码，而每种声卡上的“波表”都有差别，所以在编码的时候，播放出来的声音就与声卡有关。打个比方，你在A机子直接播放和B机子直接播放同一个mid文件，如果A的声卡和B的声卡不同的话，听起来的音质完全不一样(我们耳朵能听到的只能是模拟的声音而不是数字化的声音数据)。正因为如此，Microsoft在DirectMusic中使用了DLS，很好的解决了这个问题

DLS全称是DownLoadable Sounds
( F7 A8 \- g1 p* y4 l8 G
MSDN中这样解释：

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.
4 L! |3 U& s1 c7 L# T, z
原理就是在DLS文件中通过使用乐器的单音采样来处理这个问题。所以在DirectMusic中
0 k& d7 C$ b% y) z% q3 m
* a" Y0 ^1 t0 t# F6 E使用默认的DLS文件，把mid音乐转化为数字化的音乐。数字化的声音就可以通过 数字——〉模拟（D/A）转换，随后播放出来的声音听起来都是一样的（因为不需要再声卡上重新编码了啊！）
! m" d9 l$ E  |2 ]! M8 U, S
, I( ?" u0 ^. b/ c# R" \好了，说了这么多，该开始应用了
$ ]5 h: }6 V! @6 s7 r+ D. @* u
IDirectMusicLoader8*  pLoader=NULL;

IDirectMusicPerformance8* pPerf=NULL;

IDirectMusicSegment8*  pSeg=NULL;

首先，初始化Com

(这个东西博大精深,推荐一本:com本质论!看过这本书后,包你对DirectX的认识有新的飞跃!)
# Q7 O" }) l' |
HRESULT hr=CoInitialize(NULL);
4 u: B# p+ z0 b4 _
7 ^% ~3 ~& p; d/ E. c# vIf(FAILED(hr))

( N5 J4 [- L1 X/ U6 c# D{
) g8 m! X1 M' l: V! {5 a6 P
* F# q3 f) `' l  H   处理错误

; e: l: C1 b7 `9 k7 {}
5 n8 l" S" A/ {: Y, a# J* h6 C
1 K8 j! v' m' S7 M; I7 Y" f+ V2 y9 K以下为了方便，省了错误处理

下面创建加载器
& E8 G6 c4 E& i& Z. r6 F
$ x% M9 Z- i& HCoCreateInstance(CLSID_DirectMusicLoader,    //组件的GUID

! n/ A& [8 L. f3 f1 m3 VNULL,    //不是创建集合

. M) o0 q) p" bCLSCTX_INPROC,      //创建的环境
' E# v/ \" j4 [  A
IID_IDirectMusicLoader8,    //接口的GUID
& x( X' [4 T, J  d/ k/ u
(void**)&pLoader);              //被创建的接口指针
1 C% W2 ^& L3 x0 h  B/ K
创建“表演”，（控制器）
7 G+ K5 P( T9 h; e  n7 N& U  a
CoCreateInstance(CLSID_DirectMusicPerformance,  //组件的GUID
$ y3 C/ ^$ D/ Q. g
7 m/ _. k) x5 Q1 b, zNULL,    //不是创建集合

( W2 d! u. t6 X( ~8 @CLSCTX_INPROC,      //创建的环境

# j; Q2 Q7 E4 O3 ^8 h7 j* PIID_IDirectMusicPerformance8,   //接口的GUID
- m; c. y% l, y4 Y) I
(void**)&pPerf);          //被创建的接口指针
( O& o* E# a/ G
初始化声音通道
6 e: D2 L( S% G. o9 I5 l; ^% g
pPerf->InitAudio(

    NULL,//DirectMusic对象的指针，因为不需要我们管理，所以让它自动进行
' b  X$ i6 ?/ D; R+ [  F0 U
    NULL,//DirectSound对象的指针，同上

    hWnd,//窗口句柄
8 Q+ \3 w- {7 d* ^
* g  z' i1 ^, L9 Y# g    DMUS_APATH_SHARED_STEREOPLUSREVERB,//声音通道(AudioPath)类型:立体声+混响

    64, //音乐通道数

/ V$ ^0 r, u- B8 V2 m( Q' z0 ?9 R* W    DMUS_AUDIOF_ALL, //声卡的所有特性
8 r, j2 a1 }! t2 a& v7 }3 y
    NULL // DMUS_AUDIOPARAMS对象的指针

! h7 p5 @( l  ^  );

) h4 [! d, F4 X7 T& [好了,初始化Dmusic完成

下面读入mid文件
. [; i3 w1 v. T; u# F/ ~( i
% w: U$ s1 T& z! P  m: I! I) J  
9 v* {, ^& J3 W6 Z: i( c' _, g
pLoader->LoadObjectFromFile(

                CLSID_DirectMusicSegment, //组件的GUID
6 }1 t4 M9 g; E" x. [, W; j4 `
                    IID_IDirectMusicSegment8, //接口的GUID
8 n1 J& ?! ^9 l) p! m/ T9 d0 B# W
                    file;//文件名,注意用Unicode
; S( J$ b. o. V0 ?& @" l
                   (void**) &pSeg//音乐要装到的段
3 L9 O/ z2 g: o
/ b' j( @- Y) o8 e  );
/ |+ j6 V4 t  w1 Y) u1 l
& C* c* w2 x. h. ]) G4 W从ASCII转换到UNICODE的函数是
! ~8 [; ?; y- P: J$ n
4 [9 N; Y2 R5 y/ `- u比如
: [( J' ~6 f; R' i: f* N- e
( R0 U. E; z: i8 u% V. d+ iconst int MAX_FILE_LENGTH=128;
2 O1 x. M+ o: b% ?. ^' Q
, o  g) }; \6 p: U  iWCHAR UnicodeFile[MAX_FILE_LENGTH];

MultiByteToWideChar(
9 |1 ]' r& L8 A3 f* D
CP_ACP,//ASCII码
) f  B, W; j! W7 q0 O6 E
   0,//
7 K/ U6 u1 w. s2 ?
asciifile,//要转换的ascii字符串
1 ?: Y& t, z; X* R3 h
& N4 M% o# m, F1 D5 @( K* Q# O8 M( J! U -1,//要转换的字节数,-1表示以’\0’结尾的字符串

                        UnicodeFile,//转换后UNICODE存放的地方
# W% q3 M  m0 g6 ~: O  ~. z
# l! L, }& N% D/ S1 U; Z9 pMAX_FILE_LENGTH);

下面播放mid音乐
  N( n: P( R* U% ^% L
pSeg->SetRepeats(looptimes); //重复的次数,如果是DMUS_SEG_REPEAT_INFINITE则为无限
0 b* }, g6 X7 d5 x
0 L1 ~% z' f, `. a0 j1 gpSeg->Download( pPerf );//使用DLS,把MID数据转换成数字化的音乐数据

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

/ J8 t9 A! o( B! ZNULL,//保留,必须为NULL

' D, {. l1 g& p* o- q. S* sNULL,//pTransiton
/ u1 n; r7 f5 b7 R+ W# S+ U# M
0,//播放的标志
' M2 ^) W9 P( Y2 H5 p  t
0,//开始的位置
4 J5 ~) t; |) n9 i
NULL,//用与接收段状态的指针,如果不需要,就为NULL
! L) d& p: S% ~' L1 d' _
NULL,//使用默认
/ I) B. ~: b) q* U* H: Q
NULL//默认的AudioPath

  }# ~6 w/ q' K' X# f" M3 [2 B" D% b3 N);

4 O  D) }: u. d暂停播放
" `  B; ?% ^6 B" P* y! ]0 {
MUSIC_TIME mtime;//MUSIC_TIME就是一个long类型

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

停止播放

pPerf->Stop(NULL,//要停止的段,NULL表示全部段都停止
% T6 Z8 ?' }4 t) e8 k
/ O6 F9 n' F0 Q: b  rNULL,//段状态
% j( o: M$ t, J4 z
0,//多少时间后停止,0表示立即

0//标志
/ s5 `0 I. o  s/ k1 ?( V2 G- \
);

从暂停点继续播放

8 B  M. Q' [# o) ], ]6 @. c0 D5 cpSeg->SetStartPoint(mtime);//播放点
% M; d* Z" c. R( B" l- q$ G* M: Z5 p
pPerf->laySegmentEx(pSeg,

NULL,

; g2 l( P$ P$ o1 I4 uNULL,
- E# z% j8 j* v
DMUS_SEGF_REFTIME,
1 V4 h( T' P7 i+ Q4 G
* V7 c: C! r, s: ^. k3 r$ e0,
" ~! V  n8 p' `  U1 f
NULL,

NULL,

NULL

  d% v. Q9 K1 t);
+ o; \+ z) J; F2 Y- N
pSeg->SetStartPoint(0);
% U1 K, {  N$ E! s0 V
5 X0 C! {4 a0 ]释放DirectMusic

pPerf->CloseDown();

3 G8 V+ F5 F# a8 q+ Q% ^pSeg->Release();
4 I* @4 e- V: P' C- s. h
pPerf->Release();

pLoader->Release();
! Z  Y0 }& X7 P2 h6 s
3 j+ N3 q: t1 W3 p6 r* {  

8 f2 ~! _" M) B, gCoUninitialize();//停止使用COM

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

4 |% ^7 X& x' y1 o! {当你理解后,可以自行把上面的代码封装为一个类

# F" {% s7 b' q: ]7 \* [这样,你就可以在你的游戏中实现MID的播放啦!

当然,播放mid只是DirectMusic功能中很小的一部分
# D# }' b1 ?" r4 T4 c8 i# f/ s
它还能播放wav文件,sgt文件,实现3D声音等等,具体内容自己参考MSSDK中的文档和例子吧!

, d4 ?) c( V' {- B/ G最后,欢迎与我交流:game-diy@163.com,QQ:30784290,写得不足的地方还清不吝赐教！

' j: y0 Z9 P4 ]; S+ S程序下载:
; o  F6 Q0 f9 E2 O: Z! @
3 }9 A* d5 e, P4 S, e0 z  
3 G! L0 a* G$ c! b
(参考资料:

# }" B0 j2 ~9 [9 @' D; }7 U$ C. cWINDOWS游戏编程大师技巧
) F3 e' k& F# ]0 u5 T0 J) A
MSDN2003的DirectMusic部分)