C++ を使用したプレゼンテーションのオーディオ管理

オーディオフレームの作成

Aspose.Slides for C++ を使用すると、スライドにオーディオファイルを追加できます。オーディオファイルはオーディオフレームとしてスライドに埋め込まれます。

Presentation クラスのインスタンスを作成します。
インデックスを使用してスライドの参照を取得します。
スライドに埋め込むオーディオファイルストリームをロードします。
埋め込まれたオーディオフレーム（オーディオファイルを含む）をスライドに追加します。
IAudioFrame オブジェクトが提供する PlayMode と Volume を設定します。
変更されたプレゼンテーションを保存します。

この C++ コードは、スライドに埋め込みオーディオフレームを追加する方法を示します:

// プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成します
auto pres = System::MakeObject<Presentation>();

// 最初のスライドを取得します
auto sld = pres->get_Slides()->idx_get(0);

// wav サウンド ファイルをストリームにロードします
auto fstr = System::MakeObject<FileStream>(u"sampleaudio.wav", FileMode::Open, FileAccess::Read);

// オーディオ フレームを追加します
auto audioFrame = sld->get_Shapes()->AddAudioFrameEmbedded(50.0f, 150.0f, 100.0f, 100.0f, fstr);

// オーディオの再生モードと音量を設定します
audioFrame->set_PlayMode(AudioPlayModePreset::Auto);
audioFrame->set_Volume(AudioVolumeMode::Loud);

// PowerPoint ファイルをディスクに保存します
pres->Save(u"AudioFrameEmbed_out.pptx", SaveFormat::Pptx);

オーディオフレームのサムネイルを変更する

プレゼンテーションにオーディオファイルを追加すると、標準のデフォルト画像が付いたフレームとして表示されます（下の画像参照）。オーディオフレームのサムネイル（任意の画像）に変更できます。

この C++ コードは、オーディオフレームのサムネイルまたはプレビュー画像を変更する方法を示します:

auto presentation = System::MakeObject<Presentation>();
        
auto slide = presentation->get_Slides()->idx_get(0);
        
// 指定した位置とサイズでスライドにオーディオ フレームを追加します。
auto audioStream = System::MakeObject<System::IO::FileStream>(u"sample2.mp3", 
    System::IO::FileMode::Open, System::IO::FileAccess::Read);
    
auto audioFrame = slide->get_Shapes()->AddAudioFrameEmbedded(150.0f, 100.0f, 50.0f, 50.0f, audioStream);
            
// プレゼンテーションのリソースに画像を追加します。
auto imageStream = System::IO::File::OpenRead(u"eagle.jpeg");
auto audioImage = presentation->get_Images()->AddImage(imageStream);
            
// オーディオ フレームの画像を設定します。
audioFrame->get_PictureFormat()->get_Picture()->set_Image(audioImage); // <-----
        
// 変更されたプレゼンテーションをディスクに保存します
presentation->Save(u"example_out.pptx", Aspose::Slides::Export::SaveFormat::Pptx);

オーディオ再生オプションの変更

Aspose.Slides for C++ では、オーディオの再生やプロパティを制御するオプションを変更できます。たとえば、音量を調整したり、ループ再生に設定したり、オーディオアイコンを非表示にしたりできます。

Microsoft PowerPoint の Audio Options ペイン:

example1_image

PowerPoint の Audio Options が Aspose.Slides の AudioFrame メソッドに対応しています:

Start のドロップダウンリストは AudioFrame::set_PlayMode メソッドに対応しています
Volume は AudioFrame::set_Volume メソッドに対応しています
Play Across Slides は AudioFrame::set_PlayAcrossSlides メソッドに対応しています
Loop until Stopped は AudioFrame::set_PlayLoopMode メソッドに対応しています
Hide During Show は AudioFrame::set_HideAtShowing メソッドに対応しています
Rewind after Playing は AudioFrame::set_RewindAudio メソッドに対応しています

