

# Paso 4: integrar el SDK de transmisión de IVS
<a name="getting-started-broadcast-sdk"></a>

IVS proporciona un SDK de transmisión para Android, iOS y web que puede integrar en su aplicación. El SDK de transmisión se utiliza tanto para enviar como para recibir videos. Si ha [configurado la ingesta RTMP para su fase](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html), puede utilizar cualquier codificador que pueda transmitir a un punto de conexión de RTMP (por ejemplo, OBS o ffmpeg).

En esta sección, escribimos una aplicación sencilla que permite que dos o más participantes interactúen en tiempo real. Siga los pasos que se indican a continuación para crear una aplicación llamada BasicRealTime. El código completo de la aplicación está en CodePen y 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-transmisión-android-samples](https://github.com/aws-samples/amazon-ivs-real-time-streaming-android-samples) 
+  iOS: [https://github.com/aws-samples/amazon-ivs-real-time-transmisión-ios-samples](https://github.com/aws-samples/amazon-ivs-real-time-streaming-ios-samples) 

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

### Configuración de archivos
<a name="getting-started-broadcast-sdk-web-setup"></a>

Para empezar, cree una carpeta y un archivo HTML y JS inicial para configurar los archivos:

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

Puede instalar el SDK de transmisión mediante una etiqueta script o npm. Nuestro ejemplo usa la etiqueta script por motivos de simplicidad, pero es fácil de modificar si opta por usar npm más adelante.

### Uso de una etiqueta de script
<a name="getting-started-broadcast-sdk-web-script"></a>

El SDK de transmisión web se distribuye como biblioteca de JavaScript y se puede obtener en [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).

Cuando se carga mediante una etiqueta `<script>`, la biblioteca muestra una variable global en el ámbito del intervalo denominado `IVSBroadcastClient`.

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

Para instalar el paquete de npm:

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

Ahora puede acceder al objeto IVSBroadcastClient:

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

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

### Creación del proyecto para Android
<a name="getting-started-broadcast-sdk-android-project"></a>

1. Cree un **nuevo proyecto** en Android Studio.

1. Elija **Actividad de vistas vacías**.

   Nota: En algunas versiones anteriores de Android Studio, la actividad basada en vistas se denomina **Actividad vacía**. Si aparece la ventana de Android Studio **Actividad vacía** y *no* **Actividad de vistas vacías**, seleccione **Actividad vacía**. De lo contrario, no seleccione **Actividad vacía**, ya que utilizaremos las API de vistas (no Jetpack Compose).

1. Asigne un **nombre** a su proyecto y, a continuación, seleccione **Finalizar**.

### Instalación del SDK de transmisión
<a name="getting-started-broadcast-sdk-android-install"></a>

A fin de agregar la biblioteca de transmisión de Android de Amazon IVS a su entorno de desarrollo de Android, agregue la biblioteca al archivo `build.gradle` del módulo como se muestra a continuación (para la versión más reciente del SDK de transmisión de Amazon IVS). En los proyectos más recientes, es posible que el repositorio `mavenCentral` ya esté incluido en su archivo `settings.gradle`, si ese es el caso, puede omitir el bloqueo de `repositories`. Para nuestro ejemplo, también necesitaremos habilitar el enlace de datos en el bloque `android`.

```
android {
    dataBinding.enabled true
}

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

Alternativamente, para instalar el SDK de forma manual, descargue la última versión desde esta ubicación:

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

### Creación del proyecto para iOS
<a name="getting-started-broadcast-sdk-ios-project"></a>

1. Cree un nuevo proyecto de Xcode.

1. En **Plataforma**, seleccione **iOS**.

1. En **Aplicación**, seleccione **Aplicación**.

1. Ingrese el **nombre del producto** de su aplicación y, a continuación, seleccione **Siguiente**.

1. Para elegir un directorio en el que guardar el proyecto, vaya a este y, a continuación, seleccione **Crear**.

A continuación, tiene que incorporar el SDK. Para obtener instrucciones, consulte [Instalación de la biblioteca](broadcast-ios-getting-started.md#broadcast-ios-install) en la *Guía del SDK de transmisión para iOS*.

### Configuración de permisos
<a name="getting-started-broadcast-sdk-ios-config"></a>

Tiene que actualizar el `Info.plist` de su proyecto para agregar dos entradas nuevas para `NSCameraUsageDescription` y `NSMicrophoneUsageDescription`. En los valores, proporcione explicaciones para el usuario sobre por qué la aplicación solicita acceso a la cámara y al micrófono.

![\[Configure los permisos de iOS.\]](http://docs.aws.amazon.com/es_es/ivs/latest/RealTimeUserGuide/images/iOS_Configure.png)
