Hantera ljudramar i presentationer med Python
Översikt
Ett ljudram gör att du kan spela upp ett ljud på en bild. Med Aspose.Slides för Python via .NET kan du bädda in ett ljudklipp, välja bilden som representerar det, justera uppspelning och bifoga texter. Du kan också hämta ett ljud som är tilldelat en bildspelsövergång.
Skapa ljudramar
Använd add_audio_frame_embedded för att bädda in ett lokalt ljudklipp på den första bilden. De två första koordinaterna placerar ramen på bilden, och de två följande värdena anger dess bredd och höjd, alla i punkter. Detta exempel sätter play_mode till att starta klippet automatiskt och volume till den högsta volymförinställningen.
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)
Ändra miniatyrbild för ljudram
Som standard visar en ljudram en högtalarikon. För att visa en anpassad miniatyrbild, lägg till en bild i presentationen med add_image och tilldela den till ramens egenskap picture_format.picture.image . Exemplet använder en JPEG som miniatyrbild för ett inbäddat ljudklipp.
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)
Ändra ljuduppspelningsalternativ
PowerPoints Audio Options‑kontroller bestämmer när ett klipp startar, hur högt det låter och hur det beter sig under en bildspelsvisning.

| PowerPoint‑kontroll | Aspose.Slides‑egenskap |
|---|---|
| Start | play_mode |
| Volymförinställning | volume |
| Spela över bilder | play_across_slides |
| Upprepa tills stoppad | play_loop_mode |
| Dölj under visning | hide_at_showing |
| Spola tillbaka efter uppspelning | rewind_audio |
| Tona in | fade_in_duration |
| Tona ut | fade_out_duration |
| Trimma ljud starttid | trim_from_start |
| Trimma ljud sluttid | trim_from_end |
| Volymreglage | volume_value |
Exemplet hittar den första ljudramen på den första bilden, sätter play_mode till att starta uppspelning vid ett klick och väljer den låga volymförinställningen. Klippet fortsätter över bilder med upprepning inaktiverad. Ikonen förblir dold under visningen, och klippet spolar tillbaka efter uppspelning.
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)
För ett klipp längre än 3,5 sekunder hoppar detta exempel över de första 1,5 sekunderna och de sista 2 sekunderna. trim_from_end mäter den varaktighet som ska utelämnas från klippets slut. För att få den sluttid som visas i PowerPoint, subtrahera den förskjutningen från hela klippets varaktighet. Det beskurna klippet tonar in under 200 ms och tonar ut under 500 ms. Alla fyra egenskaper använder värden i millisekunder.
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)
För att sätta uppspelningsvolymen till en specifik procentsats, använd volume_value. Detta exempel sätter den första ljudramen på den första bilden till 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)
Hantera ljudtexter
Varje ljudram har en samling caption_tracks . Använd den för att bifoga WebVTT‑texter till klippet, exportera befintliga spår eller ta bort dem.
Lägg till ljudtexter
Exemplet bäddar in ett ljudklipp på den första bilden och använder CaptionsCollection.add för att bifoga ett lokalt WebVTT‑spår. Det första argumentet anger spårets etikett och det andra identifierar filen som innehåller de tidskodade texterna.
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)
Extrahera ljudtexter
Detta exempel exporterar varje textspår som är bifogat en ljudram på den första bilden. Det skriver spårets binary_data till en WebVTT‑fil och använder dess caption_id som filnamn så att varje spår får en separat output.
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)
Ta bort ljudtexter
Använd remove eller remove_at för att ta bort ett enskilt spår. Exemplet använder clear för att ta bort alla texter från den första ljudramen på den första bilden samtidigt som klippet bevaras.
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)
Hitta en rad i ljudtexter
För att hitta en rad i ljudtexterna på den första bilden, läs varje spårs data_as_string i minnet. I en ren text‑WebVTT‑cue innehåller tidslinjen -->, följt av textraderna, och en tom rad avslutar cue:n. Detta exempel skriver ut spårets etikett och varje textrad som innehåller “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}")
Extrahera ljud
En bildspelsövergång kan ha ett eget ljud. För att hämta det, läs övergångens egenskap sound . Exemplet får åtkomst till ljudets binary_data och skriver ut dess storlek i byte. Om den första bilden saknar övergångsljud skriver det istället ut ett meddelande.
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.")
FAQ
Kan jag återanvända samma ljudklipp på flera bilder utan att duplicera det?
Ja. Lägg till klippet en gång i presentationens audio collection och skicka samma ljudobjekt till add_audio_frame_embedded för varje bild.
Kan jag ersätta ljudet i en befintlig ljudram?
Ja. För ett länkat ljud, uppdatera link_path_long så att det pekar på ersättningsfilen. För ett inbäddat ljud, tilldela ett annat klipp från presentationens ljudsamling till embedded_audio . Båda metoderna bevarar den befintliga ramen.
Ändrar trimning ljuddata som lagras i presentationen?
Nej. trim_from_start och trim_from_end sätter uppspelningsgränser. Du kan fortfarande hämta hela klippet från embedded_audio .