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

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

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

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

Этот 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‑код показывает, как изменить миниатюру или изображение предварительного просмотра аудио‑кадра:

$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);// <-----

	# Saves the modified presentation to disk
	$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 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.

Этот 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 показывает, как добавить новый аудио‑кадр со встроенным аудио, обрезать его и задать длительности fade:

$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);

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

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

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

$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 for PHP via Java позволяет извлекать звук, используемый в переходах слайд‑шоу. Например, можно извлечь звук, использованный в конкретном слайде.

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

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

# Создаёт объект класса 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 презентации и создайте дополнительные аудио‑кадры, ссылающиеся на этот существующий ресурс. Это предотвращает дублирование медиа‑данных и держит размер презентации под контролем.

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

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