จัดการเฟรมเสียงในงานนำเสนอโดยใช้ 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 กำหนดว่าเมื่อไหร่คลิปจะเริ่ม, ความดังของเสียง, และพฤติกรรมของมันระหว่างการแสดงสไลด์

| การควบคุม 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 ได้