Gestionar marcos de audio en presentaciones con Python

Visión general

Un marco de audio le permite reproducir un sonido en una diapositiva. Con Aspose.Slides for Python via .NET, puede incrustar un clip de audio, elegir la imagen que lo representa, ajustar la reproducción y adjuntar subtítulos. También puede obtener un sonido asignado a una transición de diapositiva.

Crear marcos de audio

Utilice add_audio_frame_embedded para incrustar un clip de audio local en la primera diapositiva. Las dos primeras coordenadas posicionan el marco en la diapositiva, y los dos valores siguientes establecen su ancho y alto, todo en puntos. Este ejemplo establece play_mode para iniciar el clip automáticamente y volume al ajuste de volumen alto.

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)

Cambiar la miniatura del marco de audio

Por defecto, un marco de audio muestra un icono de altavoz. Para mostrar una miniatura personalizada, añada una imagen a la presentación con add_image y asígnela a la propiedad picture_format.picture.image del marco. El ejemplo utiliza un JPEG como miniatura para un clip de audio incrustado.

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)

Cambiar opciones de reproducción de audio

Los controles de Opciones de audio de PowerPoint determinan cuándo comienza un clip, cuán fuerte suena y cómo se comporta durante una presentación.

Controles de Opciones de audio de PowerPoint para un marco de audio

Control de PowerPoint Propiedad de Aspose.Slides
Inicio play_mode
Ajuste de volumen volume
Reproducción en todas las diapositivas play_across_slides
Repetir hasta detenerse play_loop_mode
Ocultar durante la presentación hide_at_showing
Retroceder después de reproducir rewind_audio
Desvanecerse al iniciar fade_in_duration
Desvanecerse al finalizar fade_out_duration
Recortar tiempo de inicio del audio trim_from_start
Recortar tiempo de final del audio trim_from_end
Control deslizante de volumen volume_value

El ejemplo busca el primer marco de audio en la primera diapositiva, establece play_mode para iniciar la reproducción al hacer clic, y selecciona el ajuste de volumen bajo. El clip continúa a través de las diapositivas con la repetición desactivada. El icono permanece oculto durante la presentación, y el clip retrocede después de la reproducción.

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)

Para un clip de más de 3,5 segundos, este ejemplo omite los primeros 1,5 segundos y los últimos 2 segundos. trim_from_end mide la duración a omitir del final del clip. Para obtener el tiempo de final mostrado en PowerPoint, reste ese desplazamiento de la duración total del clip. El clip recortado se desvanece al iniciar durante 200 milisegundos y se desvanece al finalizar durante 500 milisegundos. Las cuatro propiedades toman valores en milisegundos.

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)

Para establecer el volumen de reproducción a un porcentaje específico, utilice volume_value. Este ejemplo establece el primer marco de audio en la primera diapositiva al 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)

Gestionar subtítulos de audio

Cada marco de audio tiene una colección caption_tracks. Úsela para adjuntar subtítulos WebVTT al clip, exportar pistas existentes o eliminarlas.

Agregar subtítulos de audio

El ejemplo incrusta un clip de audio en la primera diapositiva y utiliza CaptionsCollection.add para adjuntar una pista WebVTT local. El primer argumento proporciona la etiqueta de la pista, y el segundo identifica el archivo que contiene los subtítulos sincronizados.

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)

Extraer subtítulos de audio

Este ejemplo exporta cada pista de subtítulos adjunta a un marco de audio en la primera diapositiva. Escribe los binary_data de la pista en un archivo WebVTT y utiliza su caption_id como nombre de archivo para que cada pista tenga una salida separada.

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)

Eliminar subtítulos de audio

Utilice remove o remove_at para eliminar una pista individual. El ejemplo usa clear para eliminar todos los subtítulos del primer marco de audio en la primera diapositiva, conservando el clip.

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)

Buscar una línea en subtítulos de audio

Para encontrar una línea en los subtítulos de audio de la primera diapositiva, lea el data_as_string de cada pista en memoria. En una señal WebVTT de texto plano, la línea de tiempo contiene -->, las líneas de subtítulo la siguen y una línea en blanco finaliza la señal. Este ejemplo imprime la etiqueta de la pista y cada línea de subtítulo que contiene “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}")

Extraer audio

Una transición de diapositiva puede tener su propio sonido. Para recuperarlo, lea la propiedad sound de la transición. El ejemplo accede a los binary_data del sonido y muestra su tamaño en bytes. Si la primera diapositiva no tiene sonido de transición, muestra un mensaje en su lugar.

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.")

Preguntas frecuentes

¿Puedo reutilizar el mismo clip de audio en varias diapositivas sin duplicarlo?

Sí. Añada el clip una vez a la audio collection de la presentación y pase el mismo objeto de audio a add_audio_frame_embedded para cada diapositiva.

¿Puedo reemplazar el sonido en un marco de audio existente?

Sí. Para un sonido vinculado, actualice link_path_long para que apunte al archivo de sustitución. Para un sonido incrustado, asigne otro clip de la colección de audio de la presentación a embedded_audio. Ambos enfoques conservan el marco existente.

¿El recorte modifica los datos de audio almacenados en la presentación?

No. trim_from_start y trim_from_end establecen los límites de reproducción. Todavía puede obtener el clip completo mediante embedded_audio.