HOW TO：播放音效

發行項
08/21/2008

更新：2007 年 11 月

這個範例會示範如何使用平台叫用，播放兩個 WAV 檔，一個做為內嵌資源，另一個則做為內容。

如果要將 WAV 檔實作成 Visual Studio 中的嵌入式資源，請在 [內容] 窗格中，將 [建置動作] 屬性設定為 [內嵌資源]。如果您是在命令列上進行編譯，請參閱 HOW TO：在命令提示字元進行編譯，以取得編譯內嵌資源的相關資訊。

注意事項：
.NET Compact Framework 3.5 版支援 SoundPlayer 播放音效。如需詳細資訊，請參閱 .NET Compact Framework 中的 SoundPlayer。

這個範例會定義 Sound 類別，這個類別會使用 Windows CE 中的 CoreDll.dll 提供下列機器碼功能：

使用檔案名稱或資料流來播放聲音的平台叫用方法宣告。
在平台叫用方法呼叫中傳遞引數之位元值的列舉型別
呼叫正確平台叫用方法以播放個別檔案或內嵌資源的 Play 方法

本範例使用名稱為 Chimes.wav 的音效檔。當您將音效檔納入成為內嵌資源時，要在 GetManifestResourceStream 呼叫中，將原始檔案名稱前加上組件命名空間，以傳回檔案的資源資料流。

使用平台叫用播放聲音

將 Sound 類別加入至專案。

Public Class Sound
   Private m_soundBytes() As Byte
    Private m_fileName As String

    Public Declare Function WCE_PlaySound Lib "CoreDll.dll" Alias "PlaySound" (ByVal szSound As String, ByVal hMod As IntPtr, ByVal flags As Integer) As Integer
    Public Declare Function WCE_PlaySoundBytes Lib "CoreDll.dll" Alias "PlaySound" (ByVal szSound() As Byte, ByVal hMod As IntPtr, ByVal flags As Integer) As Integer



   Private Enum Flags
      SND_SYNC = &H0 ' play synchronously (default) 
      SND_ASYNC = &H1 ' play asynchronously 
      SND_NODEFAULT = &H2 ' silence (!default) if sound not found 
      SND_MEMORY = &H4 ' pszSound points to a memory file 
      SND_LOOP = &H8 ' loop the sound until next sndPlaySound 
      SND_NOSTOP = &H10 ' don't stop any currently playing sound 
      SND_NOWAIT = &H2000 ' don't wait if the driver is busy 
      SND_ALIAS = &H10000 ' name is a registry alias 
      SND_ALIAS_ID = &H110000 ' alias is a predefined ID 
      SND_FILENAME = &H20000 ' name is file name 
      SND_RESOURCE = &H40004 ' name is resource name or atom 
    End Enum


    ' Construct the Sound object to play sound data from the specified file.
    Public Sub New(ByVal fileName As String)
        m_fileName = fileName
    End Sub


    ' Construct the Sound object to play sound data from the specified stream.
    Public Sub New(ByVal stream As Stream)
        ' read the data from the stream
        m_soundBytes = New Byte(stream.Length) {}
        stream.Read(m_soundBytes, 0, Fix(stream.Length))
    End Sub 'New


    ' Play the sound
    Public Sub Play()
        ' If a file name has been registered, call WCE_PlaySound, 
        ' otherwise call WCE_PlaySoundBytes.
        If Not (m_fileName Is Nothing) Then
            WCE_PlaySound(m_fileName, IntPtr.Zero, Fix(Flags.SND_ASYNC Or Flags.SND_FILENAME))
        Else
            WCE_PlaySoundBytes(m_soundBytes, IntPtr.Zero, Fix(Flags.SND_ASYNC Or Flags.SND_MEMORY))
        End If
    End Sub 
End Class

public class Sound
{
    private byte[] m_soundBytes;
    private string m_fileName;

    private enum Flags {
        SND_SYNC = 0x0000,  /* play synchronously (default) */
        SND_ASYNC = 0x0001,  /* play asynchronously */
        SND_NODEFAULT = 0x0002,  /* silence (!default) if sound not found */
        SND_MEMORY = 0x0004,  /* pszSound points to a memory file */
        SND_LOOP = 0x0008,  /* loop the sound until next sndPlaySound */
        SND_NOSTOP = 0x0010,  /* don't stop any currently playing sound */
        SND_NOWAIT = 0x00002000, /* don't wait if the driver is busy */
        SND_ALIAS = 0x00010000, /* name is a registry alias */
        SND_ALIAS_ID = 0x00110000, /* alias is a predefined ID */
        SND_FILENAME = 0x00020000, /* name is file name */
        SND_RESOURCE = 0x00040004  /* name is resource name or atom */
    }

    [DllImport("CoreDll.DLL", EntryPoint="PlaySound", SetLastError=true)]
    private extern static int WCE_PlaySound(string szSound, IntPtr hMod, int flags);

    [DllImport("CoreDll.DLL", EntryPoint="PlaySound", SetLastError=true)]
    private extern static int WCE_PlaySoundBytes (byte[] szSound, IntPtr hMod, int flags);

    /// <summary>
    /// Construct the Sound object to play sound data from the specified file.
    /// </summary>
    public Sound (string fileName) {
        m_fileName = fileName;
    }

    /// <summary>
    /// Construct the Sound object to play sound data from the specified stream.
    /// </summary>
    public Sound(Stream stream)    {
        // read the data from the stream
        m_soundBytes = new byte [stream.Length];
        stream.Read(m_soundBytes, 0,(int)stream.Length);
    }

    /// <summary>
    /// Play the sound
    /// </summary>
    public void Play () {
        // if a file name has been registered, call WCE_PlaySound,
        //  otherwise call WCE_PlaySoundBytes
        if (m_fileName != null)
            WCE_PlaySound(m_fileName, IntPtr.Zero, (int) (Flags.SND_ASYNC | Flags.SND_FILENAME));
        else
            WCE_PlaySoundBytes (m_soundBytes, IntPtr.Zero, (int) (Flags.SND_ASYNC | Flags.SND_MEMORY));
    }
}

加入方法以建立 Sound 類別的執行個體並播放檔案，例如在按鈕的 Click 事件中。

' To return a Stream object associated with an embedded
' resource, you must prepend the namespace to the original
' name of the file in the project.
Private Sub btnEmbedded_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles btnEmbedded.Click
    Dim sound As New Sound([Assembly].GetExecutingAssembly().GetManifestResourceStream("SoundSample.chimes.wav"))
    sound.Play()
End Sub 


Private Sub btnFile_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles btnFile.Click
    Dim sound As New Sound("Program Files\SoundSample\chord.wav")
    sound.Play()
End Sub

// To return a Stream object associated with an embedded
// resource, you must prepend the namespace to the original
// name of the file in the project.
private void btnEmbedded_Click(object sender, System.EventArgs e) {
    Sound sound = new Sound (Assembly.GetExecutingAssembly().GetManifestResourceStream("SoundSample.chimes.wav"));
    sound.Play();
}

private void btnFile_Click(object sender, System.EventArgs e) {
    Sound sound = new Sound ("Program Files\\SoundSample\\chord.wav");
    sound.Play();
}

編譯程式碼

這個範例需要下列命名空間的參考：

請參閱

概念

.NET Compact Framework HOW TO 主題

其他資源

.NET Compact Framework 中的互通性