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.
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 vídeo unidireccional y/o audio multidireccional 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
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 GetImagesmediante, 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
-
El nombre de recurso de Amazon (ARN) del canal de señalización.
importante
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 Errores comunes.
- 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:
