# Gestion de l'audio dans les présentations sur Android

> Créer et contrôler des cadres audio dans Aspose.Slides pour Android - exemples Java pour incorporer, couper, boucler et configurer la lecture dans les présentations PPT, PPTX et ODP.

Source: https://docs.aspose.com/slides/fr/androidjava/audio-frame/
Updated: 2026-04-17

## **Créer des cadres audio**
Aspose.Slides pour Android via Java vous permet d'ajouter des fichiers audio aux diapositives. Les fichiers audio sont incorporés dans les diapositives sous forme de cadres audio.

1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/Presentation).
2. Obtenez la référence d'une diapositive via son index.
3. Chargez le flux du fichier audio que vous souhaitez incorporer dans la diapositive.
4. Ajoutez le cadre audio incorporé (contenant le fichier audio) à la diapositive.
5. Définissez [PlayMode](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/AudioPlayModePreset) et `Volume` exposés par l'objet [IAudioFrame](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/IAudioFrame).
6. Enregistrez la présentation modifiée.

```java
// Instancie une classe Presentation qui représente un fichier de présentation
Presentation pres = new Presentation();
try {
    // Obtient la première diapositive
    ISlide sld = pres.getSlides().get_Item(0);

    // Charge le fichier son wav dans un flux
    FileInputStream fstr = new FileInputStream(new File("audio.wav"));

    // Ajoute le cadre audio
    IAudioFrame audioFrame = sld.getShapes().addAudioFrameEmbedded(50, 150, 100, 100, fstr);
    fstr.close();
    
    // Définit le mode de lecture et le volume de l'audio
    audioFrame.setPlayMode(AudioPlayModePreset.Auto);
    audioFrame.setVolume(AudioVolumeMode.Loud);

    // Écrit le fichier PowerPoint sur le disque
    pres.save("AudioFrameEmbed_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}
```

