إدارة إطارات الصوت في العروض التقديمية باستخدام Python
نظرة عامة
إطار صوتي يتيح لك تشغيل صوت على شريحة. مع Aspose.Slides للـ Python عبر .NET، يمكنك تضمين مقطع صوتي، اختيار الصورة التي تمثله، تعديل التشغيل، وإرفاق التسميات التوضيحية. يمكنك أيضًا استرداد صوت مرتبط بانتقال الشريحة.
إنشاء إطارات صوتية
استخدم add_audio_frame_embedded لتضمين مقطع صوتي محلي على الشريحة الأولى. الإحداثيان الأولان يحددان موضع الإطار على الشريحة، والقيمتان التاليان تحددان العرض والارتفاع، جميعها بوحدات النقاط. يحدد هذا المثال play_mode لتشغيل المقطع تلقائيًا و volume إلى إعداد الصوت العالي.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
with open("audio.wav", "rb") as audio_stream:
audio_frame = slide.shapes.add_audio_frame_embedded(50, 150, 100, 100, audio_stream)
audio_frame.play_mode = slides.AudioPlayModePreset.AUTO
audio_frame.volume = slides.AudioVolumeMode.LOUD
presentation.save("AudioFrameEmbed_out.pptx", slides.export.SaveFormat.PPTX)
تغيير صورة الإطار الصوتي
بشكل افتراضي، يعرض الإطار الصوتي أيقونة مكبر صوت. لعرض صورة مصغرة مخصصة، أضف صورة إلى العرض التقديمي باستخدام add_image وعينها لخاصية picture_format.picture.image للإطار. يستخدم المثال ملف JPEG كصورة مصغرة لمقطع صوتي مضمّن.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
with open("eagle.jpeg", "rb") as image_stream:
thumbnail = presentation.images.add_image(image_stream)
with open("audio.wav", "rb") as audio_stream:
audio_frame = slide.shapes.add_audio_frame_embedded(150, 100, 50, 50, audio_stream)
audio_frame.picture_format.picture.image = thumbnail
presentation.save("example_out.pptx", slides.export.SaveFormat.PPTX)
تغيير خيارات تشغيل الصوت
تتحكم عناصر Audio Options في PowerPoint في متى يبدأ المقطع، ومدى صوته، وكيفية تصرفه خلال عرض الشرائح.

