จัดการเฟรมเสียงในงานนำเสนอโดยใช้ C++

ภาพรวม

เฟรมเสียงทำให้คุณสามารถเล่นเสียงบนสไลด์ได้ ด้วย Aspose.Slides for C++ คุณสามารถฝังคลิปเสียง เลือกรูปภาพที่เป็นตัวแทนของมัน ปรับการเล่น และแนบคำบรรยาย คุณยังสามารถดึงเสียงที่กำหนดให้กับการเปลี่ยนสไลด์ได้

สร้างเฟรมเสียง

ใช้ AddAudioFrameEmbedded เพื่อฝังคลิปเสียงในเครื่องบนสไลด์แรก พิกัดสองค่าที่แรกกำหนดตำแหน่งของเฟรมบนสไลด์และค่าถัดไปอีกสองค่ากำหนดความกว้างและความสูง ทั้งหมดเป็นจุด ตัวอย่างนี้เรียก set_PlayMode เพื่อให้คลิปเริ่มเล่นโดยอัตโนมัติและเรียก set_Volume เพื่อเลือกค่าความดังแบบ preset สูง

#include <DOM/AudioPlayModePreset.h>
#include <DOM/AudioVolumeMode.h>
#include <DOM/IAudioFrame.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/io/file.h>
#include <system/io/file_stream.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto audioStream = File::OpenRead(u"audio.wav");
auto audioFrame = slide->get_Shapes()->AddAudioFrameEmbedded(50, 150, 100, 100, audioStream);
audioFrame->set_PlayMode(AudioPlayModePreset::Auto);
audioFrame->set_Volume(AudioVolumeMode::Loud);

presentation->Save(u"AudioFrameEmbed_out.pptx", SaveFormat::Pptx);

เปลี่ยนรูปภาพย่อของเฟรมเสียง

โดยค่าเริ่มต้นเฟรมเสียงจะแสดงไอคอนลำโพง เพื่อแสดงรูปภาพย่อแบบกำหนดเอง ให้เพิ่มรูปภาพลงในงานนำเสนอด้วย AddImage และตั้งเป็นรูปภาพของเฟรมด้วย set_Image. ตัวอย่างใช้ไฟล์ JPEG เป็นรูปภาพย่อสำหรับคลิปเสียงที่ฝัง

#include <DOM/IAudioFrame.h>
#include <DOM/IImageCollection.h>
#include <DOM/IPPImage.h>
#include <DOM/IPictureFillFormat.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/ISlidesPicture.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/io/file.h>
#include <system/io/file_stream.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto imageStream = File::OpenRead(u"eagle.jpeg");
auto thumbnail = presentation->get_Images()->AddImage(imageStream);

auto audioStream = File::OpenRead(u"audio.wav");
auto audioFrame = slide->get_Shapes()->AddAudioFrameEmbedded(150, 100, 50, 50, audioStream);
audioFrame->get_PictureFormat()->get_Picture()->set_Image(thumbnail);

presentation->Save(u"example_out.pptx", SaveFormat::Pptx);

เปลี่ยนตัวเลือกการเล่นเสียง

การควบคุม Audio Options ของ PowerPoint กำหนดว่าเมื่อไหร่คลิปจะเริ่ม, ความดังของเสียง, และพฤติกรรมของมันระหว่างการแสดงสไลด์

การควบคุม Audio Options ของ PowerPoint สำหรับเฟรมเสียง

การควบคุม PowerPoint Aspose.Slides for C++ method
เริ่ม set_PlayMode
ค่าล่วงหน้าความดัง set_Volume
เล่นต่อหลายสไลด์ set_PlayAcrossSlides
วนซ้ำจนหยุด set_PlayLoopMode
ซ่อนระหว่างการแสดง set_HideAtShowing
ย้อนกลับหลังการเล่น set_RewindAudio
จางเข้า set_FadeInDuration
จางออก set_FadeOutDuration
ตัดเวลาเริ่มต้นของเสียง set_TrimFromStart
ตัดเวลาสิ้นสุดของเสียง set_TrimFromEnd
แถบเลื่อนความดัง set_VolumeValue

