# 使用 PHP 管理演示文稿中的音频

> 在 Aspose.Slides for PHP 中创建和控制音频帧——示例代码演示如何嵌入、修剪、循环以及在 PPT、PPTX 和 ODP 演示文稿中配置播放。

Source: https://docs.aspose.com/slides/zh/php-java/audio-frame/
Updated: 2026-04-17

## **创建音频帧**

Aspose.Slides for PHP via Java 允许您向幻灯片添加音频文件。这些音频文件作为音频帧嵌入到幻灯片中。

1. 创建[Presentation](https://reference.aspose.com/slides/zh/php-java/aspose.slides/Presentation)类的实例。
2. 通过索引获取幻灯片的引用。
3. 加载要嵌入到幻灯片中的音频文件流。
4. 将嵌入的音频帧（包含音频文件）添加到幻灯片中。
5. 设置由[AudioFrame](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/)对象公开的[PlayMode](https://reference.aspose.com/slides/zh/php-java/aspose.slides/AudioPlayModePreset)和 `Volume`。
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 允许您更改控制音频播放或属性的选项。例如，您可以调节音频音量、设置音频循环播放，甚至隐藏音频图标。

Microsoft PowerPoint 中的 **Audio Options** 窗格：

![example1_image](audio_frame_0.png)

PowerPoint **Audio Options** 对应 Aspose.Slides [AudioFrame](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/) 属性：

- **Start** 下拉列表对应 [AudioFrame::setPlayMode](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setPlayMode) 方法
- **Volume** 对应 [AudioFrame::setVolume](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setVolume) 方法
- **Play Across Slides** 对应 [AudioFrame::setPlayAcrossSlides](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setPlayAcrossSlides) 方法
- **Loop until Stopped** 对应 [AudioFrame::setPlayLoopMode](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setPlayLoopMode) 方法
- **Hide During Show** 对应 [AudioFrame::setHideAtShowing](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setHideAtShowing) 方法
- **Rewind after Playing** 对应 [AudioFrame::setRewindAudio](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setRewindAudio) 方法

PowerPoint **Editing** 选项对应 Aspose.Slides [AudioFrame](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/) 属性：

- **Fade In** 对应 [AudioFrame::setFadeInDuration](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setFadeInDuration) 方法
- **Fade Out** 对应 [AudioFrame::setFadeOutDuration](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setFadeOutDuration) 方法
- **Trim Audio Start Time** 对应 [AudioFrame::setTrimFromStart](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setTrimFromStart) 方法
- **Trim Audio End Time** 的值等于音频时长减去 [AudioFrame::setTrimFromEnd](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/#setTrimFromEnd) 方法的值

PowerPoint 音频控制面板上的 **Volume controll** 对应 [AudioFrame::setVolumeValue](https://reference.aspose.com/slides/zh/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/zh/php-java/aspose.slides/audioframe/#getCaptionTracks) 方法为音频帧添加隐藏字幕。此方法返回一个 [CaptionsCollection](https://reference.aspose.com/slides/zh/php-java/aspose.slides/captionscollection/)，您可以使用它添加 WebVTT 字幕轨道、遍历现有轨道，并在需要时将其删除。

**添加音频字幕**

使用 [getCaptionTracks](https://reference.aspose.com/slides/zh/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/zh/php-java/aspose.slides/captionscollection/) 提供的方法，例如 [clear](https://reference.aspose.com/slides/zh/php-java/aspose.slides/captionscollection/#clear)、[remove](https://reference.aspose.com/slides/zh/php-java/aspose.slides/captionscollection/#remove) 或 [removeAt](https://reference.aspose.com/slides/zh/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/zh/php-java/aspose.slides/Presentation)类的实例并加载包含音频的演示文稿。
2. 通过索引获取相关幻灯片的引用。
3. 访问该幻灯片的 [slideshow transitions](https://reference.aspose.com/slides/zh/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();
	}
}
```

## **常见问题**

**我可以在多个幻灯片之间重复使用同一音频资源而不增加文件大小吗？**

可以。将音频一次添加到演示文稿的共享 [audio collection](https://reference.aspose.com/slides/zh/php-java/aspose.slides/presentation/getaudios/) 中，然后创建引用该已有资源的其他音频帧。这可避免媒体数据重复，保持演示文稿尺寸可控。

**我可以在不重新创建形状的情况下替换现有音频帧中的声音吗？**

可以。对于链接的声音，更新 [link path](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/setlinkpathlong/) 以指向新文件。对于嵌入的声音，则将 [embedded audio](https://reference.aspose.com/slides/zh/php-java/aspose.slides/audioframe/setembeddedaudio/) 对象换成演示文稿 [audio collection](https://reference.aspose.com/slides/zh/php-java/aspose.slides/presentation/getaudios/) 中的其他音频。帧的格式和大多数播放设置保持不变。

**修剪会更改演示文稿中存储的底层音频数据吗？**

不会。修剪仅调整播放边界。原始音频字节保持不变，可通过嵌入的音频或演示文稿的音频集合继续访问。