Správa audio rámečků v prezentacích pomocí Pythonu
Přehled
Audio rámeček vám umožní přehrát zvuk na snímku. S Aspose.Slides pro Python via .NET můžete vložit audio klip, zvolit obrázek, který jej představuje, nastavit přehrávání a připojit titulky. Také můžete získat zvuk přiřazený k přechodu snímku.
Vytvoření audio rámečků
Použijte add_audio_frame_embedded pro vložení lokálního audio klipu na první snímek. První dvě souřadnice určují polohu rámečku na snímku a následující dva hodnoty nastavují jeho šířku a výšku, vše v bodech. Tento příklad nastavuje play_mode tak, aby klip začal automaticky, a volume na přednastavenou hlasitost.
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)
Změna miniatury audio rámečku
Ve výchozím nastavení audio rámeček zobrazuje ikonu reproduktoru. Pro zobrazení vlastní miniatury přidejte obrázek do prezentace pomocí add_image a přiřaďte jej k vlastnosti picture_format.picture.image rámečku. Příklad používá JPEG jako miniaturu pro vložený audio klip.
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)
Změna možností přehrávání audia
Ovládací prvky Audio Options v PowerPointu určují, kdy klip začne, jak hlasitý je a jak se chová během prezentace.

| Ovládací prvek PowerPointu | Vlastnost Aspose.Slides |
|---|---|
| Start | play_mode |
| Volume preset | volume |
| Play Across Slides | play_across_slides |
| Loop until Stopped | play_loop_mode |
| Hide During Show | hide_at_showing |
| Rewind after Playing | rewind_audio |
| Fade In | fade_in_duration |
| Fade Out | fade_out_duration |
| Trim Audio start time | trim_from_start |
| Trim Audio end time | trim_from_end |
| Volume slider | volume_value |
Příklad najde první audio rámeček na prvním snímku, nastaví play_mode na spuštění přehrávání po kliknutí a zvolí nízkou předvolbu hlasitosti. Klip pokračuje přes snímky s vypnutým opakováním. Ikona zůstane skryta během prezentace a klip se po přehrání přetočí zpět.
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)
U klipu delšího než 3,5 s tento příklad přeskočí první 1,5 s a poslední 2 s. trim_from_end udává dobu, kterou je třeba oříznout na konci klipu. Pro získání koncového času zobrazeného v PowerPointu odečtěte tento posun od celkové délky klipu. Oříznutý klip se během 200 ms plynule nahrává a během 500 ms plynule zhasíná. Všechny čtyři vlastnosti přijímají hodnoty v milisekundách.
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)
Pro nastavení hlasitosti přehrávání na konkrétní procento použijte volume_value. Tento příklad nastaví první audio rámeček na prvním snímku na 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)
Správa titulků audia
Každý audio rámeček má kolekci caption_tracks. Pomocí ní můžete ke klipu připojit WebVTT titulky, exportovat existující stopy nebo je odstranit.
Přidání titulků audia
Příklad vloží audio klip na první snímek a pomocí CaptionsCollection.add připojí lokální WebVTT stopu. První argument udává název stopy a druhý identifikuje soubor obsahující časované titulky.
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)
Export titulků audia
Tento příklad exportuje každou stopu titulků připojenou k audio rámečku na prvním snímku. Zapíše binary_data stopy do souboru WebVTT a použije její caption_id jako název souboru, aby každá stopa měla samostatný výstup.
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)
Odstranění titulků audia
Použijte remove nebo remove_at pro smazání jednotlivé stopy. Příklad použije clear k odstranění všech titulků z prvního audio rámečku na prvním snímku při zachování klipu.
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)
Vyhledání řádku v titulcích audia
Pro vyhledání řádku v titulcích audia na prvním snímku načtěte data_as_string každé stopy do paměti. V prostém textovém WebVTT cue obsahuje časová řádka -->, následují řádky titulků a prázdná řádka ukončuje cue. Tento příklad vytiskne název stopy a každou řádku titulků obsahující „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}")
Export audia
Přechod snímku může mít svůj vlastní zvuk. Pro jeho získání načtěte vlastnost sound přechodu. Příklad přistupuje k binary_data zvuku a vytiskne jeho velikost v bajtech. Pokud první snímek nemá zvuk přechodu, vypíše místo toho zprávu.
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.")
Často kladené otázky
Mohu znovu použít stejný audio klip na více snímcích bez jeho duplikace?
Ano. Přidejte klip jednou do audio collection prezentace a stejný audio objekt předávejte do add_audio_frame_embedded pro každý snímek.
Mohu nahradit zvuk v existujícím audio rámečku?
Ano. U propojeného zvuku aktualizujte link_path_long tak, aby ukazoval na náhradní soubor. U vloženého zvuku přiřaďte jiný klip z audio kolekce prezentace k embedded_audio. Oba způsoby zachovají existující rámeček.
Mění ořezávání uložená audio data v prezentaci?
Ne. trim_from_start a trim_from_end nastavují hranice přehrávání. Stále můžete získat celý klip z embedded_audio.