在 .NET 中管理簡報的音訊框架

概觀

本文說明了如何在 Aspose.Slides 中使用音訊框架。它展示了如何將嵌入式音訊新增至投影片、自訂音訊框架的縮圖、設定播放選項（例如音量、迴圈、隱藏、修剪與淡入淡出時間），以及如何擷取在投影片放映過程中使用的音訊。

建立音訊框架

Aspose.Slides for .NET 允許您將音訊檔案新增至投影片。音訊檔案會以音訊框架的形式嵌入於投影片中。

建立 Presentation 類別的實例。
透過索引取得投影片的參照。
載入您想要嵌入至投影片的音訊檔案資料流。
將嵌入式音訊框架（包含音訊檔案）新增至投影片。
設定由 IAudioFrame 物件公開的 PlayMode 與 Volume。
儲存已修改的簡報。

以下 C# 程式碼示範如何將嵌入式音訊框架新增至投影片：

// 實例化一個代表簡報檔案的 Presentation 類別
using (Presentation pres = new Presentation())
{
    // 取得第一張投影片
    ISlide sld = pres.Slides[0];
    
    // 將 wav 音訊檔載入為資料流
    FileStream fstr = new FileStream("sampleaudio.wav", FileMode.Open, FileAccess.Read);

    // 加入音訊框架
    IAudioFrame audioFrame = sld.Shapes.AddAudioFrameEmbedded(50, 150, 100, 100, fstr);

    // 設定音訊的播放模式與音量
    audioFrame.PlayMode = AudioPlayModePreset.Auto;
    audioFrame.Volume = AudioVolumeMode.Loud;

    // 將 PowerPoint 檔案寫入磁碟
    pres.Save("AudioFrameEmbed_out.pptx", SaveFormat.Pptx);
}

變更音訊框架縮圖

當您將音訊檔案新增至簡報時，音訊會以帶有預設標準圖像的框架顯示（請參見下方圖片）。您可以變更音訊框架的縮圖（設定您偏好的圖像）。

以下 C# 程式碼示範如何變更音訊框架的縮圖或預覽圖像：

using (var presentation = new Presentation())
{
    var slide = presentation.Slides[0];

    // 在投影片上加入音訊框架，並指定位置和大小。
    var audioStream = new FileStream("sample2.mp3", FileMode.Open, FileAccess.Read);
    var audioFrame = slide.Shapes.AddAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.Dispose();

    // 將影像加入簡報資源。
    var imageStream = File.OpenRead("eagle.jpeg");
    var audioImage = presentation.Images.AddImage(imageStream);
    imageStream.Dispose();

    // 設定音訊框架的影像。
    audioFrame.PictureFormat.Picture.Image = audioImage; // <-----
	
	//將已修改的簡報儲存到磁碟
    presentation.Save("example_out.pptx", SaveFormat.Pptx);
}

變更音訊播放選項

Aspose.Slides for .NET 允許您變更控制音訊播放或屬性的選項。例如，您可以調整音訊音量、將音訊設定為循環播放，甚至隱藏音訊圖示。

Microsoft PowerPoint 中的 Audio Options 面板：

example1_image

PowerPoint Audio Options 對應 Aspose.Slides AudioFrame 屬性：

Start 下拉選單對應 AudioFrame.PlayMode 屬性
Volume 對應 AudioFrame.Volume 屬性
Play Across Slides 對應 AudioFrame.PlayAcrossSlides 屬性
Loop until Stopped 對應 AudioFrame.PlayLoopMode 屬性
Hide During Show 對應 AudioFrame.HideAtShowing 屬性
Rewind after Playing 對應 AudioFrame.RewindAudio 屬性

PowerPoint Editing 選項對應 Aspose.Slides AudioFrame 屬性：

Fade In 對應 AudioFrame.FadeInDuration 屬性
Fade Out 對應 AudioFrame.FadeOutDuration 屬性
Trim Audio Start Time 對應 AudioFrame.TrimFromStart 屬性
Trim Audio End Time 值等於音訊總長度減去 AudioFrame.TrimFromEnd 屬性的值

PowerPoint 音訊控制面板上的 Volume controll（音量控制）對應 AudioFrame.VolumeValue 屬性。它允許您以百分比調整音訊音量。

以下說明如何變更音訊播放選項：

Сreate 或取得音訊框架。
為您想調整的音訊框架屬性設定新值。
儲存已修改的 PowerPoint 檔案。

以下 C# 程式碼示範調整音訊選項的操作：

using (Presentation pres = new Presentation("AudioFrameEmbed_out.pptx"))
{
    // 取得 AudioFrame 形狀
    AudioFrame audioFrame = (AudioFrame)pres.Slides[0].Shapes[0];

    // 將播放模式設定為點擊時播放
    audioFrame.PlayMode = AudioPlayModePreset.OnClick;

    // 將音量設定為低
    audioFrame.Volume = AudioVolumeMode.Low;

    // 將音訊設定為跨投影片播放
    audioFrame.PlayAcrossSlides = true;

    // 停用音訊的迴圈
    audioFrame.PlayLoopMode = false;

    // 在投影片放映時隱藏 AudioFrame
    audioFrame.HideAtShowing = true;

    // 播放後將音訊倒回至開始位置
    audioFrame.RewindAudio = true;

    // 將 PowerPoint 檔案儲存至磁碟
    pres.Save("AudioFrameEmbed_changed.pptx", SaveFormat.Pptx);
}

