

# Étape 4 :Intégrer le SDK de diffusion IVS
<a name="getting-started-broadcast-sdk"></a>

IVS fournit un SDK de diffusion pour le Web, Android et iOS que vous pouvez intégrer à votre application. Le SDK de diffusion est utilisé à la fois pour envoyer et recevoir des vidéos. Si vous avez [configuré l’ingestion RTMP pour votre scène](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html), vous pouvez utiliser n’importe quel encodeur capable de diffuser vers un point de terminaison RTMP (par exemple, OBS ou ffmpeg).

Dans cette section, nous écrivons une application simple qui permet à deux participants ou plus d’interagir en temps réel. Les étapes ci-dessous vous guident dans la création d’une application appelée BasicRealTime. Le code complet de l’application se trouve sur CodePen et GitHub :
+  Web : [https://codepen.io/amazon-ivs/pen/ZEqgrpo](https://codepen.io/amazon-ivs/pen/ZEqgrpo) 
+  Android :[https://github.com/aws-samples/amazon-ivs-real-time-streaming-android-samples](https://github.com/aws-samples/amazon-ivs-real-time-streaming-android-samples) 
+  iOS : [https://github.com/aws-samples/amazon-ivs-real-time-streaming-ios-samples](https://github.com/aws-samples/amazon-ivs-real-time-streaming-ios-samples) 

## Web
<a name="getting-started-broadcast-sdk-web"></a>

### Fichiers de configuration
<a name="getting-started-broadcast-sdk-web-setup"></a>

Pour commencer, configurez vos fichiers en créant un dossier et un fichier HTML et JS initial :

```
mkdir realtime-web-example
cd realtime-web-example
touch index.html
touch app.js
```

Vous pouvez installer le SDK de diffusion à l’aide d’une balise de script ou de npm. Notre exemple utilise la balise script pour des raisons de simplicité, mais est facile à modifier si vous choisissez d’utiliser npm ultérieurement.

### Utilisation d’une balise de script
<a name="getting-started-broadcast-sdk-web-script"></a>

Le kit SDK de diffusion Web est distribué sous forme de bibliothèque JavaScript et peut être consulté à l'adresse [https://web-broadcast.live-video.net/1.33.0/amazon-ivs-web-broadcast.js](https://web-broadcast.live-video.net/1.33.0/amazon-ivs-web-broadcast.js).

Lorsqu’elle est chargée via une balise `<script>`, la bibliothèque expose une variable globale dans la portée de la fenêtre nommée `IVSBroadcastClient`.

### Utilisation de npm
<a name="getting-started-broadcast-sdk-web-npm"></a>

Pour installer le package npm :

```
npm install amazon-ivs-web-broadcast
```

Vous pouvez désormais accéder à l’objet IVSBroadcastClient :

```
const { Stage } = IVSBroadcastClient;
```

## Android
<a name="getting-started-broadcast-sdk-android"></a>

### Création du projet Android
<a name="getting-started-broadcast-sdk-android-project"></a>

1. Dans Android Studio, créez un **New Project**.

1. Choisissez **Empty Views Activity**.

   Remarque : dans certaines anciennes versions d’Android Studio, l’activité basée sur les vues est appelée **Empty Activity**. Si votre fenêtre Android Studio affiche **Empty Activity** et *ne montre pas* **Empty Views Activity**, sélectionnez **Empty Activity**. Sinon, ne sélectionnez pas **Empty Activity**, car nous utiliserons les API View (et non Jetpack Compose).

1. Donnez un **Nom** à votre projet, puis sélectionnez **Finish**.

### Installation du SDK Broadcast
<a name="getting-started-broadcast-sdk-android-install"></a>

Pour ajouter la bibliothèque de diffusion Android Amazon IVS à votre environnement de développement Android, ajoutez la bibliothèque au fichier `build.gradle` de votre module, comme indiqué ici (pour la dernière version du SDK de diffusion Amazon IVS). Dans les nouveaux projets, le référentiel `mavenCentral` est peut-être déjà inclus dans votre fichier `settings.gradle`, si c’est le cas, vous pouvez omettre le bloc `repositories`. Pour notre exemple, nous devrons également activer la liaison de données dans le bloc `android`.

```
android {
    dataBinding.enabled true
}

repositories {
    mavenCentral()
}
 
dependencies {
     implementation 'com.amazonaws:ivs-broadcast:1.40.0:stages@aar'
}
```

Vous pouvez également installer le kit SDK manuellement, en téléchargeant la dernière version à partir du lien suivant :

[https://search.maven.org/artifact/com.amazonaws/ivs-broadcast](https://search.maven.org/artifact/com.amazonaws/ivs-broadcast)

## iOS
<a name="getting-started-broadcast-sdk-ios"></a>

### Création du projet iOS
<a name="getting-started-broadcast-sdk-ios-project"></a>

1. Crée un projet Xcode.

1. Pour **Platform**, sélectionnez **iOS**.

1. Pour **Application**, sélectionnez **App**.

1. Saisissez le **Product Name** de votre application, puis sélectionnez **Next**.

1. Choisissez (naviguez jusqu’à) un répertoire dans lequel enregistrer le projet, puis sélectionnez **Create**.

Ensuite, vous devez importer le SDK. Pour obtenir des instructions, consultez [Installer la bibliothèque](broadcast-ios-getting-started.md#broadcast-ios-install) dans le *guide du kit SDK de diffusion iOS*.

### Configuration des autorisations
<a name="getting-started-broadcast-sdk-ios-config"></a>

Vous devez mettre à jour votre projet `Info.plist` pour ajouter deux nouvelles entrées pour `NSCameraUsageDescription` et `NSMicrophoneUsageDescription`. Pour les valeurs, expliquez à l’utilisateur pourquoi votre application demande l’accès à la caméra et au microphone.

![\[Configurez des autorisations iOS.\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/images/iOS_Configure.png)
