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

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

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

Presentation クラスのインスタンスを作成します。
インデックスを使用してスライドの参照を取得します。
スライドに埋め込むオーディオファイルストリームをロードします。
埋め込まれたオーディオフレーム（オーディオファイルを含む）をスライドに追加します。
AudioFrame オブジェクトが公開する PlayMode と 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 を使用すると、オーディオの再生やプロパティを制御するオプションを変更できます。たとえば、音量を調整したり、ループ再生に設定したり、アイコンを非表示にしたりできます。

Microsoft PowerPoint の Audio Options ペイン:

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 メソッドの値を差し引いたものに相当します。

オーディオコントロールパネルの 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);
    # 音量を 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 (!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 にオーディオを 1 回だけ追加し、その既存アセットを参照する追加のオーディオフレームを作成します。これによりメディアデータの重複が防止され、プレゼンテーションのサイズを抑制できます。

既存のオーディオフレームのサウンドをシェイプを再作成せずに置き換えることはできますか？

はい。リンクされたサウンドの場合は、link path を新しいファイルを指すように更新します。埋め込みサウンドの場合は、embedded audio オブジェクトをプレゼンテーションの audio collection から別のものに差し替えます。フレームの書式設定やほとんどの再生設定はそのまま保持されます。

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

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

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

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

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

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

オーディオの抽出

FAQ

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

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

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