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.
JoinStorageSessionAsViewer
nota
La RTC ingesta web con soporte para varios visores (versión preliminar) se proporciona en la versión preliminar, tal como se define en las condiciones del AWS servicio, y está sujeta a cambios. Actualmente solo está disponible en IAD us-east-1 ().
nota
Antes de usarloAPI, debes llamar al GetSignalingChannelEndpoint API para solicitar el WEBRTC punto final. A continuación, especifique el punto final y la región en su JoinStorageSessionAsViewer 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.
importante
Actualmente, 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 y audio H.264. AAC
Los espectadores participantes podrán escucharse unos a otros y también recibir contenido multimedia del participante principal a través de Internet. RTC
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 la 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 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.
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 invocarlo 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á el cupo de espectadores y estará disponible para que otros espectadores se unan a él.
Información adicional
-
Idempotente: esto 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 /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json
{
"channelArn": "string",
"clientId": "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í
- clientId
-
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 HTTP el 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:
