

# Schritt 4: Das IVS Broadcast SDK integrieren
<a name="getting-started-broadcast-sdk"></a>

IVS bietet ein Broadcast-SDK für Web, Android und iOS, das Sie in Ihre Anwendung integrieren können. Das Broadcast-SDK wird sowohl zum Senden als auch zum Empfangen von Videos verwendet. Wenn Sie [RTMP-Erfassung für Ihre Stage konfiguriert](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) haben, können Sie jeden Encoder verwenden, der an einen RTMP-Endpunkt senden kann (z. B. OBS oder ffmpeg).

In diesem Abschnitt schreiben wir eine einfache Anwendung, mit der zwei oder mehr Teilnehmer in Echtzeit interagieren können. Die folgenden Schritte führen Sie durch die Erstellung einer Anwendung namens BasicRealTime. Der vollständige Anwendungscode befindet sich auf CodePen und 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>

### Dateien einrichten
<a name="getting-started-broadcast-sdk-web-setup"></a>

Richten Sie zunächst Ihre Dateien ein, indem Sie einen Ordner und eine erste HTML- und JS-Datei erstellen:

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

Sie können das Broadcast-SDK mit einem Script-Tag oder npm installieren. Unser Beispiel verwendet der Einfachheit halber das Script-Tag, kann aber leicht geändert werden, wenn Sie npm später verwenden möchten.

### Verwenden eines Skript-Tags
<a name="getting-started-broadcast-sdk-web-script"></a>

Das Web Broadcast SDK wird als JavaScript-Bibliothek verteilt und kann unter [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) abgerufen werden.

Wenn sie per `<script>`-Tag geladen wird, stellt die Bibliothek eine globale Variable im Fensterbereich namens `IVSBroadcastClient` bereit.

### Verwenden von npm
<a name="getting-started-broadcast-sdk-web-npm"></a>

So installieren Sie das npm-Paket:

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

Sie können jetzt auf das IVSBroadcastClient-Objekt zugreifen:

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

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

### Erstellen Sie das Android-Projekt
<a name="getting-started-broadcast-sdk-android-project"></a>

1. Erstellen Sie ein **Neues Projekt** mit Android Studio.

1. Wählen Sie **Aktivität „Leere Ansichten“**.

   Hinweis: In einigen älteren Versionen von Android Studio heißt die ansichtsbasierte Aktivität **Leere Aktivität**. Wenn Ihr Android-Studio-Fenster **Leere Aktivität** und *nicht* **Leere Ansichten**-Aktivität anzeigt, wählen Sie **Leere Aktivität**. Andernfalls wählen Sie nicht **Leere Aktivität**, da wir View-APIs verwenden werden (nicht Jetpack Compose).

1. Geben Sie Ihrem Projekt einen **Namen**, wählen Sie dann **Fertig**.

### Installieren Sie das Broadcast-SDK
<a name="getting-started-broadcast-sdk-android-install"></a>

Wenn Sie der Android-Entwicklungsumgebung die Amazon-IVS-Android-Broadcast-Bibliothek hinzufügen möchten, fügen Sie die Bibliothek der `build.gradle` – wie hier gezeigt – (für die neueste Version des Amazon IVS Broadcast SDK) zu Ihren Modulen hinzu. In neueren Projekten ist `mavenCentral` das Repository ist möglicherweise bereits in Ihrer `settings.gradle`-Datei. Wenn das der Fall ist, können Sie den `repositories`-Block weglassen. Für unser Beispiel müssen wir auch die Datenbindung im Block `android` aktivieren.

```
android {
    dataBinding.enabled true
}

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

Um das SDK manuell zu installieren, laden Sie alternativ die neueste Version von diesem Speicherort herunter:

[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>

### Erstellen des iOS-Projekts
<a name="getting-started-broadcast-sdk-ios-project"></a>

1. Erstellen eines neuen Xcode-Projekts.

1. Für **Plattform** wählen Sie **iOS**.

1. Für **Anwendung** wählen Sie **App**.

1. Geben Sie den **Namen des Produkts** Ihrer Anwendung ein und wählen Sie **Weiter**.

1. Wählen (navigieren Sie zu) einem Verzeichnis, in dem das Projekt gespeichert werden soll, und wählen Sie dann **Erstellen**.

Als Nächstes müssen Sie das SDK einbringen. Anweisungen finden Sie unter [Installieren der Bibliothek](broadcast-ios-getting-started.md#broadcast-ios-install) im *Handbuch zum iOS-Broadcast-SDK*.

### So konfigurieren Sie Berechtigungen
<a name="getting-started-broadcast-sdk-ios-config"></a>

Sie müssen die `Info.plist` Ihres Projekts aktualisieren, um zwei neue Einträge hinzuzufügen für `NSCameraUsageDescription` und `NSMicrophoneUsageDescription`. Geben Sie für die Werte benutzerfreundliche Erklärungen an, warum Ihre Anwendung nach Kamera- und Mikrofonzugriff fragt.

![\[Konfigurieren von iOS-Berechtigungen.\]](http://docs.aws.amazon.com/de_de/ivs/latest/RealTimeUserGuide/images/iOS_Configure.png)
