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

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

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

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

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

import aspose.slides as slides

# プレゼンテーション ファイルを表すプレゼンテーションクラスのインスタンス化
with slides.Presentation() as pres:
    # 最初のスライドを取得
    sld = pres.slides[0]

    # wav サウンド ファイルをストリームにロード
    with open(path + "sampleaudio.wav", "rb") as in_file:
        # オーディオ フレームを追加
        audio_frame = sld.shapes.add_audio_frame_embedded(50, 150, 100, 100, in_file)

        # オーディオの再生モードと音量を設定
        audio_frame.play_mode = slides.AudioPlayModePreset.AUTO
        audio_frame.volume = slides.AudioVolumeMode.LOUD

        # PowerPoint ファイルをディスクに保存
        pres.save("AudioFrameEmbed_out.pptx", slides.export.SaveFormat.PPTX)

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

プレゼンテーションにオーディオファイルを追加すると、オーディオは標準のデフォルト画像を持つフレームとして表示されます（下のセクションの画像を参照）。オーディオフレームのサムネイルを変更できます（好みの画像を設定）。

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

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # 指定された位置とサイズでスライドにオーディオ フレームを追加します。
    with open("sample2.mp3", "rb") as audio_fs:
        audioFrame = slide.shapes.add_audio_frame_embedded(150, 100, 50, 50, audio_fs)

        # プレゼンテーションのリソースに画像を追加します。
        with open("eagle.jpeg", "rb") as image_fs:
            data = image_fs.read()
        
        audioImage = presentation.images.add_image(data)

        # オーディオ フレームの画像を設定します。
        audioFrame.picture_format.picture.image = audioImage
        
        #変更されたプレゼンテーションをディスクに保存します
        presentation.save("example_out.pptx", slides.export.SaveFormat.PPTX)

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

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

Microsoft PowerPoint の Audio Options パネル:

example1_image

PowerPoint の Audio Options は、Aspose.Slides の AudioFrame プロパティに対応しています:

Start ドロップダウンリストは AudioFrame.play_mode プロパティと一致します
Volume は AudioFrame.volume プロパティと一致します
Play Across Slides は AudioFrame.play_across_slides プロパティと一致します
Loop until Stopped は AudioFrame.play_loop_mode プロパティと一致します
Hide During Show は AudioFrame.hide_at_showing プロパティと一致します
Rewind after Playing は AudioFrame.rewind_audio プロパティと一致します

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

Fade In は AudioFrame.fade_in_duration プロパティと一致します
Fade Out は AudioFrame.fade_out_duration プロパティと一致します
Trim Audio Start Time は AudioFrame.trim_from_start プロパティと一致します
Trim Audio End Time の値は、オーディオの長さから AudioFrame.trim_from_end プロパティの値を引いたものに等しいです

PowerPoint のオーディオコントロールパネル上の Volume controll は AudioFrame.volume_value プロパティに対応しています。音量をパーセンテージで変更できます。

オーディオ再生オプションを変更する方法は次のとおりです：

Сreate または Audio Frame を取得します。
調整したい Audio Frame プロパティに新しい値を設定します。
変更された PowerPoint ファイルを保存します。

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

import aspose.slides as slides

with slides.Presentation("AudioFrameEmbed_out.pptx") as pres:
    # AudioFrame シェイプを取得します
    audioFrame = pres.slides[0].shapes[0]

    # 再生モードをクリック時再生に設定
    audioFrame.play_mode = slides.AudioPlayModePreset.ON_CLICK

    # ボリュームを低に設定
    audioFrame.volume = slides.AudioVolumeMode.LOW

    # オーディオをスライド全体で再生するように設定
    audioFrame.play_across_slides = True

    # オーディオのループ再生を無効化
    audioFrame.play_loop_mode = False

    # スライドショー中に AudioFrame を非表示にする
    audioFrame.hide_at_showing = True

    # 再生後にオーディオを開始位置に巻き戻す
    audioFrame.rewind_audio = True

    # PowerPoint ファイルをディスクに保存
    pres.save("AudioFrameEmbed_changed.pptx", slides.export.SaveFormat.PPTX)

