# Управление аудио в презентациях с использованием PHP > Создавайте и управляйте аудио‑кадрами в Aspose.Slides for PHP - примеры кода для встраивания, обрезки, зацикливания и настройки воспроизведения в презентациях PPT, PPTX и ODP. Source: https://docs.aspose.com/slides/ru/php-java/audio-frame/ Updated: 2026-04-17 ## **Создание аудио‑кадров** Aspose.Slides for PHP via Java позволяет добавлять аудиофайлы на слайды. Аудиофайлы встраиваются в слайды в виде аудио‑кадров. 1. Создайте экземпляр класса [Presentation](https://reference.aspose.com/slides/ru/php-java/aspose.slides/Presentation). 2. Получите ссылку на слайд по его индексу. 3. Загрузите поток аудиофайла, который вы хотите встроить в слайд. 4. Добавьте встроенный аудио‑кадр (содержащий аудиофайл) на слайд. 5. Установите [PlayMode](https://reference.aspose.com/slides/ru/php-java/aspose.slides/AudioPlayModePreset) и `Volume`, доступные у объекта [AudioFrame](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/). 6. Сохраните изменённую презентацию. Этот код PHP показывает, как добавить встроенный аудио‑кадр на слайд: ```php // Создает экземпляр класса Presentation, представляющего файл презентации $pres = new Presentation(); try { # Получает первый слайд $sld = $pres->getSlides()->get_Item(0); # Загружает wav звуковой файл в поток $fstr = new Java("java.io.FileInputStream", new Java("java.io.File", "audio.wav")); # Добавляет аудио‑кадр $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(JavaException e) { } finally { if (!java_is_null($pres)) $pres.dispose(); } ``` ## **Изменение миниатюры аудио‑кадра** Когда вы добавляете аудиофайл в презентацию, он отображается как кадр со стандартным изображением по умолчанию (см. изображение в разделе ниже). Вы можете изменить изображение предварительного просмотра аудио‑кадра (установить желаемое изображение). Этот код PHP показывает, как изменить миниатюру или изображение предварительного просмотра аудио‑кадра: ```php $presentation = new Presentation(); try { $slide = $presentation->getSlides()->get_Item(0); # Добавляет аудио‑кадр на слайд с указанными позицией и размером. $audioStream = new Java("java.io.FileInputStream", "sample2.mp3"); $audioFrame = $slide->getShapes()->addAudioFrameEmbedded(150, 100, 50, 50, $audioStream); $audioStream->close(); # Добавляет изображение в ресурсы презентации. $picture; $image = Images->fromFile("eagle.jpeg"); try { $picture = $presentation->getImages()->addImage($image); } finally { if (!java_is_null($image)) { $image->dispose(); } } # Устанавливает изображение для аудио‑кадра. $audioFrame->getPictureFormat()->getPicture()->setImage($picture);// <----- # Сохраняет изменённую презентацию на диск $presentation->save("example_out.pptx", SaveFormat::Pptx); } catch (JavaException $e) { } finally { if (!java_is_null($presentation)) { $presentation->dispose(); } } ``` ## **Изменение параметров воспроизведения аудио** Aspose.Slides for PHP via Java позволяет менять параметры, управляющие воспроизведением аудио или его свойствами. Например, можно отрегулировать громкость аудио, задать воспроизведение в цикле или даже скрыть значок аудио. Область **Audio Options** в Microsoft PowerPoint: ![example1_image](audio_frame_0.png) Параметры **Audio Options** в PowerPoint, соответствующие свойствам Aspose.Slides [AudioFrame](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/) : - **Start** выпадающий список соответствует методу [AudioFrame::setPlayMode](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setPlayMode) - **Volume** соответствует методу [AudioFrame::setVolume](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setVolume) - **Play Across Slides** соответствует методу [AudioFrame::setPlayAcrossSlides](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setPlayAcrossSlides) - **Loop until Stopped** соответствует методу [AudioFrame::setPlayLoopMode](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setPlayLoopMode) - **Hide During Show** соответствует методу [AudioFrame::setHideAtShowing](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setHideAtShowing) - **Rewind after Playing** соответствует методу [AudioFrame::setRewindAudio](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setRewindAudio) Параметры **Editing** в PowerPoint, соответствующие свойствам Aspose.Slides [AudioFrame](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/) : - **Fade In** соответствует методу [AudioFrame::setFadeInDuration](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setFadeInDuration) - **Fade Out** соответствует методу [AudioFrame::setFadeOutDuration](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setFadeOutDuration) - **Trim Audio Start Time** соответствует методу [AudioFrame::setTrimFromStart](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setTrimFromStart) - **Trim Audio End Time** значение равно продолжительности аудио минус значение метода [AudioFrame::setTrimFromEnd](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setTrimFromEnd) Элемент управления **Volume** в PowerPoint, находящийся на панели управления аудио, соответствует методу [AudioFrame::setVolumeValue](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#setVolumeValue). Он позволяет менять громкость аудио в процентах. Вот как изменить параметры воспроизведения аудио: 1. [Создать](#create-audio-frame) или получите аудио‑кадр. 2. Установите новые значения свойств аудио‑кадра, которые нужно изменить. 3. Сохраните изменённый файл PowerPoint. Этот код PHP демонстрирует операцию, в которой меняются параметры аудио: ```php $pres = new Presentation("AudioFrameEmbed_out.pptx"); try { # Получает форму AudioFrame $audioFrame = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0); # Устанавливает режим воспроизведения на воспроизведение по щелчку $audioFrame->setPlayMode(AudioPlayModePreset->OnClick); # Устанавливает громкость на низкую $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 (!java_is_null($pres)) { $pres->dispose(); } } ``` Этот пример PHP показывает, как добавить новый аудио‑кадр со встроенным аудио, обрезать его и задать длительности затухания: ```php $pres = new Presentation(); try { $slide = $pres->getSlides()->get_Item(0); $audioData = file_get_contents("sampleaudio.mp3"); $audio = $pres->getAudios()->addAudio($audioData); $audioFrame = $slide->getShapes()->addAudioFrameEmbedded(50, 50, 100, 100, $audio); // Устанавливает начальное смещение обрезки в 1.5 секунды $audioFrame->setTrimFromStart(1500); // Устанавливает конечное смещение обрезки в 2 секунды $audioFrame->setTrimFromEnd(2000); // Устанавливает длительность плавного входа в 200 мс $audioFrame->setFadeInDuration(200); // Устанавливает длительность плавного выхода в 500 мс $audioFrame->setFadeOutDuration(500); $pres->save("AudioFrameTrimFade_out.pptx", SaveFormat::Pptx); } finally { $pres->dispose(); } ``` Следующий образец кода показывает, как получить аудио‑кадр со встроенным аудио и установить его громкость на 85%: ```php $pres = new Presentation("AudioFrameEmbed_out.pptx"); try { $slide = $pres->getSlides()->get_Item(0); // Получает форму аудио‑кадра $audioFrame = $slide->getShapes()->get_Item(0); // Устанавливает громкость аудио на 85% $audioFrame->setVolumeValue(85); $pres->save("AudioFrameValue_out.pptx", SaveFormat::Pptx); } finally { $pres->dispose(); } ``` ## **Управление субтитрами аудио** Aspose.Slides позволяет добавлять закрытые субтитры к аудио‑кадру с помощью метода [getCaptionTracks](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#getCaptionTracks). Этот метод возвращает [CaptionsCollection](https://reference.aspose.com/slides/ru/php-java/aspose.slides/captionscollection/), который позволяет добавлять дорожки WebVTT, проходить по существующим дорожкам и при необходимости удалять их. ### **Добавление субтитров к аудио** Используйте метод [getCaptionTracks](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/#getCaptionTracks), чтобы прикрепить одну или несколько дорожек субтитров к аудио‑кадру. В следующем примере аудиофайл добавляется на слайд, а затем новая дорожка субтитров загружается из файла `.vtt`. ```php $presentation = new Presentation(); try { $audioData = file_get_contents("audio.mp3"); $audio = $presentation->getAudios()->addAudio($audioData); $slide = $presentation->getSlides()->get_Item(0); $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`. Каждая дорожка субтитров предоставляет свои двоичные данные и уникальный идентификатор, который можно использовать при экспорте субтитров. ```php $presentation = new Presentation("audio_with_captions.pptx"); try { $slide = $presentation->getSlides()->get_Item(0); $shapeCount = java_values($slide->getShapes()->size()); for ($shapeIndex = 0; $shapeIndex < $shapeCount; $shapeIndex++) { $shape = $slide->getShapes()->get_Item($shapeIndex); if (java_instanceof($shape, new JavaClass("com.aspose.slides.AudioFrame"))) { $audioFrame = $shape; $trackCount = java_values($audioFrame->getCaptionTracks()->getCount()); for ($trackIndex = 0; $trackIndex < $trackCount; $trackIndex++) { $captionTrack = $audioFrame->getCaptionTracks()->get_Item($trackIndex); // Сохранить каждую дорожку субтитров как файл .vtt. $filePath = $captionTrack->getCaptionId() . ".vtt"; file_put_contents($filePath, $captionTrack->getBinaryData()); } } } } finally { $presentation->dispose(); } ``` ### **Удаление субтитров аудио** Чтобы удалить субтитры из аудио‑кадра, используйте методы, предоставляемые [CaptionsCollection](https://reference.aspose.com/slides/ru/php-java/aspose.slides/captionscollection/), такие как [clear](https://reference.aspose.com/slides/ru/php-java/aspose.slides/captionscollection/#clear), [remove](https://reference.aspose.com/slides/ru/php-java/aspose.slides/captionscollection/#remove) или [removeAt](https://reference.aspose.com/slides/ru/php-java/aspose.slides/captionscollection/#removeAt). В следующем примере удаляются все дорожки субтитров из аудио‑кадра. ```php $presentation = new Presentation($folderPath . "audio_with_captions.pptx"); try { $slide = $presentation->getSlides()->get_Item(0); $audioFrame = $slide->getShapes()->get_Item(0); // тип: AudioFrame // Удалить все дорожки субтитров из аудио‑кадра. $audioFrame->getCaptionTracks()->clear(); $presentation->save($folderPath . "audio_without_captions.pptx", SaveFormat::Pptx); } finally { $presentation->dispose(); } ``` ## **Извлечение аудио** Aspose.Slides for PHP via Java позволяет извлекать звук, используемый в переходах слайд‑шоу. Например, можно извлечь звук, используемый в конкретном слайде. 1. Создайте экземпляр класса [Presentation](https://reference.aspose.com/slides/ru/php-java/aspose.slides/Presentation) и загрузите презентацию, содержащую аудио. 2. Получите ссылку на соответствующий слайд по его индексу. 3. Получите доступ к [slideshow transitions](https://reference.aspose.com/slides/ru/php-java/aspose.slides/baseslide/#getSlideShowTransition) для слайда. 4. Извлеките звук в виде байтовых данных. Этот код показывает, как извлечь аудио, используемое в слайде: ```php # Создаёт экземпляр класса Presentation, представляющего файл презентации $pres = new Presentation("AudioSlide.pptx"); $Array = new java_class("java.lang.reflect.Array"); try { # Получает требуемый слайд $slide = $pres->getSlides()->get_Item(0); # Получает эффекты перехода слайд‑шоу для слайда $transition = $slide->getSlideShowTransition(); # Извлекает звук в виде массива байтов $audio = $transition->getSound()->getBinaryData(); echo("Length: " . $Array->getLength($audio)); } finally { if (!java_is_null($pres)) { $pres->dispose(); } } ``` ## **FAQ** **Можно ли повторно использовать один и тот же аудио‑ресурс на нескольких слайдах без увеличения размера файла?** Да. Добавьте аудио один раз в общую [audio collection](https://reference.aspose.com/slides/ru/php-java/aspose.slides/presentation/getaudios/) презентации и создайте дополнительные аудио‑кадры, ссылающиеся на этот существующий ресурс. Это позволяет избежать дублирования медиа‑данных и поддерживать размер презентации под контролем. **Можно ли заменить звук в существующем аудио‑кадре, не создавая заново форму?** Да. Для связанного звука обновите [link path](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/setlinkpathlong/) чтобы указывать на новый файл. Для встроенного звука замените объект [embedded audio](https://reference.aspose.com/slides/ru/php-java/aspose.slides/audioframe/setembeddedaudio/) другим из [audio collection](https://reference.aspose.com/slides/ru/php-java/aspose.slides/presentation/getaudios/). Форматирование кадра и большинство настроек воспроизведения сохраняются. **Изменяет ли обрезка базовые аудио‑данные, хранящиеся в презентации?** Нет. Обрезка изменяет только границы воспроизведения. Исходные байты аудио остаются нетронутыми и доступны через встроенный аудио‑объект или коллекцию аудио презентации.