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 estoAPI, debe llamar al GetSignalingChannelEndpoint API para solicitar el WEBRTC punto final. A continuación, especifique el punto final y la región en su JoinStorageSession API solicitud.
Únase a la RTC sesión web unidireccional de vídeo y/o audio multidireccional en curso 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 su uso RTC en la Web.
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 y audio H.264. AAC
Una vez que el participante principal haya negociado una conexión a través de la 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 contenido multimedia web incorporado. RTC
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: no API es idempotente.
-
Comportamiento de reintento: se cuenta como una nueva llamada. 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"
}URIParámetros de solicitud
La solicitud no utiliza ningún URI parámetro.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- channelArn
-
El nombre del recurso de Amazon (ARN) del canal de señalización.
importante
Observe 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 de HTTP 200 puntos con el HTTP cuerpo 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.
HTTPCódigo de estado: 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.
HTTPCódigo de estado: 400
- InvalidArgumentException
-
El valor de este parámetro de entrada no es válido.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
No se encuentra el recurso especificado.
HTTPCódigo de estado: 404
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
