Управление аудио в презентациях с использованием Python

Создать аудио‑кадры

Aspose.Slides for Python via .NET позволяет добавлять аудиофайлы на слайды. Аудиофайлы встраиваются в слайды как аудио‑кадры.

Создайте экземпляр класса Презентация.
Получите ссылку на слайд по его индексу.
Загрузите поток аудиофайла, который хотите встроить в слайд.
Добавьте встроенный аудио‑кадр (содержащий аудиофайл) на слайд.
Установите PlayMode и Volume, доступные через объект IAudioFrame.
Сохраните изменённую презентацию.

Этот пример кода на 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 позволяет менять параметры, управляющие воспроизведением аудио. Например, можно отрегулировать громкость, задать зацикливание или скрыть значок аудио.

Область Audio Options в Microsoft PowerPoint:

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

Ползунок Volume control на панели управления аудио в PowerPoint соответствует свойству AudioFrame.volume_value. Он позволяет менять громкость аудио в процентах.

Как изменить параметры воспроизведения аудио:

Создайте или получите аудио‑кадр.
Установите новые значения нужных свойств аудио‑кадра.
Сохраните изменённый файл 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, чтобы привязать один или несколько треков субтитров к аудио‑кадру. В примере ниже аудиофайл добавляется на слайд, после чего из файла .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.
    audio_frame.caption_tracks.add("New track", "track.vtt")

    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]  # тип: slides.AudioFrame

    # Удалите все треки субтитров из аудио‑кадра.
    audio_frame.caption_tracks.clear()

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

Извлечение аудио

Aspose.Slides for Python via .NET позволяет извлекать звук, используемый в переходах слайд‑шоу. Например, можно извлечь звук, применённый к конкретному слайду.

Создайте экземпляр класса Презентация и загрузите презентацию, содержащую аудио.
Получите ссылку на нужный слайд по его индексу.
Получите доступ к переходам слайд‑шоу для этого слайда.
Извлеките звук в виде байтовых данных.

Этот пример кода на Python показывает, как извлечь аудио, используемое в слайде:

import aspose.slides as slides

#with slides.Presentation("AudioFrameEmbed_changed.pptx") as pres:
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

Можно ли использовать один и тот же аудио‑ресурс на нескольких слайдах без увеличения размера файла?

Да. Добавьте аудио один раз в общую коллекцию аудио презентации и создайте дополнительные аудио‑кадры, которые ссылаются на этот существующий ресурс. Это предотвращает дублирование мультимедийных данных и сохраняет размер презентации под контролем.

Можно ли заменить звук в существующем аудио‑кадре, не пересоздавая форму?

Да. Для связанного звука обновите link path, чтобы он указывал на новый файл. Для встроенного звука замените объект embedded audio другим из коллекции аудио презентации. Форматирование кадра и большинство настроек воспроизведения останутся прежними.

Меняется ли фактический аудиофайл в презентации при обрезке?

Нет. Обрезка изменяет только границы воспроизведения. Исходные байты аудио остаются нетронутыми и доступны через встроенный аудио‑объект или коллекцию аудио презентации.