ตัวอย่างค้นหาเฟรมเสียงแรกบนสไลด์แรก เรียก set_PlayMode เพื่อเริ่มการเล่นเมื่อคลิกและเลือกค่าล่วงหน้าความดังต่ำ คลิปจะเล่นต่อผ่านสไลด์โดยไม่มีการวนซ้ำ ไอคอนจะถูกซ่อนระหว่างการแสดงและคลิปจะย้อนกลับหลังการเล่น

#include <DOM/AudioPlayModePreset.h>
#include <DOM/AudioVolumeMode.h>
#include <DOM/IAudioFrame.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/console.h>
#include <system/enumerator_adapter.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto presentation = MakeObject<Presentation>(u"AudioFrameEmbed_out.pptx");
auto slide = presentation->get_Slide(0);

SharedPtr<IAudioFrame> audioFrame;
for (auto&& shape : IterateOver(slide->get_Shapes()))
{
    audioFrame = AsCast<IAudioFrame>(shape);
    if (audioFrame)
        break;
}

if (audioFrame)
{
    audioFrame->set_PlayMode(AudioPlayModePreset::OnClick);
    audioFrame->set_Volume(AudioVolumeMode::Low);
    audioFrame->set_PlayAcrossSlides(true);
    audioFrame->set_PlayLoopMode(false);
    audioFrame->set_HideAtShowing(true);
    audioFrame->set_RewindAudio(true);

    presentation->Save(u"AudioFrameEmbed_changed.pptx", SaveFormat::Pptx);
}
else
{
    Console::WriteLine(u"The first slide has no audio frame.");
}

สำหรับคลิปที่ยาวกว่า 3.5 วินาที ตัวอย่างนี้จะข้าม 1.5 วินาทีแรกและ 2 วินาทีสุดท้าย อากิวเมนต์ของ set_TrimFromEnd ระบุระยะเวลาที่จะตัดออกจากส่วนท้ายของคลิป เพื่อรับเวลาสิ้นสุดที่แสดงใน PowerPoint ให้ลบค่าชดเชยนี้จากระยะเวลาทั้งหมดของคลิป คลิปที่ตัดจะจางเข้าในเวลา 200 มิลลิวินาทีและจางออกในเวลา 500 มิลลิวินาที ตัวตั้งค่าทั้งสี่รับค่าเป็นมิลลิวินาที

#include <DOM/IAudioFrame.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/io/file.h>
#include <system/io/file_stream.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto audioStream = File::OpenRead(u"audio.wav");
auto audioFrame = slide->get_Shapes()->AddAudioFrameEmbedded(50, 50, 100, 100, audioStream);
audioFrame->set_TrimFromStart(1500);
audioFrame->set_TrimFromEnd(2000);
audioFrame->set_FadeInDuration(200);
audioFrame->set_FadeOutDuration(500);

presentation->Save(u"AudioFrameTrimFade_out.pptx", SaveFormat::Pptx);

หากต้องการตั้งค่าความดังของการเล่นเป็นเปอร์เซ็นต์เฉพาะ ให้ใช้ set_VolumeValue. ตัวอย่างนี้ตั้งค่าความดังของเฟรมเสียงแรกบนสไลด์แรกเป็น 85%

#include <DOM/IAudioFrame.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/console.h>
#include <system/enumerator_adapter.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto presentation = MakeObject<Presentation>(u"AudioFrameEmbed_out.pptx");
auto slide = presentation->get_Slide(0);

SharedPtr<IAudioFrame> audioFrame;
for (auto&& shape : IterateOver(slide->get_Shapes()))
{
    audioFrame = AsCast<IAudioFrame>(shape);
    if (audioFrame)
        break;
}

if (audioFrame)
{
    audioFrame->set_VolumeValue(85);

    presentation->Save(u"AudioFrameValue_out.pptx", SaveFormat::Pptx);
}
else
{
    Console::WriteLine(u"The first slide has no audio frame.");
}