PowerPoint の Editing オプションが Aspose.Slides の AudioFrame プロパティに対応しています:

Fade In は AudioFrame.set_FadeInDuration メソッドに対応しています
Fade Out は AudioFrame.set_FadeOutDuration メソッドに対応しています
Trim Audio Start Time は AudioFrame.set_TrimFromStart メソッドに対応しています
Trim Audio End Time の値は、オーディオの全長から AudioFrame.set_TrimFromEnd メソッドの値を引いたものに相当します

オーディオコントロールパネル上の PowerPoint の Volume controll は AudioFrame.set_VolumeValue メソッドに対応しており、音量をパーセンテージで変更できます。

オーディオ再生オプションを変更する手順:

Audio Frame を作成するか取得します。
調整したいオーディオフレームプロパティに新しい値を設定します。
変更された PowerPoint ファイルを保存します。

この C++ コードは、オーディオのオプションを調整する操作を示します:

auto pres = System::MakeObject<Presentation>(u"AudioFrameEmbed_out.pptx");

// シェイプを取得
auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0);

// シェイプを AudioFrame にキャスト
auto audioFrame = System::ExplicitCast<AudioFrame>(shape);

// 再生モードをクリックで再生に設定
audioFrame->set_PlayMode(AudioPlayModePreset::OnClick);

// 音量を Low に設定
audioFrame->set_Volume(AudioVolumeMode::Low);

// オーディオをスライド間で再生するように設定
audioFrame->set_PlayAcrossSlides(true);

// オーディオのループを無効に設定
audioFrame->set_PlayLoopMode(false);

// スライドショー中に AudioFrame を非表示に設定
audioFrame->set_HideAtShowing(true);

// 再生後にオーディオを先頭に巻き戻すように設定
audioFrame->set_RewindAudio(true);

// PowerPoint ファイルをディスクに保存
pres->Save(u"AudioFrameEmbed_changed.pptx", SaveFormat::Pptx);

この C++ 例は、埋め込みオーディオを持つ新しいオーディオフレームを追加し、トリミングとフェード時間の設定を行う方法を示します:

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

auto audioData = File::ReadAllBytes(u"sampleaudio.mp3");
auto audio = pres->get_Audios()->AddAudio(audioData);
auto audioFrame = slide->get_Shapes()->AddAudioFrameEmbedded(50, 50, 100, 100, audio);

// トリミング開始オフセットを1.5秒に設定します
audioFrame->set_TrimFromStart(1500);
// トリミング終了オフセットを2秒に設定します
audioFrame->set_TrimFromEnd(2000);

// フェードイン時間を200ミリ秒に設定します
audioFrame->set_FadeInDuration(200);
// フェードアウト時間を500ミリ秒に設定します
audioFrame->set_FadeOutDuration(500);

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

以下のコードサンプルは、埋め込みオーディオを持つオーディオフレームを取得し、音量を 85% に設定する方法を示します:

auto pres = MakeObject<Presentation>(u"AudioFrameEmbed_out.pptx");
    
// オーディオ フレーム シェイプを取得します
auto audioFrame = ExplicitCast<IAudioFrame>(pres->get_Slide(0)->get_Shape(0));

// オーディオ ボリュームを85%に設定します
audioFrame->set_VolumeValue(85);

pres->Save(u"AudioFrameValue_out.pptx", SaveFormat::Pptx);
pres->Dispose();

オーディオキャプションの管理

Aspose.Slides では、get_CaptionTracks メソッドを使用してオーディオフレームにクローズドキャプションを追加できます。このメソッドは ICaptionsCollection を返し、WebVTT キャプショントラックの追加、既存トラックの列挙、必要に応じた削除が可能です。

オーディオキャプションの追加

IAudioFrame の get_CaptionTracks メソッドを使用して、1 つ以上のキャプショントラックをオーディオフレームに添付します。以下の例では、スライドにオーディオファイルを追加し、.vtt ファイルから新しいキャプショントラックをロードします。

