傲瑞组件开发手册（05）－－语音视频播放组件 MPlayer

在多媒体系统中，一般都会涉及到语音数据、视频数据的播放问题，比如播放采集到的麦克风数据、摄像头数据，或播放wav文件等。

　　MPlayer 是傲瑞实用组件之一，可用于播放声音数据、视频图像数据。

一.MPlayer 简介

　　当前版本的MPlayer组件支持：

（1）播放声音：直接播放PCM声音数据，播放WAV文件。播放时，可指定扬声器索引、声音数据的采样率、采样深度、声道数。

（2）播放图像：该功能暂不支持。

二.MPlayer 结构

　　对于使用者而言，MPlayer组件中的主要类的结构图如下所示：

（1）IAudioPlayer是声音播放器。

（2）我们可以通过调用PlayerFactory的CreateAudioPlayer方法来创建声音播放器实例。

（3）得到播放器实例后，使用声音数据调用其Play方法，就会播放传入的数据；不再使用播放器时，调用其Dispose方法将其释放。

三.使用接口详细定义

1.各播放器接口

     /// <summary>
    /// 声音播放器。用于播放PCM声音数据。
    /// </summary>
    public interface IAudioPlayer :IDisposable
    {       
        /// <summary>
        /// 将声音数据放到播放队列中，进行播放。
        /// </summary>
        /// <param name="audioData">声音数据</param>
        void Play(byte[] audioData);

        /// <summary>
        /// 清除缓冲区中尚未播放的数据。
        /// </summary>
        void Clear();
    }

　　要特别提醒的是：

（1）声音播放器IAudioPlayer内部使用了缓存队列，缓存的大小可在创建时进行设置。如果缓存中的数据尚未播放完，此时调用Play传入的数据将会在后面排队。

（2）如果调用Play传入的数据的量大于缓存中剩下的空间，则会自动丢弃缓存中最老的数据。

（3）调用Clear方法，可以立即情况缓存中尚未播放的数据。

2.播放器工厂

     /// <summary>
    /// 播放器工厂。
    /// </summary>
    public static class PlayerFactory
    {
        /// <summary>
        /// 创建声音播放器。用于播放PCM声音数据。默认采样位数：16，默认缓存大小：10秒。
        /// </summary>
        /// <param name="speakerIndex">使用的扬声器设备的索引。</param>
        /// <param name="sampleRate">声音数据的采样率。</param>       
        /// <param name="channelCount">声道数。</param>
        public static IAudioPlayer CreateAudioPlayer(int speakerIndex, int sampleRate, int channelCount);

         /// <summary>
        /// 创建声音播放器。用于播放PCM声音数据。
        /// </summary>
        /// <param name="speakerIndex">使用的扬声器设备的索引。</param>
        /// <param name="sampleRate">声音数据的采样率。</param>
        /// <param name="channelCount">声道数。</param>
        /// <param name="bitsNumber">声音数据的采样位数。一般为16。</param>        
        /// <param name="bufferSizeInSecs">缓冲区的大小：最多存储几秒钟的声音数据。默认值为10秒。</param>
        public static IAudioPlayer CreateAudioPlayer(int speakerIndex, int sampleRate, int channelCount, int bitsNumber, int bufferSizeInSecs);

        /// <summary>
        /// 解析WAV文件。
        /// </summary>        
        public static AudioInformation ParseWaveFile(string filePath);       
    }