

# Kit SDK de diffusion IVS : Sources d’images personnalisées \| Diffusion en temps réel
<a name="broadcast-custom-image-sources"></a>

Les sources d'entrée d'image personnalisées permettent à une application de fournir sa propre entrée d'image au SDK de diffusion, au lieu de se limiter aux caméras prédéfinies. Une source d'image personnalisée peut être aussi simple qu'un filigrane semi-transparent ou une scène statique « Je reviens tout de suite », ou elle peut permettre à l'application d'effectuer un traitement personnalisé supplémentaire, comme l'ajout de filtres de beauté à la caméra.

Lorsque vous utilisez une source d'entrée d'image personnalisée pour un contrôle personnalisé de la caméra (par exemple, l'utilisation de bibliothèques de filtres de beauté nécessitant un accès à la caméra), le kit SDK de diffusion n'est plus responsable de la gestion de la caméra. Au lieu de cela, l'application est chargée de gérer correctement le cycle de vie de la caméra. Consultez la documentation officielle de la plateforme sur la façon dont votre application doit gérer la caméra.

## Android
<a name="custom-image-sources-android"></a>

Après avoir créé une session `DeviceDiscovery`, créez une source d'entrée d'image :

```
CustomImageSource imageSource = deviceDiscovery.createImageInputSource(new BroadcastConfiguration.Vec2(1280, 720));
```

Cette méthode renvoie un `CustomImageSource`, qui est une source basée sur un Android [Surface](https://developer.android.com/reference/android/view/Surface) standard. La sous-classe `SurfaceSource` permet le redimensionnement et la rotation. Vous pouvez également créer un `ImagePreviewView` pour afficher un aperçu de son contenu.

Pour récupérer la sous-jacente  `Surface`:

```
Surface surface = surfaceSource.getInputSurface();
```

Cette `Surface` peut être utilisée comme tampon de sortie pour les producteurs d'images tels que Camera2, OpenGL ES et d'autres bibliothèques. Le cas d'utilisation le plus simple consiste à dessiner directement un bitmap statique ou une couleur dans le canevas de la surface. Cependant, de nombreuses bibliothèques (telles que les bibliothèques de filtres de beauté) fournissent une méthode qui permet à une application de spécifier une `Surface` externe pour le rendu. Vous pouvez utiliser une telle méthode pour transmettre cette `Surface` à la bibliothèque de filtres, ce qui permet à cette dernière de produire des images traitées pour la séance de diffusion.

Cette `CustomImageSource` peut être encapsulée dans un `LocalStageStream` et renvoyée par la `StageStrategy` pour être publiée vers une `Stage`.

## iOS
<a name="custom-image-sources-ios"></a>

Après avoir créé une session `DeviceDiscovery`, créez une source d'entrée d'image :

```
let customSource = broadcastSession.createImageSource(withName: "customSourceName")
```

Cette méthode renvoie une `IVSCustomImageSource`, une source d'image qui permet à l'application de soumettre `CMSampleBuffers` manuellement. Pour connaître les formats de pixels pris en charge, consultez la référence du kit SDK de diffusion iOS. Un lien vers la version la plus récente se trouve dans les [notes de mise à jour Amazon IVS](release-notes.md) pour la dernière version du kit SDK de diffusion.

Les exemples soumis à la source personnalisée seront diffusés dans la scène :

```
customSource.onSampleBuffer(sampleBuffer)
```

Pour diffuser des vidéos en streaming, utilisez cette méthode dans un rappel. Par exemple, si vous utilisez la caméra, chaque fois qu'un nouvel exemple de tampon est reçu d'une `AVCaptureSession`, l'application peut transférer l'exemple de tampon vers la source d'image personnalisée. Si vous le souhaitez, l'application peut appliquer un traitement supplémentaire (comme un filtre de beauté) avant de soumettre l'exemple à la source d'image personnalisée.

La `IVSCustomImageSource` peut être encapsulée dans un `IVSLocalStageStream` et renvoyé par la `IVSStageStrategy` pour être publiée vers une `Stage`.