Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# JoinStorageSession
**nota**
Antes de usar esta API, debe llamar a la `GetSignalingChannelEndpoint` API para solicitar el punto final WEBRTC. A continuación, especifique el punto final y la región en su solicitud de `JoinStorageSession` API.
Únase a la sesión actual de WebRTC de and/or audio multidireccional de vídeo unidireccional como dispositivo de producción de vídeo para un canal de entrada. Si no hay ninguna sesión existente para el canal, cree una nueva sesión de streaming y proporcione el nombre de recurso de Amazon (ARN) del canal de señalización.
Actualmente, para `SINGLE_MASTER` este tipo, un dispositivo de producción de vídeo es capaz de incorporar contenido multimedia de audio y vídeo en una transmisión. Solo los dispositivos de producción de vídeo pueden unirse a la sesión y grabar contenido multimedia.
**importante**
Actualmente, se requieren pistas de audio y vídeo para la ingesta de WebRTC.
Requisitos actuales:
Pista de vídeo: H.264
Pista de audio: Opus
Video:
La resolución máxima es SQFHD (1920x1920)
La ingestión de WebRTC de KVS admite actualmente un conjunto específico de perfiles H264:
línea base restringida
referencia
main
high
restringido-alto
progresivo-alto
El vídeo ingerido resultante en la transmisión de vídeo de Kinesis tendrá los siguientes parámetros: vídeo H.264 y audio AAC.
Una vez que el participante principal haya negociado una conexión a través de WebRTC, la sesión multimedia ingerida se almacenará en la transmisión de vídeo de Kinesis. De este modo, varios espectadores podrán reproducir contenido multimedia en tiempo real a través de nuestra función de reproducción. APIs
También puede utilizar las funciones existentes de Kinesis Video Streams, `HLS` como `DASH` la reproducción, la generación de imágenes [GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html)mediante, etc., con medios WebRTC incorporados.
**nota**
Actualmente, no se admiten la entrega de imágenes ni las notificaciones de S3.
**nota**
Suponga que solo se puede asociar un cliente de un dispositivo de producción de vídeo a una sesión del canal. Si más de un cliente se une a la sesión de un canal específico como dispositivo de producción de vídeo, prevalece la solicitud más reciente del cliente.
**Información adicional**
+ **Idempotente**: esta API no es idempotente.
+ **Comportamiento de reintento**: se considera una nueva llamada a la API.
+ **Llamadas simultáneas**: se permiten las llamadas simultáneas. Se envía una oferta por cada llamada.
## Sintaxis de la solicitud
```
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "{{string}}"
}
```
## Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [channelArn](#API_webrtc_JoinStorageSession_RequestSyntax) **
El nombre de recurso de Amazon (ARN) del canal de señalización.
Tenga en cuenta el uso de mayúsculas en este parámetro de entrada.
Tipo: cadena
Patrón: `arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
## Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).
** AccessDeniedException **
No tiene los permisos necesarios para realizar esta operación.
Código de estado HTTP: 403
** ClientLimitExceededException **
Kinesis Video Streams ha limitado la solicitud porque ha superado el límite de llamadas de clientes permitidas. Intente realizar la llamada más tarde.
Código de estado HTTP: 400
** InvalidArgumentException **
El valor de este parámetro de entrada no es válido.
Código de estado HTTP: 400
** ResourceNotFoundException **
No se encuentra el recurso especificado.
Código de estado HTTP: 404
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)