PHPを使用したプレゼンテーションでのオーディオ管理

オーディオフレームの作成

Aspose.Slides for PHP via Java を使用すると、スライドにオーディオファイルを追加できます。オーディオファイルはスライドにオーディオフレームとして埋め込まれます。

Presentation クラスのインスタンスを作成します。
インデックスを使用してスライドの参照を取得します。
スライドに埋め込むオーディオファイルストリームをロードします。
埋め込みオーディオフレーム（オーディオファイルを含む）をスライドに追加します。
PlayMode と IAudioFrame オブジェクトが提供する Volume を設定します。
変更されたプレゼンテーションを保存します。

この 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);// <-----

	# 変更されたプレゼンテーションをディスクに保存します
	$presentation->save("example_out.pptx", SaveFormat::Pptx);
} catch (JavaException $e) {
} finally {
	if (!java_is_null($presentation)) {
		$presentation->dispose();
	}
}

オーディオ再生オプションの変更

Aspose.Slides for PHP via Java を使用すると、オーディオの再生やプロパティを制御するオプションを変更できます。たとえば、オーディオの音量を調整したり、ループ再生に設定したり、オーディオアイコンを非表示にしたりできます。

The Audio Options pane in Microsoft PowerPoint:

example1_image

PowerPoint Audio Options は、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 メソッドに対応しています。

PowerPoint の Editing オプションは、Aspose.Slides の AudioFrame プロパティに対応しています:

Fade In は AudioFrame.setFadeInDuration メソッドに対応しています。
Fade Out は AudioFrame.setFadeOutDuration メソッドに対応しています。
Trim Audio Start Time は AudioFrame.setTrimFromStart メソッドに対応しています。
Trim Audio End Time の値は、オーディオの長さから AudioFrame.setTrimFromEnd メソッドの値を引いたものに相当します。

PowerPoint のオーディオコントロールパネル上の Volume controll（音量コントロール）は、AudioFrame.setVolumeValue メソッドに対応しています。これにより、音量をパーセンテージで変更できます。

オーディオ再生オプションを変更する手順は次のとおりです：

Сreate または Audio Frame を取得します。
調整したい Audio Frame プロパティの新しい値を設定します。
変更された 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 の例は、埋め込みオーディオを持つ新しいオーディオフレームを追加し、トリムし、フェード時間を設定する方法を示しています:

$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% に設定する方法を示しています:

$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 から別のものに差し替えます。フレームの書式設定やほとんどの再生設定はそのまま保持されます。

トリミングにより、プレゼンテーションに保存されている元のオーディオデータが変更されますか？

いいえ。トリミングは再生範囲のみを調整します。元のオーディオバイトは変更されず、埋め込みオーディオやプレゼンテーションのオーディオコレクションを介して引き続きアクセス可能です。

PHPを使用したプレゼンテーションでのオーディオ管理

オーディオフレームの作成

オーディオ フレーム サムネイルの変更

オーディオ 再生オプションの変更

オーディオの抽出

FAQ

オーディオフレームサムネイルの変更

オーディオ再生オプションの変更