Gestire l'audio nelle presentazioni su Android

Panoramica

Questo articolo spiega come lavorare con i fotogrammi audio in Aspose.Slides. Mostra come aggiungere audio incorporato alle diapositive, personalizzare la miniatura del fotogramma audio, configurare le opzioni di riproduzione come volume, ripetizione, nascondere, ritaglio e durata delle dissolvenze, ed estrarre l’audio utilizzato nelle transizioni della presentazione.

Crea fotogrammi audio

Aspose.Slides per Android via Java consente di aggiungere file audio alle diapositive. I file audio sono incorporati nelle diapositive come fotogrammi audio.

Creare un’istanza della classe Presentation.
Ottenere il riferimento di una diapositiva tramite il suo indice.
Caricare lo stream del file audio che si desidera incorporare nella diapositiva.
Aggiungere il fotogramma audio incorporato (contenente il file audio) alla diapositiva.
Impostare PlayMode e Volume esposti dall’oggetto IAudioFrame.
Salvare la presentazione modificata.

Questo codice Java mostra come aggiungere un fotogramma audio incorporato a una diapositiva:

// Instanzia una classe Presentation che rappresenta un file di presentazione
Presentation pres = new Presentation();
try {
    // Ottiene la prima diapositiva
    ISlide sld = pres.getSlides().get_Item(0);

    // Carica il file audio wav nello stream
    FileInputStream fstr = new FileInputStream(new File("audio.wav"));

    // Aggiunge il fotogramma audio
    IAudioFrame audioFrame = sld.getShapes().addAudioFrameEmbedded(50, 150, 100, 100, fstr);
    fstr.close();
    
    // Imposta la modalità di riproduzione e il volume dell'audio
    audioFrame.setPlayMode(AudioPlayModePreset.Auto);
    audioFrame.setVolume(AudioVolumeMode.Loud);

    // Scrive il file PowerPoint su disco
    pres.save("AudioFrameEmbed_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Modifica la miniatura del fotogramma audio

Quando si aggiunge un file audio a una presentazione, l’audio appare come un fotogramma con un’immagine predefinita standard (vedi l’immagine nella sezione seguente). È possibile modificare l’immagine di anteprima del fotogramma audio (impostare l’immagine preferita).

Questo codice Java mostra come modificare la miniatura o l’immagine di anteprima di un fotogramma audio:

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // Aggiunge un fotogramma audio alla diapositiva con una posizione e dimensione specificate.
    FileInputStream audioStream = new FileInputStream("sample2.mp3");
    IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.close();

    // Aggiunge un'immagine alle risorse della presentazione.
    IPPImage picture;
    IImage image = Images.fromFile("eagle.jpeg");
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Imposta l'immagine per il fotogramma audio.
    audioFrame.getPictureFormat().getPicture().setImage(picture); // <-----

//Salva la presentazione modificata su disco
    presentation.save("example_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

Modifica le opzioni di riproduzione audio

Aspose.Slides per Android via Java consente di modificare le opzioni che controllano la riproduzione o le proprietà di un audio. Ad esempio, è possibile regolare il volume di un audio, impostare la riproduzione in loop o persino nascondere l’icona audio.

The Audio Options pane in Microsoft PowerPoint:

example1_image

Le Opzioni audio di PowerPoint corrispondenti alle proprietà di Aspose.Slides AudioFrame :

L’elenco a discesa Start corrisponde alla proprietà AudioFrame.PlayMode .
Il Volume corrisponde alla proprietà AudioFrame.Volume .
L’opzione Play Across Slides corrisponde alla proprietà AudioFrame.PlayAcrossSlides .
Loop until Stopped corrisponde alla proprietà AudioFrame.PlayLoopMode .
Hide During Show corrisponde alla proprietà AudioFrame.HideAtShowing .
Rewind after Playing corrisponde alla proprietà AudioFrame.RewindAudio .

Le opzioni Modifica di PowerPoint che corrispondono alle proprietà di Aspose.Slides AudioFrame :

Fade In corrisponde alla proprietà AudioFrame.FadeInDuration .
Fade Out corrisponde alla proprietà AudioFrame.FadeOutDuration .
Trim Audio Start Time corrisponde alla proprietà AudioFrame.TrimFromStart .
Trim Audio End Time valore è uguale alla durata dell’audio meno il valore della proprietà AudioFrame.TrimFromEnd .

Il controllo Volume di PowerPoint nel pannello di controllo audio corrisponde alla proprietà AudioFrame.VolumeValue . Consente di modificare il volume dell’audio in percentuale.

Ecco come modificare le opzioni di riproduzione audio:

Crea o ottieni il Fotogramma audio.
Imposta nuovi valori per le proprietà del Fotogramma audio che desideri modificare.
Salva il file PowerPoint modificato.

Questo codice Java dimostra un’operazione in cui le opzioni di un audio vengono regolate:

Presentation pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    // Ottiene la forma AudioFrame
    AudioFrame audioFrame = (AudioFrame)pres.getSlides().get_Item(0).getShapes().get_Item(0);

    // Imposta la modalità di riproduzione su clic
    audioFrame.setPlayMode(AudioPlayModePreset.OnClick);

    // Imposta il volume su Basso
    audioFrame.setVolume(AudioVolumeMode.Low);

    // Imposta l'audio per riprodursi su più diapositive
    audioFrame.setPlayAcrossSlides(true);

    // Disabilita il loop per l'audio
    audioFrame.setPlayLoopMode(false);

    // Nasconde il fotogramma audio durante la presentazione
    audioFrame.setHideAtShowing(true);

    // Riavvolge l'audio all'inizio dopo la riproduzione
    audioFrame.setRewindAudio(true);

    // Salva il file PowerPoint su disco
    pres.save("AudioFrameEmbed_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Questo esempio Java mostra come aggiungere un nuovo fotogramma audio con audio incorporato, ritagliarlo e impostare le durate delle dissolvenze:

Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    
    FileInputStream audioData = new FileInputStream("sampleaudio.mp3");
    IAudio audio = pres.getAudios().addAudio(audioData, LoadingStreamBehavior.KeepLocked);
    IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(50, 50, 100, 100, audio);

    // Imposta l'offset iniziale del ritaglio a 1,5 secondi
    audioFrame.setTrimFromStart(1500f);
    // Imposta l'offset finale del ritaglio a 2 secondi
    audioFrame.setTrimFromEnd(2000f);

    // Imposta la durata della dissolvenza in ingresso a 200 ms
    audioFrame.setFadeInDuration(200f);
    // Imposta la durata della dissolvenza in uscita a 500 ms
    audioFrame.setFadeOutDuration(500f);

    pres.save("AudioFrameTrimFade_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Il seguente esempio di codice mostra come recuperare un fotogramma audio con audio incorporato e impostarne il volume all'85%:

Presentation pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);

    // Ottiene la forma di un fotogramma audio
    IAudioFrame audioFrame = (IAudioFrame)slide.getShapes().get_Item(0);

    // Imposta il volume audio all'85%
    audioFrame.setVolumeValue(85f);

    pres.save("AudioFrameValue_out.pptx", SaveFormat.Pptx);
}
finally {
    pres.dispose();
}

Gestisci i sottotitoli audio

Aspose.Slides consente di aggiungere sottotitoli chiusi a un fotogramma audio tramite il metodo getCaptionTracks . Questo metodo restituisce una ICaptionsCollection , che permette di aggiungere tracce di sottotitoli WebVTT, iterare le tracce esistenti e rimuoverle quando necessario.

Aggiungi sottotitoli audio

Utilizza il metodo getCaptionTracks per collegare una o più tracce di sottotitoli a un fotogramma audio. Nell’esempio seguente, un file audio viene aggiunto a una diapositiva, quindi viene caricata una nuova traccia di sottotitoli da un file .vtt .

Presentation presentation = new Presentation();
try {
    byte[] audioData = Files.readAllBytes(Paths.get("audio.mp3"));
    IAudio audio = presentation.getAudios().addAudio(audioData);

    ISlide slide = presentation.getSlides().get_Item(0);
    IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(10, 10, 50, 50, audio);

    // Aggiungi una nuova traccia di sottotitoli da un file WebVTT.
    audioFrame.getCaptionTracks().add("New track", "track.vtt");

    presentation.save("audio_with_captions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Estrai i sottotitoli audio

È possibile iterare le tracce di sottotitoli associate a un fotogramma audio e salvarle come file .vtt. Ogni traccia di sottotitoli espone i dati binari e l’identificatore unico, utili durante l’esportazione dei sottotitoli.

Presentation presentation = new Presentation("audio_with_captions.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IAudioFrame) {
            IAudioFrame audioFrame = (IAudioFrame) shape;
            for (ICaptions captionTrack : audioFrame.getCaptionTracks()) {
                // Salva la traccia di sottotitoli come file .vtt.
                FileOutputStream fos = new FileOutputStream(captionTrack.getCaptionId() + ".vtt");
                fos.write(captionTrack.getBinaryData());
                fos.close();
            }
        }
    }
} catch (IOException e){
} finally {
    presentation.dispose();
}

Rimuovi i sottotitoli audio

Per rimuovere i sottotitoli da un fotogramma audio, utilizza i metodi forniti da ICaptionsCollection , come clear , remove o removeAt . L’esempio seguente rimuove tutte le tracce di sottotitoli da un fotogramma audio.

Presentation presentation = new Presentation("audio_with_captions.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAudioFrame audioFrame = (IAudioFrame) slide.getShapes().get_Item(0);

    // Rimuovi tutte le tracce di sottotitoli dal fotogramma audio.
    audioFrame.getCaptionTracks().clear();

    presentation.save("audio_without_captions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Estrai audio

Aspose.Slides per Android via Java consente di estrarre il suono utilizzato nelle transizioni della presentazione. Ad esempio, è possibile estrarre il suono utilizzato in una diapositiva specifica.

Creare un’istanza della classe Presentation e caricare la presentazione contenente l’audio.
Ottenere il riferimento della diapositiva pertinente tramite il suo indice.
Accedere alle slideshow transitions della diapositiva.
Estrarre il suono come dati byte.

Questo codice Java mostra come estrarre l’audio usato in una diapositiva:

// Crea un'istanza della classe Presentation che rappresenta un file di presentazione
Presentation pres = new Presentation("AudioSlide.pptx");
try {
    // Accede alla diapositiva desiderata
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Ottiene gli effetti di transizione della presentazione per la diapositiva
    ISlideShowTransition transition = slide.getSlideShowTransition();
    
    //Estrae il suono in un array di byte
    byte[] audio = transition.getSound().getBinaryData();
    System.out.println("Length: " + audio.length);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Posso riutilizzare lo stesso asset audio in più diapositive senza aumentare la dimensione del file?

Sì. Aggiungi l’audio una sola volta alla audio collection condivisa della presentazione e crea fotogrammi audio aggiuntivi che fanno riferimento a quell’asset esistente. Questo evita la duplicazione dei dati multimediali e mantiene le dimensioni della presentazione sotto controllo.

Posso sostituire il suono in un fotogramma audio esistente senza ricreare la forma?

Sì. Per un suono collegato, aggiorna il link path per puntare al nuovo file. Per un suono incorporato, sostituisci l’oggetto embedded audio con un altro presente nella audio collection della presentazione. La formattazione del fotogramma e la maggior parte delle impostazioni di riproduzione rimangono invariate.

Il ritaglio modifica i dati audio sottostanti memorizzati nella presentazione?

No. Il ritaglio regola solo i limiti di riproduzione. I byte originali dell’audio rimangono intatti e accessibili tramite l’audio incorporato o la audio collection della presentazione.