## **Modifier la vignette du cadre audio**
Lorsque vous ajoutez un fichier audio à une présentation, l'audio apparaît sous forme d'un cadre avec une image par défaut standard (voir l'image dans la section ci-dessous). Vous pouvez modifier l'image d'aperçu du cadre audio (définir votre image préférée).

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

    // Ajoute un cadre audio à la diapositive avec une position et une taille spécifiées.
    FileInputStream audioStream = new FileInputStream("sample2.mp3");
    IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.close();

    // Ajoute une image aux ressources de la présentation.
    IPPImage picture;
    IImage image = Images.fromFile("eagle.jpeg");
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Définit l'image pour le cadre audio.
    audioFrame.getPictureFormat().getPicture().setImage(picture); // <-----

    //Enregistre la présentation modifiée sur le disque
    presentation.save("example_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}
```

## **Modifier les options de lecture audio**
Aspose.Slides pour Android via Java vous permet de modifier les options qui contrôlent la lecture ou les propriétés d'un audio. Par exemple, vous pouvez ajuster le volume d'un audio, définir la lecture en boucle de l'audio, ou même masquer l'icône audio.

Le volet **Audio Options** dans Microsoft PowerPoint :

![example1_image](audio_frame_0.png)

Les **Audio Options** de PowerPoint qui correspondent aux propriétés [AudioFrame](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/AudioFrame) d'Aspose.Slides :

- **Démarrer** la liste déroulante correspond à la propriété [AudioFrame.PlayMode](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/AudioFrame#getPlayMode--) 
- **Volume** correspond à la propriété [AudioFrame.Volume](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/AudioFrame#getVolume--) 
- **Lire sur toutes les diapositives** correspond à la propriété [AudioFrame.PlayAcrossSlides](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/AudioFrame#getPlayAcrossSlides--) 
- **Boucle jusqu'à l'arrêt** correspond à la propriété [AudioFrame.PlayLoopMode](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/AudioFrame#getPlayLoopMode--) 
- **Masquer pendant le diaporama** correspond à la propriété [AudioFrame.HideAtShowing](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/AudioFrame#getHideAtShowing--) 
- **Rembobiner après lecture** correspond à la propriété [AudioFrame.RewindAudio](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/AudioFrame#getRewindAudio--) 

Les options d'**Édition** de PowerPoint qui correspondent aux propriétés [AudioFrame](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/audioframe/) d'Aspose.Slides :

- **Fondu entrant** correspond à la propriété [AudioFrame.FadeInDuration](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/audioframe/#getFadeInDuration--) 
- **Fondu sortant** correspond à la propriété [AudioFrame.FadeOutDuration](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/audioframe/#getFadeOutDuration--) 
- **Couper le temps de début de l'audio** correspond à la propriété [AudioFrame.TrimFromStart](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/audioframe/#getTrimFromStart--) 
- **Couper le temps de fin de l'audio** la valeur est égale à la durée de l'audio moins la valeur de la propriété [AudioFrame.TrimFromEnd](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/audioframe/#getTrimFromEnd--) 

Le **contrôle du volume** de PowerPoint sur le panneau de contrôle audio correspond à la propriété [AudioFrame.VolumeValue](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/audioframe/#getVolumeValue--). Il vous permet de modifier le volume audio en pourcentage.

Voici comment modifier les options de lecture audio :

1. [Créer](#create-audio-frame) ou obtenir le cadre audio.
2. Définissez de nouvelles valeurs pour les propriétés du cadre audio que vous souhaitez ajuster.
3. Enregistrez le fichier PowerPoint modifié.

```java 
Presentation pres = new Presentation("AudioFrameEmbed_out.pptx");
try {
    // Obtient la forme AudioFrame
    AudioFrame audioFrame = (AudioFrame)pres.getSlides().get_Item(0).getShapes().get_Item(0);

    // Définit le mode de lecture sur lecture au clic
    audioFrame.setPlayMode(AudioPlayModePreset.OnClick);

    // Définit le volume à Bas
    audioFrame.setVolume(AudioVolumeMode.Low);

    // Définit l'audio pour jouer sur toutes les diapositives
    audioFrame.setPlayAcrossSlides(true);

    // Désactive la boucle pour l'audio
    audioFrame.setPlayLoopMode(false);

    // Masque le AudioFrame pendant le diaporama
    audioFrame.setHideAtShowing(true);

    // Rembobine l'audio au début après la lecture
    audioFrame.setRewindAudio(true);

    // Enregistre le fichier PowerPoint sur le disque
    pres.save("AudioFrameEmbed_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

Cet exemple Java montre comment ajouter un nouveau cadre audio avec audio incorporé, le couper, et définir les durées du fondu :

```java
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);

    // Définit le décalage de début du rognage à 1,5 seconde
    // Définit le décalage de fin du rognage à 2 secondes
    // Définit la durée du fondu entrant à 200 ms
    // Définit la durée du fondu sortant à 500 ms

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

L'exemple de code suivant montre comment récupérer un cadre audio avec audio incorporé et définir son volume à 85 % :

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

    // Obtient une forme de cadre audio
    IAudioFrame audioFrame = (IAudioFrame)slide.getShapes().get_Item(0);

    // Définit le volume audio à 85%
    audioFrame.setVolumeValue(85f);

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

## **Gérer les légendes audio**
Aspose.Slides vous permet d'ajouter des sous-titres fermés à un cadre audio via la méthode [getCaptionTracks](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/iaudioframe/#getCaptionTracks--) . Cette méthode renvoie une [ICaptionsCollection](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/icaptionscollection/), vous permettant d'ajouter des pistes de sous-titres WebVTT, d'itérer sur les pistes existantes et de les supprimer si nécessaire.

### **Ajouter des légendes audio**
Utilisez la méthode [getCaptionTracks](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/iaudioframe/#getCaptionTracks--) pour associer une ou plusieurs pistes de légendes à un cadre audio. Dans l'exemple suivant, un fichier audio est ajouté à une diapositive, puis une nouvelle piste de légende est chargée à partir d'un fichier `.vtt`.

```java
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);

    // Ajoute une nouvelle piste de sous-titres à partir d'un fichier WebVTT.
    presentation.save("audio_with_captions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}
```

### **Extraire les légendes audio**
Vous pouvez parcourir les pistes de légendes associées à un cadre audio et les enregistrer sous forme de fichiers `.vtt`. Chaque piste de légende expose ses données binaires et son identifiant unique, qui peuvent être utilisés lors de l'exportation des légendes.

```java
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()) {
                // Enregistre la piste de sous-titres sous forme de fichier .vtt.
                FileOutputStream fos = new FileOutputStream(captionTrack.getCaptionId() + ".vtt");
                fos.write(captionTrack.getBinaryData());
                fos.close();
            }
        }
    }
} catch (IOException e){
} finally {
    presentation.dispose();
}
```

### **Supprimer les légendes audio**
Pour supprimer les légendes d'un cadre audio, utilisez les méthodes fournies par [ICaptionsCollection](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/icaptionscollection/), telles que [clear](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/icaptionscollection/#clear--), [remove](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/icaptionscollection/#remove-com.aspose.slides.ICaptions-), ou [removeAt](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/icaptionscollection/#removeAt-int-). L'exemple suivant supprime toutes les pistes de légendes d'un cadre audio.

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

    // Supprime toutes les pistes de sous-titres du cadre audio.
    audioFrame.getCaptionTracks().clear();

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

## **Extraire l'audio**
Aspose.Slides pour Android via Java vous permet d'extraire le son utilisé dans les transitions de diaporama. Par exemple, vous pouvez extraire le son utilisé dans une diapositive spécifique.

1. Créez une instance de la classe [Presentation](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/Presentation) et chargez la présentation contenant l'audio.
2. Obtenez la référence de la diapositive concernée via son index.
3. Accédez aux [slideshow transitions](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/IBaseSlide#getSlideShowTransition--) de la diapositive.
4. Extrayez le son sous forme de données binaires.

```java
// Instancie une classe Presentation qui représente un fichier de présentation
Presentation pres = new Presentation("AudioSlide.pptx");
try {
    // Accède à la diapositive souhaitée
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Obtient les effets de transition du diaporama pour la diapositive
    ISlideShowTransition transition = slide.getSlideShowTransition();
    
    //Extrait le son dans un tableau d'octets
    byte[] audio = transition.getSound().getBinaryData();
    System.out.println("Length: " + audio.length);
} finally {
    if (pres != null) pres.dispose();
}
```

## **FAQ**

**Puis-je réutiliser le même fichier audio sur plusieurs diapositives sans augmenter la taille du fichier ?**

Oui. Ajoutez l'audio une seule fois à la présentation ’s [audio collection](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/presentation/#getAudios--) partagée et créez des cadres audio supplémentaires qui référencent cet asset existant. Cela évite de dupliquer les données multimédias et maintient la taille de la présentation sous contrôle.

**Puis-je remplacer le son d'un cadre audio existant sans recréer la forme ?**

Oui. Pour un son lié, mettez à jour le [link path](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/iaudioframe/#setLinkPathLong-java.lang.String-) pour qu’il pointe vers le nouveau fichier. Pour un son incorporé, remplacez l’[embedded audio](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/iaudioframe/#setEmbeddedAudio-com.aspose.slides.IAudio-) par un autre provenant de la [audio collection](https://reference.aspose.com/slides/fr/androidjava/com.aspose.slides/presentation/#getAudios--) de la présentation. Le format du cadre et la plupart des paramètres de lecture restent intacts.

**Le découpage modifie-t-il les données audio sous-jacentes stockées dans la présentation ?**

Non. Le découpage ajuste uniquement les limites de lecture. Les octets audio originaux restent inchangés et accessibles via l’audio incorporé ou la collection audio de la présentation.