จัดการคำบรรยายเสียง

แต่ละเฟรมเสียงเปิดเผยคอลเลกชันคำบรรยายผ่าน get_CaptionTracks. ใช้เพื่อแนบคำบรรยาย WebVTT ให้กับคลิป ส่งออกแทร็กที่มีอยู่ หรือเอาออก

เพิ่มคำบรรยายเสียง

ตัวอย่างฝังคลิปเสียงบนสไลด์แรกและใช้ ICaptionsCollection::Add เพื่อแนบแทร็ก WebVTT แบบโลคัล อาร์กิวเมนต์แรกให้ป้ายชื่อแทร็ก และอาร์กิวเมนต์ที่สองระบุไฟล์ที่มีคำบรรยายที่กำหนดเวลา

#include <DOM/IAudioFrame.h>
#include <DOM/ICaptions.h>
#include <DOM/ICaptionsCollection.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/io/file.h>
#include <system/io/file_stream.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;
using namespace System::IO;

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto audioStream = File::OpenRead(u"audio.wav");
auto audioFrame = slide->get_Shapes()->AddAudioFrameEmbedded(10, 10, 50, 50, audioStream);
audioFrame->get_CaptionTracks()->Add(u"English", u"track.vtt");

presentation->Save(u"audio_with_captions.pptx", SaveFormat::Pptx);

ส่งออกคำบรรยายเสียง

ตัวอย่างนี้ส่งออกแทร็กคำบรรยายแต่ละแทร็กที่แนบกับเฟรมเสียงบนสไลด์แรก เขียนไบต์ที่ได้จาก get_BinaryData ไปยังไฟล์ WebVTT และใช้ค่าที่ได้จาก get_CaptionId เป็นชื่อไฟล์ เพื่อให้แต่ละแทร็กมีผลลัพธ์แยกกัน

#include <DOM/IAudioFrame.h>
#include <DOM/ICaptions.h>
#include <DOM/ICaptionsCollection.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <system/enumerator_adapter.h>
#include <system/io/file.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace System;
using namespace System::IO;

auto presentation = MakeObject<Presentation>(u"audio_with_captions.pptx");
auto slide = presentation->get_Slide(0);

for (auto&& shape : IterateOver(slide->get_Shapes()))
{
    auto audioFrame = AsCast<IAudioFrame>(shape);
    if (!audioFrame)
        continue;

    for (auto&& track : IterateOver(audioFrame->get_CaptionTracks()))
    {
        auto fileName = track->get_CaptionId().ToString() + u".vtt";
        File::WriteAllBytes(fileName, track->get_BinaryData());
    }
}

ลบคำบรรยายเสียง

ใช้ Remove หรือ RemoveAt เพื่อลบแทร็กเดี่ยว ตัวอย่างนี้ใช้ Clear เพื่อลบคำบรรยายทั้งหมดจากเฟรมเสียงแรกบนสไลด์แรกโดยคงคลิปไว้

#include <DOM/IAudioFrame.h>
#include <DOM/ICaptions.h>
#include <DOM/ICaptionsCollection.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <system/console.h>
#include <system/enumerator_adapter.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System;

auto presentation = MakeObject<Presentation>(u"audio_with_captions.pptx");
auto slide = presentation->get_Slide(0);

SharedPtr<IAudioFrame> audioFrame;
for (auto&& shape : IterateOver(slide->get_Shapes()))
{
    audioFrame = AsCast<IAudioFrame>(shape);
    if (audioFrame)
        break;
}

if (audioFrame)
{
    audioFrame->get_CaptionTracks()->Clear();

    presentation->Save(u"audio_without_captions.pptx", SaveFormat::Pptx);
}
else
{
    Console::WriteLine(u"The first slide has no audio frame.");
}

ค้นบรรทัดในคำบรรยายเสียง

