مدیریت صدا در ارائه‌ها با استفاده از PHP

Overview

این مقاله توضیح می‌دهد چگونه با فریم‌های صوتی در Aspose.Slides کار کنید. نشان می‌دهد چگونه صدا را به صورت جاسازی کرده به اسلایدها اضافه کنید، تصویر بندانگشتی فریم صوتی را سفارشی کنید، گزینه‌های پخش مانند حجم، حلقه‌دار شدن، مخفی‌سازی، برش و مدت زمان محو شدن را تنظیم کنید و صداهای مورد استفاده در انتقال‌های نمایش اسلاید را استخراج کنید.

Create Audio Frames

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();
}

Change the Audio Frame Thumbnail

هنگامی که یک فایل صوتی را به یک ارائه اضافه می‌کنید، صدا به‌صورت یک فریم با تصویر پیش‌فرض استاندارد ظاهر می‌شود (تصویر در بخش زیر). می‌توانید تصویر پیش‌نمایش فریم صوتی را (تصویر دلخواه خود را) تغییر دهید.

این کد 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();
	}
}

Change Audio Play Options

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 است. این متد به شما اجازه می‌دهد حجم صدا را به‌صورت درصد تغییر دهید.

این‌گونه می‌توانید گزینه‌های پخش صدا را تغییر دهید:

Сreate یا فریم صوتی را دریافت کنید.
مقادیر جدید برای خواص فریم صوتی که می‌خواهید تنظیم کنید، تعیین کنید.
فایل PowerPoint اصلاح شده را ذخیره کنید.

این کد PHP عملی را نشان می‌دهد که در آن گزینه‌های صدا تنظیم می‌شود:

$pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    # فریم صوتی را دریافت می‌کند
    $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->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();
}

Manage Audio Captions

Aspose.Slides به شما امکان می‌دهد زیرنویس‌های بسته به یک فریم صوتی اضافه کنید از طریق متد getCaptionTracks. این متد یک شیء CaptionsCollection را بر می‌گرداند که به شما اجازه می‌دهد مسیرهای زیرنویس WebVTT را اضافه کنید، بین مسیرهای موجود پیمایش کنید و در صورت نیاز آن‌ها را حذف کنید.

Add Audio Captions

از متد getCaptionTracks برای پیوست یک یا چند مسیر زیرنویس به فریم صوتی استفاده کنید. در مثال زیر، یک فایل صوتی به اسلاید اضافه می‌شود و سپس یک مسیر زیرنویس جدید از یک فایل .vtt بارگذاری می‌شود.

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

Extract Audio Captions

می‌توانید بین مسیرهای زیرنویس مرتبط با فریم صوتی پیمایش کنید و آن‌ها را به‌صورت فایل‌های .vtt ذخیره کنید. هر مسیر زیرنویس داده‌های باینری و شناسه یکتا خود را ارائه می‌دهد که هنگام استخراج زیرنویس‌ها قابل استفاده است.

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

Remove Audio Captions

برای حذف زیرنویس‌ها از فریم صوتی، از متدهای ارائه‌شده توسط CaptionsCollection مانند clear، remove یا removeAt استفاده کنید. مثال زیر تمام مسیرهای زیرنویس را از یک فریم صوتی حذف می‌کند.

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

Extract Audio

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

Can I reuse the same audio asset across multiple slides without inflating the file size?

بله. صدا را یک‌بار به ‌audio collection مشترک ارائه اضافه کنید و فریم‌های صوتی اضافی ایجاد کنید که به آن دارایی موجود ارجاع دهند. این کار از تکرار داده‌های رسانه‌ای جلوگیری می‌کند و اندازه ارائه را تحت کنترل نگه می‌دارد.

Can I replace the sound in an existing audio frame without recreating the shape?

بله. برای صدای پیوند شده، مسیر ‎link path را به فایل جدید تغییر دهید. برای صدای جاسازی شده، شیء ‎embedded audio را با دیگری از ‎audio collection ارائه تعویض کنید. قالب‌بندی فریم و اکثر تنظیمات پخش بدون تغییر باقی می‌مانند.

Does trimming change the underlying audio data stored in the presentation?

خیر. برش تنها مرزهای پخش را تنظیم می‌کند. بایت‌های اصلی صدا بدون تغییر باقی می‌مانند و از طریق صدای جاسازی شده یا ‎audio collection قابل دسترسی هستند.