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. # Almacenamiento WebRTC de vídeo en Amazon Kinesis El almacenamiento WebRTC de vídeo de Amazon Kinesis admite las siguientes acciones: + [JoinStorageSession](API_webrtc_JoinStorageSession.md) + [JoinStorageSessionAsViewer](API_webrtc_JoinStorageSessionAsViewer.md) # 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\$1\$1](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) # JoinStorageSessionAsViewer **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 `JoinStorageSessionAsViewer` API. `JoinStorageSessionAsViewer`permite al espectador unirse a una sesión de streaming WebRTC grabada en la nube en curso. Esta API inicia una conexión WebRTC enviando una oferta de SDP y candidatos a ICE entre el espectador y el agente de grabación, lo que permite al espectador recibir vídeo en tiempo real del maestro a través del agente de grabación y participar en una comunicación de audio bidireccional a través del agente de grabación. Una vez conectado, el audio del espectador, si se proporciona, se reenvía a todos los demás pares conectados, incluido el participante principal, y se incorpora a la transmisión de WebRTC que se guarda en la transmisión de Kinesis Video. **importante** Por el momento, los espectadores no pueden enviar ninguna pista de vídeo. Los espectadores pueden enviar una pista de audio opcional o no enviar ninguna pista. Requisitos actuales de envío de los espectadores y participantes: Pista de vídeo: no compatible Pista de audio (opcional): Opus Si el participante principal está conectado actualmente al dispositivo de producción de vídeo, 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. **nota** Los espectadores participantes se conectan directamente a la sesión de almacenamiento y no directamente al participante principal. La sesión de almacenamiento se encarga de mezclar, duplicar y enrutar el contenido multimedia al destino adecuado. **nota** Si el participante principal no está presente, los espectadores no podrán escucharse entre sí. Una vez que el espectador participante haya negociado una conexión a través de WebRTC, la sesión de audio ingerida se almacenará en la transmisión de vídeo de Kinesis siempre que el participante principal también esté conectado a la sesión de almacenamiento. 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. **Límites** Los límites actuales están vigentes: + **Número máximo de espectadores:** 3 + **Tiempo máximo que los espectadores permanecen conectados a la sesión de almacenamiento sin la presencia de un participante principal:** 3 minutos **importante** Si un espectador se desconecta de la sesión de almacenamiento (cierra la conexión entre pares), su cuota (límite de espectadores) permanece consumida durante 1 minuto. Durante este período de 1 minuto, el espectador puede invocar esta API con el mismo ID de cliente para volver a unirse a la sesión sin consumir una cuota de espectadores adicional. Transcurrido un minuto, se liberará la cuota de espectadores y estará disponible para que otros espectadores se unan. **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 /joinStorageSessionAsViewer HTTP/1.1 Content-type: application/json { "channelArn": "string", "clientId": "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_JoinStorageSessionAsViewer_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í ** [clientId](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) ** El identificador único del cliente remitente. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres. Patrón: `[a-zA-Z0-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/JoinStorageSessionAsViewer) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)