| تحكم PowerPoint | خاصية Aspose.Slides |
|---|---|
| ابدأ | play_mode |
| إعداد مستوى الصوت | volume |
| تشغيل عبر الشرائح | play_across_slides |
| تكرار حتى الإيقاف | play_loop_mode |
| إخفاء أثناء العرض | hide_at_showing |
| إعادة للأمام بعد التشغيل | rewind_audio |
| تلاشي الدخول | fade_in_duration |
| تلاشي الخروج | fade_out_duration |
| تقليم بدء الصوت | trim_from_start |
| تقليم نهاية الصوت | trim_from_end |
| شريط مستوى الصوت | volume_value |
يجد المثال الإطار الصوتي الأول على الشريحة الأولى، ويضبط play_mode لتشغيل المقطع عند النقر، ويختار إعداد الصوت المنخفض. يستمر المقطع عبر الشرائح مع تعطيل التكرار. تظل الأيقونة مخفية أثناء العرض، ويعيد المقطع تشغيله من البداية بعد الانتهاء.
import aspose.slides as slides
with slides.Presentation("AudioFrameEmbed_out.pptx") as presentation:
slide = presentation.slides[0]
audio_frame = next((shape for shape in slide.shapes if isinstance(shape, slides.AudioFrame)), None)
if audio_frame is None:
print("The first slide has no audio frame.")
else:
audio_frame.play_mode = slides.AudioPlayModePreset.ON_CLICK
audio_frame.volume = slides.AudioVolumeMode.LOW
audio_frame.play_across_slides = True
audio_frame.play_loop_mode = False
audio_frame.hide_at_showing = True
audio_frame.rewind_audio = True
presentation.save("AudioFrameEmbed_changed.pptx", slides.export.SaveFormat.PPTX)
للمقطع الذي يزيد طوله عن 3.5 ثانية، يتخطى هذا المثال الثواني الأولى 1.5 والثانية الأخيرة 2. يقيس trim_from_end المدة التي يجب حذفها من نهاية المقطع. للحصول على وقت النهاية المعروض في PowerPoint، اطرح هذا الإزاحة من المدة الكاملة للمقطع. يتلاشى المقطع المُقَصَّى خلال 200 مللي ثانية ويتلاشى الخروج خلال 500 مللي ثانية. جميع الخصائص الأربعة تأخذ قيمًا بالمللي ثانية.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
with open("audio.wav", "rb") as audio_stream:
audio_frame = slide.shapes.add_audio_frame_embedded(50, 50, 100, 100, audio_stream)
audio_frame.trim_from_start = 1500.0
audio_frame.trim_from_end = 2000.0
audio_frame.fade_in_duration = 200.0
audio_frame.fade_out_duration = 500.0
presentation.save("AudioFrameTrimFade_out.pptx", slides.export.SaveFormat.PPTX)
لتعيين مستوى تشغيل الصوت بنسبة مئوية محددة، استخدم volume_value. يحدد المثال الإطار الصوتي الأول على الشريحة الأولى إلى 85٪.
import aspose.slides as slides
with slides.Presentation("AudioFrameEmbed_out.pptx") as presentation:
slide = presentation.slides[0]
audio_frame = next((shape for shape in slide.shapes if isinstance(shape, slides.AudioFrame)), None)
if audio_frame is None:
print("The first slide has no audio frame.")
else:
audio_frame.volume_value = 85.0
presentation.save("AudioFrameValue_out.pptx", slides.export.SaveFormat.PPTX)
إدارة تسميات الصوت
كل إطار صوتي يحتوي على مجموعة caption_tracks. استخدمها لإرفاق تسميات WebVTT بالمقطع، أو تصدير المسارات الموجودة، أو إزالتها.
إضافة تسميات صوتية
يضمّن المثال مقطع صوتي على الشريحة الأولى ويستخدم CaptionsCollection.add لإرفاق مسار WebVTT محلي. يُعطي الوسيط الأول تسمية المسار، والوسيط الثاني يحدد الملف الذي يحتوي على التسميات الزمنية.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
with open("audio.wav", "rb") as audio_stream:
audio_frame = slide.shapes.add_audio_frame_embedded(10, 10, 50, 50, audio_stream)
audio_frame.caption_tracks.add("English", "track.vtt")
presentation.save("audio_with_captions.pptx", slides.export.SaveFormat.PPTX)
استخراج تسميات الصوت
يصدّر هذا المثال كل مسار تسميات مرفق بإطار صوتي على الشريحة الأولى. يكتب البيانات الثنائية للمسار binary_data إلى ملف WebVTT ويستخدم caption_id كاسم للملف بحيث يكون لكل مسار مخرج منفصل.
import aspose.slides as slides
with slides.Presentation("audio_with_captions.pptx") as presentation:
slide = presentation.slides[0]
for shape in slide.shapes:
if isinstance(shape, slides.AudioFrame):
for track in shape.caption_tracks:
with open(f"{track.caption_id}.vtt", "wb") as output:
output.write(track.binary_data)
إزالة تسميات الصوت
استخدم remove أو remove_at لحذف مسار فردي. يستخدم المثال clear لإزالة جميع التسميات من الإطار الصوتي الأول على الشريحة الأولى مع الحفاظ على المقطع.
import aspose.slides as slides
with slides.Presentation("audio_with_captions.pptx") as presentation:
slide = presentation.slides[0]
audio_frame = next((shape for shape in slide.shapes if isinstance(shape, slides.AudioFrame)), None)
if audio_frame is None:
print("The first slide has no audio frame.")
else:
audio_frame.caption_tracks.clear()
presentation.save("audio_without_captions.pptx", slides.export.SaveFormat.PPTX)
العثور على سطر في تسميات الصوت
للعثور على سطر في تسميات الصوت على الشريحة الأولى، اقرأ data_as_string لكل مسار في الذاكرة. في إشارة WebVTT نصية عادية، يحتوي سطر التوقيت على -->، وتلي ذلك سطور التسميات، وينتهي الإشارة بسطر فارغ. يطبع المثال تسمية المسار وكل سطر تسميات يحتوي على كلمة “café”.
import aspose.slides as slides
with slides.Presentation("audio_with_captions.pptx") as presentation:
slide = presentation.slides[0]
for shape in slide.shapes:
if isinstance(shape, slides.AudioFrame):
for track in shape.caption_tracks:
in_cue = False
for line in track.data_as_string.splitlines():
if not line:
in_cue = False
elif "-->" in line:
in_cue = True
elif in_cue and "café" in line.casefold():
print(f"{track.label}: {line}")
استخراج الصوت
يمكن أن يحتوي انتقال الشريحة على صوت خاص به. لاسترداده، اقرأ خاصية sound للانتقال. يصل المثال إلى البيانات الثنائية binary_data للصوت ويطبع حجمه بالبايت. إذا لم تكن الشريحة الأولى تحتوي على صوت للانتقال، يطبع رسالة بدلاً من ذلك.
import aspose.slides as slides
with slides.Presentation("AudioSlide.pptx") as presentation:
slide = presentation.slides[0]
sound = slide.slide_show_transition.sound
if sound is None:
print("The first slide has no transition sound.")
else:
audio_data = sound.binary_data
print(f"Transition sound: {len(audio_data)} bytes.")
الأسئلة الشائعة
هل يمكنني إعادة استخدام نفس المقطع الصوتي عبر شرائح متعددة دون تكراره؟
نعم. أضف المقطع مرة واحدة إلى audio collection الخاصة بالعرض التقديمي، ثم مرر كائن الصوت نفسه إلى add_audio_frame_embedded لكل شريحة.
هل يمكنني استبدال الصوت في إطار صوتي موجود؟
نعم. بالنسبة لصوت مرتبط، حدّث link_path_long للإشارة إلى ملف الاستبدال. بالنسبة لصوت مضمّن، عيّن مقطعًا آخر من مجموعة الأصوات في العرض التقديمي إلى embedded_audio. كلا الطريقتين تحافظان على الإطار الحالي.
هل يؤثر التقليم على بيانات الصوت المخزنة في العرض التقديمي؟
لا. يحدد كل من trim_from_start وtrim_from_end حدود تشغيل المقطع. لا يزال بإمكانك استرداد المقطع الكامل من embedded_audio.