この Python の例は、埋め込みオーディオを持つ新しいオーディオフレームを追加し、トリムし、フェード時間を設定する方法を示します：

with slides.Presentation() as pres:
    slide = pres.slides[0]

    with open("sampleaudio.mp3", "rb") as audio_stream:
        audio_data = audio_stream.read()

    audio = pres.audios.add_audio(audio_data)
    audio_frame = slide.shapes.add_audio_frame_embedded(50, 50, 100, 100, audio)

    # トリミング開始オフセットを 1.5 秒に設定
    audio_frame.trim_from_start = 1500.0
    # トリミング終了オフセットを 2 秒に設定
    audio_frame.trim_from_end = 2000.0

    # フェードイン時間を 200 ミリ秒に設定
    audio_frame.fade_in_duration = 200.0
    # フェードアウト時間を 500 ミリ秒に設定
    audio_frame.fade_out_duration = 500.0

    pres.save("AudioFrameTrimFade_out.pptx", slides.export.SaveFormat.PPTX)

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

with slides.Presentation("AudioFrameEmbed_out.pptx") as pres:
    # オーディオ フレーム シェイプを取得します
    audio_frame = pres.slides[0].shapes[0]

    # オーディオ ボリュームを 85% に設定します
    audio_frame.volume_value = 85.0

    pres.save("AudioFrameValue_out.pptx", slides.export.SaveFormat.PPTX)

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

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

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

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

with slides.Presentation() as presentation:
    with open("audio.mp3", "rb") as audio_stream:
        audio = presentation.audios.add_audio(audio_stream.read())

    slide = presentation.slides[0]
    audio_frame = slide.shapes.add_audio_frame_embedded(10, 10, 50, 50, audio)

    # WebVTT ファイルから新しいキャプショントラックを追加します。
    presentation.save("audio_with_captions.pptx", slides.export.SaveFormat.PPTX)

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

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

with slides.Presentation("audio_with_captions.pptx") as presentation:
    slide = presentation.slides[0]
    for shape in slide.shapes:
        if isinstance(shape, slides.AudioFrame):
            audio_frame = shape
            for caption_track in audio_frame.caption_tracks:
                # キャプショントラックを .vtt ファイルとして保存します。
                with open(f"{caption_track.caption_id}.vtt", "wb") as track_stream:
                    track_stream.write(caption_track.binary_data)

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

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

with slides.Presentation("audio_with_captions.pptx") as presentation:
    slide = presentation.slides[0]
    audio_frame = slide.shapes[0]  # type: slides.AudioFrame

    # audio_frame からすべてのキャプショントラックを削除します。
    audio_frame.caption_tracks.clear()

    presentation.save("audio_without_captions.pptx", slides.export.SaveFormat.PPTX)

オーディオの抽出

Aspose.Slides for Python via .NET を使用すると、スライドショーの遷移で使用されるサウンドを抽出できます。たとえば、特定のスライドで使用されるサウンドを抽出できます。

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

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

import aspose.slides as slides

#slides.Presentation("AudioSlide.pptx") を使用
with slides.Presentation("AudioFrameEmbed_changed.pptx") as pres:
    # 対象スライドにアクセス
    slide = pres.slides[0]  

    # スライドのスライドショー遷移効果を取得
    transition = slide.slide_show_transition

    #サウンドをバイト配列で抽出
    audio = transition.sound.binary_data

    print("Length: " + str(len(audio)))

FAQ

同じオーディオ資産を複数のスライドで再利用して、ファイルサイズを増大させずに済みますか？

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

既存のオーディオフレームのサウンドを、シェイプを再作成せずに置き換えられますか？

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

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

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