技術標籤：C#教程c#

在C#中有許多音訊播放的方案，例如WinForm裡呼叫系統自帶MediaPlayer的COM元件和WPF的MediaPlayer(實質上還是WindowsMediaPlayer)

以及一堆API播放和DirectX （SDK一大堆）

於是我找到了適用於全平臺、高效、小巧的音訊解碼器–Bass (主程式基於C++ C#可通過官方庫Bass.Net呼叫)

一、開始
首先需要到官網下載bass.dll 主程式檔案(大約 257kb): http://www.un4seen.com/

以及類庫(.Net平臺呼叫) :你可以在http://www.bass.radio42.com/bass_register.html 中使用你的郵箱即可註冊到一個key 和下載Bass.Net.dll(大約520kb)

官方文件:http://www.bass.radio42.com/help/

P.S:bass.dll需要放在程式主目錄下 Bass.Net.dll隨意(新增到程式集引用)

二、編碼
在一切開始之前，你需要先註冊程式和初始化Bass解碼器:

using Un4seen.Bass;//新增引用
…
BassNet.Registration(“你的郵箱”, “你註冊到的Key”);
Bass.BASS_Init(-1, 44100, BASSInit.BASS_DEVICE_CPSPEAKERS, 視窗控制代碼 沒有的話就IntPtr.Zero);
1.實現簡單的mp3播放
播放mp3有2種方式 :從檔案中載入、從URL中載入

例1:從檔案中載入:

//---------呼叫到的方法------------
public static int BASS_StreamCreateFile(
    string file,//檔案路徑
    long offset,//偏移量，一般不怎麼使用
    long length,//如果你使用了偏移量，定義一個偏移量之後的讀取長度
    BASSFlag flags//以什麼方式建立流
)
//幫助連結和其他資訊:http://www.bass.radio42.com/help/html/e49e005c-52c0-fc33-e5f9-f27f2e0b1c1f.htm
//----------------------------------
 


//建立流的id，建議作為全域性變數加入(如果是播放單檔案)
private int stream =  -1024;//可以自己定義一個初始值
...
//從檔案中建立一個簡單的FLOAT音訊流,返回流的id 便於控制和查詢
stream = Bass.BASS_StreamCreateFile(你的檔案完整路徑, 0L, 0L, BASSFlag.BASS_SAMPLE_FLOAT);
... 開始播放
//引數:int 要播放的流的id,bool 是否在播放完成之後再重新播放
Bass.BASS_ChannelPlay(stream, false);
... 暫停播放
Bass.BASS_ChannelPause(stream);

例2:從URL中載入:

stream = Bass.BASS_StreamCreateURL(url, 0, BASSFlag.BASS_SAMPLE_FLOAT, null, IntPrt.Zero);
只是載入音訊流的方式改變了，其他的一致

如果你需要一些其他的功能(請求Url時的標頭和下載回撥)，請參閱以下:

1.新增URL請求標頭:

很簡單:在url引數裡新增即可，url與每一條標頭之間用"\r\n"換行，例如:

stream = Bass.BASS_StreamCreateURL(url+"\r\n"+“一條標頭，Header:Content”+"\r\n"+“再一條標頭”,…);
2.下載回撥: 多用於快取

//必須是全域性變數，否則會被GC回收！
private DOWNLOADPROC _myDownloadProc;
private FileStream _fs = null;//寫入檔案的流
private byte[] _data; // 本地快取

...
//新增呼叫
 _myDownloadProc = new DOWNLOADPROC(DownloadCallBack);
...

//下載回撥，由Bass呼叫
private void DownloadCallBack(IntPtr buffer, int length, IntPtr user)
        {
            // file length
            long len = Bass.BASS_StreamGetFilePosition(stream, BASSStreamFilePosition.BASS_FILEPOS_END);
            // download progress
            long down = Bass.BASS_StreamGetFilePosition(stream, BASSStreamFilePosition.BASS_FILEPOS_DOWNLOAD);
            //可在此處新增下載進度的Callback

            if (_fs == null)
            {
                // 開始下載，開啟檔案流
               //坑:當你切歌的時候，Bass並不會繼續下載而且會向你傳送已經下載完成的標識，此時你得到的檔案是不完整的!所以此處先作為.cache下載
                _fs = File.OpenWrite(儲存的路徑 + ".cache");
            }
            if (buffer == IntPtr.Zero)
            {
                // 下載完成
                _fs.Flush();
                _fs.Close();
                _fs = null;
                FileInfo fi = new FileInfo(DLPath + ".cache");
               //如果下載不完整的話就刪除.cache
                if (fi.Length != len)
                {
                    fi.Delete();
                }
                else
                {
                    //如果下載完整的話就移動到快取(下載)目錄
                    fi.MoveTo(你的路徑, true);
                    //這裡可以做下載完成的回撥
                }
            }
            else
            {
                //接受到下載資料，實質上是Bass傳來資料的指標，C#根據指標從記憶體中複製資料
                // increase the data buffer as needed
                if (_data == null || _data.Length < length)
                    _data = new byte[length];
                // copy from managed to unmanaged memory
                Marshal.Copy(buffer, _data, 0, length);
                // write to file
                _fs.Write(_data, 0, length);
            }
        }

2.獲得和設定一些常規資料(播放進度、聲音):
1.設定、獲取音量:

坑：音量的設定是暫時性的，僅對於你輸入的stream,當你再次新建音訊流時(例如切歌),音量會恢復預設!你可能需要記錄下設定的音量並在下一次載入流時將音量設定Set到stream中!

//設定音量 值在0~1之間 預設值為1
Bass.BASS_ChannelSetAttribute(stream, BASSAttribute.BASS_ATTRIB_VOL, value);

...

//獲取當前音量 ref value
float value=0;
Bass.BASS_ChannelGetAttribute(stream, BASSAttribute.BASS_ATTRIB_VOL,ref value);

2.播放進度和總長(時間):

 //長度
public TimeSpan GetLength
        {
            get
            {
                double seconds = Bass.BASS_ChannelBytes2Seconds(stream, Bass.BASS_ChannelGetLength(stream));
                return TimeSpan.FromSeconds(seconds);
            }
        }
//當前播放位置
public TimeSpan Position
        {
            get
            {
                double seconds = Bass.BASS_ChannelBytes2Seconds(stream, Bass.BASS_ChannelGetPosition(stream));
                return TimeSpan.FromSeconds(seconds);
            }
            set => Bass.BASS_ChannelSetPosition(stream, value.TotalSeconds);
        }

獲取FFT資料，你可以用這個資料來做頻譜:

//獲取256位的FFT資料，當然你可以選擇更大的，但是也足夠了
//坑:暫停播放時獲得的FFT資料仍是沒有暫停前的資料(停留在此位置的FFT)如果你需要做頻譜圖，在暫停時應該手動設定為0，因為Bass並不會在暫停時返回0
float[] fft = new float[256];
Bass.BASS_ChannelGetData(stream, fft, (int)BASSData.BASS_DATA_FFT256);
可惜的是，Bass並沒有提供播放完成的回撥，你需要設定一個Timer來判斷是否播放完成，理論上當當前位置=播放總長時算播放完成…

3.更新裝置和結束時
1.系統會將當前的預設裝置放在集合的[0]位，但是Bass並不會自動更新裝置也沒有更新裝置的事件回撥（或是我沒有找到?），所以你需要自己檢查下有沒有新的裝置插入，你需要手動更新裝置(如果需要)

public void UpdataDevice()
        {
            var data = Bass.BASS_GetDeviceInfos();
            int index = -1;
            for (int i = 0; i < data.Length; i++)
                if (data[i].IsDefault)
                {
                    index = i;
                    break;
                }
            if (!data[index].IsInitialized)
                Bass.BASS_Init(index, 44100, BASSInit.BASS_DEVICE_CPSPEAKERS, wind);
            var a = Bass.BASS_ChannelGetDevice(stream);
            if (a != index)
            {
                Bass.BASS_ChannelSetDevice(stream, index);
                Bass.BASS_SetDevice(index);
            }
        }

2.結束時，需要釋放流和Bass解碼器:

Bass.BASS_ChannelStop(stream);
Bass.BASS_StreamFree(stream);
Bass.BASS_Stop();
Bass.BASS_Free();
 

4.倍速播放和其他FX效果
為什麼這裡需要重新起個標題呢？

這個方法推翻了之前用到的stream建立形式，但是控制播放暫停等方法不變。

首先你需要引入幾個Bass的概念:

音訊流:stream,用於播放音訊，就是你控制播放暫停時傳入的stream

解碼流 decode,用於解碼音訊，然後傳給Fx效果器,Fx效果器會返回給你一個音訊流

實現此方法，你需要下載FX擴充套件(就在bass.dll的地方下載 選擇add-on 即可),大約85kb

新增using引用:

using Un4seen.Bass.AddOn.Fx;
建立流:

//全域性變數，解碼流
private int decode;

decode = Bass.BASS_StreamCreateFile(你的檔案, 0L, 0L, BASSFlag.BASS_STREAM_DECODE);
//相對於前面的你只需要把標籤換成BASS_STREAM_DECODE即可，CreateURL亦是如此

//將解碼流傳入Fx效果器中，你將得到一個音訊流
stream = BassFx.BASS_FX_TempoCreate(decode, BASSFlag.BASS_FX_FREESOURCE );

設定Fx效果:

value值在-90₀5000之間 以百分制計算 例如 加速/減速 播放10%那麼value=10,不用倍速播放value=0 減速 value=-10

Bass.BASS_ChannelSetAttribute(stream, BASSAttribute.BASS_ATTRIB_TEMPO, value);
獲取Fx效果的方法和音量一致，更換標籤為BASSAttribute.BASS_ATTRIB_TEMPO即可.

更多的FX效果可以參閱:http://www.bass.radio42.com/help/html/90d034c4-b426-7f7c-4f32-28210a5e6bfb.htm 原理一樣 修改標籤和value值即可