เพื่อค้นหาบรรทัดในคำบรรยายเสียงบนสไลด์แรก ให้เรียก get_DataAsString บนแต่ละแทร็กเพื่ออ่านข้อความ WebVTT ในหน่วยความจำ ในคิว WebVTT แบบข้อความธรรมดา บรรทัดเวลาเป็น -->, บรรทัดคำบรรยายตามหลัง และบรรทัดว่างจะสิ้นสุดคิว ตัวอย่างนี้พิมพ์ป้ายชื่อแทร็กและแต่ละบรรทัดคำบรรยายที่มีคำว่า “café”

#include <DOM/IAudioFrame.h>
#include <DOM/ICaptions.h>
#include <DOM/ICaptionsCollection.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <system/enumerator_adapter.h>
#include <system/io/string_reader.h>
#include <system/smart_ptr.h>
#include <system/string_comparison.h>

using namespace Aspose::Slides;
using namespace System;
using namespace System::IO;

auto presentation = MakeObject<Presentation>(u"audio_with_captions.pptx");
auto slide = presentation->get_Slide(0);

for (auto&& shape : IterateOver(slide->get_Shapes()))
{
    auto audioFrame = AsCast<IAudioFrame>(shape);
    if (!audioFrame)
        continue;

    for (auto&& track : IterateOver(audioFrame->get_CaptionTracks()))
    {
        auto reader = MakeObject<StringReader>(track->get_DataAsString());
        auto inCue = false;
        for (auto line = reader->ReadLine(); !line.IsNull(); line = reader->ReadLine())
        {
            if (line.get_Length() == 0)
                inCue = false;
            else if (line.Contains(u"-->"))
                inCue = true;
            else if (inCue && line.IndexOf(u"caf\u00e9", StringComparison::OrdinalIgnoreCase) >= 0)
                Console::WriteLine(track->get_Label() + u": " + line);
        }
    }
}

สกัดเสียง

การเปลี่ยนสไลด์สามารถมีเสียงของตัวเองได้ เพื่อดึงออกให้เรียก get_Sound บนการเปลี่ยน หากตัวอย่างนี้ดึงไบต์เสียงด้วย get_BinaryData และพิมพ์จำนวนไบต์ หากสไลด์แรกไม่มีเสียงการเปลี่ยน จะพิมพ์ข้อความแทน

#include <DOM/IAudio.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideShowTransition.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <system/smart_ptr.h>

using namespace Aspose::Slides;
using namespace System;

auto presentation = MakeObject<Presentation>(u"AudioSlide.pptx");
auto slide = presentation->get_Slide(0);

auto sound = slide->get_SlideShowTransition()->get_Sound();
if (sound)
{
    auto audioData = sound->get_BinaryData();
    Console::WriteLine(u"Transition sound: {0} bytes.", audioData->get_Length());
}
else
{
    Console::WriteLine(u"The first slide has no transition sound.");
}

คำถามที่พบบ่อย

ฉันสามารถใช้คลิปเสียงเดียวกันบนหลายสไลด์โดยไม่ต้องทำซ้ำได้หรือไม่?

ใช่. เพิ่มคลิปเพียงครั้งเดียวใน audio collection ของงานนำเสนอและส่งออบเจ็กต์เสียงเดียวกันไปยัง AddAudioFrameEmbedded สำหรับแต่ละสไลด์

ฉันสามารถเปลี่ยนเสียงในเฟรมเสียงที่มีอยู่ได้หรือไม่?

ใช่. สำหรับเสียงที่เชื่อมโยง ให้เรียก set_LinkPathLong พร้อมพาธไปยังไฟล์ที่ต้องการแทนที่. สำหรับเสียงที่ฝัง, ส่งคลิปอื่นจาก audio collection ของงานนำเสนอไปยัง set_EmbeddedAudio. ทั้งสองวิธีจะคงเฟรมเดิมไว้

การตัดทำให้ข้อมูลเสียงที่เก็บในงานนำเสนอเปลี่ยนหรือไม่?

ไม่. set_TrimFromStart และ set_TrimFromEnd กำหนดขอบเขตการเล่น คุณยังสามารถดึงคลิปเต็มจาก get_EmbeddedAudio ได้