auto presentation = MakeObject<Presentation>();

auto audioData = File::ReadAllBytes(u"audio.mp3");
auto audio = presentation->get_Audios()->AddAudio(audioData);

auto slide = presentation->get_Slide(0);
auto audioFrame = slide->get_Shapes()->AddAudioFrameEmbedded(10, 10, 50, 50, audio);

// Add a new caption track from a WebVTT file.
audioFrame->get_CaptionTracks()->Add(u"New track", u"track.vtt");

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

オーディオキャプションの抽出

オーディオフレームに関連付けられたキャプショントラックを列挙し、.vtt ファイルとして保存できます。各キャプショントラックはバイナリデータと固有の識別子を公開しており、キャプションのエクスポート時に使用できます。

auto presentation = MakeObject<Presentation>(u"audio_with_captions.pptx");
auto slide = presentation->get_Slide(0);
for (auto&& shape : slide->get_Shapes())
{
    if (ObjectExt::Is<IAudioFrame>(shape))
    {
        auto audioFrame = ExplicitCast<IAudioFrame>(shape);
        for (auto&& captionTrack : audioFrame->get_CaptionTracks())
        {
            // 各キャプショントラックを .vtt ファイルとして保存します。
            auto fileName = captionTrack->get_CaptionId().ToString() + u".vtt";
            File::WriteAllBytes(fileName, captionTrack->get_BinaryData());
        }
    }
}
presentation->Dispose();

オーディオキャプションの削除

キャプションを削除するには、ICaptionsCollection が提供するメソッド（Clear、Remove、RemoveAt など）を使用します。以下の例は、オーディオフレームからすべてのキャプショントラックを削除します。

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

// オーディオ フレームからすべてのキャプショントラックを削除します。
audioFrame->get_CaptionTracks()->Clear();

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

オーディオの抽出

Aspose.Slides では、スライドショーの切り替え時に使用されるサウンドを抽出できます。たとえば、特定のスライドで使用されているサウンドを抽出できます。

オーディオを含むプレゼンテーションをロードするために、Presentation クラスのインスタンスを作成します。
インデックスを使用して対象スライドの参照を取得します。
スライドのスライドショー切り替えを取得します。
サウンドをバイトデータとして抽出します。

この C++ コードは、スライドで使用されているオーディオを抽出する方法を示します:

String presName = u"AudioSlide.pptx";

// プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成します
auto pres = System::MakeObject<Presentation>(presName);

// 目的のスライドにアクセスします
auto slide = pres->get_Slides()->idx_get(0);

// スライドのスライドショー遷移効果を取得します
auto transition = slide->get_SlideShowTransition();

// サウンドをバイト配列として抽出します
auto audio = transition->get_Sound()->get_BinaryData();

Console::WriteLine(String(u"Length: ") + audio->get_Length());

よくある質問

同じオーディオ資産を複数のスライドで再利用して、ファイルサイズが肥大化しないようにできますか？

はい。プレゼンテーションの共有 audio collection にオーディオを一度追加し、既存資産を参照する追加のオーディオフレームを作成します。これによりメディアデータの重複が回避され、プレゼンテーションのサイズが抑えられます。

既存のオーディオフレームのサウンドを形状を作り直さずに差し替えることはできますか？

はい。リンクされたサウンドの場合は、link path を新しいファイルに更新します。埋め込みサウンドの場合は、プレゼンテーションの audio collection から別の埋め込みオーディオオブジェクトに差し替えます。フレームの書式設定とほとんどの再生設定はそのまま保持されます。

トリミングはプレゼンテーションに保存されている基礎オーディオデータを変更しますか？

いいえ。トリミングは再生範囲のみを調整します。元のオーディオバイトは変更されず、埋め込みオーディオまたはプレゼンテーションのオーディオコレクションを通じて引き続きアクセス可能です。