以下 C# 範例展示如何新增帶嵌入式音訊的音訊框架、修剪它，並設定淡入淡出時間：

using (Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];

    byte[] audioData = File.ReadAllBytes("sampleaudio.mp3");
    IAudio audio = pres.Audios.AddAudio(audioData);
    IAudioFrame audioFrame = slide.Shapes.AddAudioFrameEmbedded(50, 50, 100, 100, audio);

    // 設定修剪開始偏移為 1.5 秒
    audioFrame.TrimFromStart = 1500f;
    // 設定修剪結束偏移為 2 秒
    audioFrame.TrimFromEnd = 2000f;

    // 設定淡入持續時間為 200 毫秒
    audioFrame.FadeInDuration = 200f;
    // 設定淡出持續時間為 500 毫秒
    audioFrame.FadeOutDuration = 500f;

    pres.Save("AudioFrameTrimFade_out.pptx", SaveFormat.Pptx);
}

以下程式碼範例說明如何取得帶嵌入式音訊的音訊框架，並將其音量設為 85%：

using (Presentation pres = new Presentation("AudioFrameEmbed_out.pptx"))
{
    // 取得音訊框架形狀
    IAudioFrame audioFrame = (IAudioFrame)pres.Slides[0].Shapes[0];

    // 設定音訊音量為 85%
    audioFrame.VolumeValue = 85f;
    
    pres.Save("AudioFrameValue_out.pptx", SaveFormat.Pptx);
}

管理音訊字幕

Aspose.Slides 允許您透過 CaptionTracks 屬性為音訊框架新增閉合字幕。此屬性會回傳一個 ICaptionsCollection，讓您新增 WebVTT 字幕軌、遍歷現有軌道，並在需要時將其移除。

新增音訊字幕

使用 CaptionTracks 屬性將一條或多條字幕軌附加到音訊框架。以下範例先將音訊檔案新增至投影片，接著從 .vtt 檔案載入新的字幕軌。

using (Presentation presentation = new Presentation())
{
    byte[] audioData = File.ReadAllBytes("audio.mp3");
    IAudio audio = presentation.Audios.AddAudio(audioData);

    ISlide slide = presentation.Slides[0];
    IAudioFrame audioFrame = slide.Shapes.AddAudioFrameEmbedded(10, 10, 50, 50, audio);

    // 從 WebVTT 檔案新增一條字幕軌道。
    audioFrame.CaptionTracks.Add("New track", "track.vtt");

    presentation.Save("audio_with_captions.pptx", SaveFormat.Pptx);
}

擷取音訊字幕

您可以遍歷與音訊框架關聯的字幕軌，並將其儲存為 .vtt 檔案。每條字幕軌會公開其二進位資料與唯一識別碼，可於匯出字幕時使用。

using (Presentation presentation = new Presentation("audio_with_captions.pptx"))
{
    ISlide slide = presentation.Slides[0];
    foreach (IShape shape in slide.Shapes)
    {
        if (shape is IAudioFrame audioFrame)
        {
            foreach (ICaptions captionTrack in audioFrame.CaptionTracks)
            {
                // 將字幕軌道儲存為 .vtt 檔案。
                File.WriteAllBytes($"{captionTrack.CaptionId}.vtt", captionTrack.BinaryData);
            }
        }
    }
}

移除音訊字幕

若要從音訊框架移除字幕，可使用 ICaptionsCollection 提供的方法，例如 Clear、Remove，或 RemoveAt。以下範例會移除音訊框架中的所有字幕軌。

using (Presentation presentation = new Presentation("audio_with_captions.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IAudioFrame audioFrame = slide.Shapes[0] as IAudioFrame;

    // 移除音訊框架中的所有字幕軌道。
    audioFrame.CaptionTracks.Clear();

    presentation.Save("audio_without_captions.pptx", SaveFormat.Pptx);
}

擷取音訊

Aspose.Slides for .NET 允許您擷取投影片放映過渡時使用的音效。例如，您可以擷取特定投影片所使用的音效。

建立 Presentation類別的實例，並載入包含音訊的簡報。
透過索引取得相關投影片的參照。
存取該投影片的投影片放映過渡設定。
以位元組資料形式擷取音效。

以下 C# 程式碼示範如何擷取投影片中使用的音訊：

string presName = "AudioSlide.pptx";

// 實例化一個代表簡報檔案的 Presentation 類別
Presentation pres = new Presentation(presName);

// 取得投影片
ISlide slide = pres.Slides[0];

// 取得投影片的投影片放映過渡效果
ISlideShowTransition transition = slide.SlideShowTransition;

//Extracts the sound in byte array
byte[] audio = transition.Sound.BinaryData;

System.Console.WriteLine("Length: " + audio.Length);

常見問題

我可以在多張投影片重複使用相同的音訊資產而不會增大檔案大小嗎？

是的。只需將音訊一次加入簡報的共用 audio collection，然後建立其他參考該現有資產的音訊框架。這樣可避免重複媒體資料，保持簡報大小可控。

我可以在不重新建立形狀的情況下替換現有音訊框架中的音效嗎？

是的。對於連結音訊，更新 link path 以指向新檔案。對於嵌入式音訊，將 embedded audio 物件替換為簡報的 audio collection 中的其他音訊。框架的格式與大多數播放設定將保持不變。

修剪會改變簡報中儲存的底層音訊資料嗎？

不會。修剪僅調整播放範圍，原始音訊位元不會被修改，仍可透過嵌入式音訊或簡報的 audio collection 存取。