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

Создание аудио кадров

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

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

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

// Создаёт экземпляр класса Presentation, представляющего файл презентации
Presentation pres = new Presentation();
try {
    // Получает первый слайд
    ISlide sld = pres.getSlides().get_Item(0);

    // Загружает wav звуковой файл в поток
    FileInputStream fstr = new FileInputStream(new File("audio.wav"));

    // Добавляет аудио кадр
    IAudioFrame audioFrame = sld.getShapes().addAudioFrameEmbedded(50, 150, 100, 100, fstr);
    fstr.close();
    
    // Устанавливает режим воспроизведения и громкость аудио
    audioFrame.setPlayMode(AudioPlayModePreset.Auto);
    audioFrame.setVolume(AudioVolumeMode.Loud);

    // Записывает файл PowerPoint на диск
    pres.save("AudioFrameEmbed_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Изменение миниатюры аудио кадра

Когда вы добавляете аудиофайл в презентацию, он отображается в виде кадра со стандартным изображением по умолчанию (см. изображение в разделе ниже). Вы можете изменить изображение предпросмотра аудио кадра (установить желаемое изображение).

Этот пример кода на Java показывает, как изменить миниатюру или изображение предпросмотра аудио кадра:

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // Добавляет аудио кадр на слайд с указанными позицией и размером.
    FileInputStream audioStream = new FileInputStream("sample2.mp3");
    IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.close();

    // Добавляет изображение в ресурсы презентации.
    IPPImage picture;
    IImage image = Images.fromFile("eagle.jpeg");
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Устанавливает изображение для аудио кадра.
    audioFrame.getPictureFormat().getPicture().setImage(picture); // <-----

    //Сохраняет изменённую презентацию на диск
    presentation.save("example_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

Изменение параметров воспроизведения аудио

Aspose.Slides for Java позволяет изменять параметры, управляющие воспроизведением аудио или его свойствами. Например, можно регулировать громкость аудио, установить воспроизведение в цикле или даже скрыть значок аудио.

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

example1_image

Параметры Audio Options в PowerPoint, соответствующие свойствам Aspose.Slides AudioFrame свойства:

Start выпадающий список соответствует методу AudioFrame.setPlayMode.
Volume соответствует методу AudioFrame.setVolume.
Play Across Slides соответствует методу AudioFrame.setPlayAcrossSlides.
Loop until Stopped соответствует методу AudioFrame.setPlayLoopMode.
Hide During Show соответствует методу AudioFrame.setHideAtShowing.
Rewind after Playing соответствует методу AudioFrame.setRewindAudio.

Параметры Editing в PowerPoint, соответствующие свойствам Aspose.Slides AudioFrame свойства:

Fade In соответствует методу AudioFrame.setFadeInDuration.
Fade Out соответствует методу AudioFrame.setFadeOutDuration.
Trim Audio Start Time соответствует методу AudioFrame.setTrimFromStart.
Trim Audio End Time значение равно длительности аудио минус значение метода AudioFrame.setTrimFromEnd.

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

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

Создайте или получите аудио кадр.
Установите новые значения свойств аудио кадра, которые нужно изменить.
Сохраните изменённый файл PowerPoint.

Этот пример кода на Java демонстрирует операцию, в которой изменяются параметры аудио:

Presentation pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    // Получает форму AudioFrame
    AudioFrame audioFrame = (AudioFrame)pres.getSlides().get_Item(0).getShapes().get_Item(0);

    // Устанавливает режим воспроизведения на клик
    audioFrame.setPlayMode(AudioPlayModePreset.OnClick);

    // Устанавливает громкость на Low
    audioFrame.setVolume(AudioVolumeMode.Low);

    // Устанавливает воспроизведение аудио на всех слайдах
    audioFrame.setPlayAcrossSlides(true);

    // Отключает зацикливание аудио
    audioFrame.setPlayLoopMode(false);

    // Скрывает AudioFrame во время показа слайдов
    audioFrame.setHideAtShowing(true);

    // Перематывает аудио к началу после воспроизведения
    audioFrame.setRewindAudio(true);

    // Сохраняет файл PowerPoint на диск
    pres.save("AudioFrameEmbed_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Этот пример кода на Java показывает, как добавить новый аудио кадр с внедрённым аудио, обрезать его и задать продолжительность плавного появления и исчезновения:

Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    
    byte[] audioData = Files.readAllBytes(Paths.get("sampleaudio.mp3"));
    IAudio audio = pres.getAudios().addAudio(audioData);
    IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(50, 50, 100, 100, audio);

    // Устанавливает начало обрезки на 1,5 секунды
    audioFrame.setTrimFromStart(1500f);
    // Устанавливает конец обрезки на 2 секунды
    audioFrame.setTrimFromEnd(2000f);

    // Устанавливает длительность плавного появления (fade-in) 200 мс
    audioFrame.setFadeInDuration(200f);
    // Устанавливает длительность плавного исчезновения (fade-out) 500 мс
    audioFrame.setFadeOutDuration(500f);

    pres.save("AudioFrameTrimFade_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Следующий образец кода показывает, как получить аудио кадр с внедрённым аудио и установить его громкость на 85%:

Presentation pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);

    // Получает форму аудио кадра
    IAudioFrame audioFrame = (IAudioFrame)slide.getShapes().get_Item(0);

    // Устанавливает громкость аудио на 85%
    audioFrame.setVolumeValue(85f);

    pres.save("AudioFrameValue_out.pptx", SaveFormat.Pptx);
}
finally {
    pres.dispose();
}

Управление субтитрами аудио

Aspose.Slides позволяет добавлять закрытые субтитры к аудио кадру с помощью метода getCaptionTracks. Этот метод возвращает объект ICaptionsCollection, который позволяет добавлять дорожки субтитров WebVTT, перебрать существующие дорожки и при необходимости удалять их.

Добавить субтитры к аудио

Используйте метод getCaptionTracks чтобы присоединить одну или несколько дорожек субтитров к аудио кадру. В следующем примере аудиофайл добавляется на слайд, затем новая дорожка субтитров загружается из файла .vtt.

Presentation presentation = new Presentation();
try {
    byte[] audioData = Files.readAllBytes(Paths.get("audio.mp3"));
    IAudio audio = presentation.getAudios().addAudio(audioData);

    ISlide slide = presentation.getSlides().get_Item(0);
    IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(10, 10, 50, 50, audio);

    // Добавить новую дорожку субтитров из файла WebVTT.
    audioFrame.getCaptionTracks().add("New track", "track.vtt");

    presentation.save("audio_with_captions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Извлечь субтитры аудио

Можно перебрать дорожки субтитров, связанные с аудио кадром, и сохранить их как файлы .vtt. Каждая дорожка субтитров предоставляет свои бинарные данные и уникальный идентификатор, который можно использовать при экспорте субтитров.

Presentation presentation = new Presentation("audio_with_captions.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IAudioFrame ) {
            IAudioFrame audioFrame = (IAudioFrame) shape;
            for (ICaptions captionTrack : audioFrame.getCaptionTracks()) {
                // Сохранить дорожку субтитров как файл .vtt.
                Path filePath = Paths.get(captionTrack.getCaptionId() + ".vtt");
                Files.write(filePath, captionTrack.getBinaryData());
            }
        }
    }
} finally {
    presentation.dispose();
}

Удалить субтитры аудио

Чтобы удалить субтитры из аудио кадра, используйте методы, предоставляемые ICaptionsCollection, такие как clear, remove, или removeAt. В следующем примере удаляются все дорожки субтитров из аудио кадра.

Presentation presentation = new Presentation("audio_with_captions.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAudioFrame audioFrame = (IAudioFrame) slide.getShapes().get_Item(0);

    // Удалить все дорожки субтитров из аудио кадра.
    audioFrame.getCaptionTracks().clear();

    presentation.save("audio_without_captions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

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

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

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

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

// Создаёт экземпляр класса Presentation, представляющего файл презентации
Presentation pres = new Presentation("AudioSlide.pptx");
try {
    // Получает нужный слайд
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Получает эффекты перехода слайд-шоу для слайда
    ISlideShowTransition transition = slide.getSlideShowTransition();
    
    // Извлекает звук в массив байтов
    byte[] audio = transition.getSound().getBinaryData();
    System.out.println("Length: " + audio.length);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

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

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

Могу ли я заменить звук в существующем аудио кадре без пересоздания формы?

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

Изменяет ли обрезка фактические аудио данные, хранящиеся в презентации?

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