Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
JoinStorageSession
Note
Avant de l'utiliserAPI, vous devez appeler le GetSignalingChannelEndpoint API pour demander le WEBRTC point de terminaison. Vous spécifiez ensuite le point de terminaison et la région dans votre JoinStorageSession API demande.
Participez à la RTC session Web de vidéo unidirectionnelle et/ou audio multidirectionnelle en cours en tant que dispositif de production vidéo pour un canal d'entrée. S'il n'existe pas de session pour le canal, créez une nouvelle session de streaming et fournissez le nom de ressource Amazon (ARN) du canal de signalisation.
Actuellement, pour SINGLE_MASTER ce type, un appareil de production vidéo est capable d'ingérer à la fois du contenu audio et vidéo dans un flux. Seuls les appareils de production vidéo peuvent rejoindre la session et enregistrer du contenu multimédia.
Important
Des pistes audio et vidéo sont actuellement requises pour RTC l'ingestion sur le Web.
Exigences actuelles :
-
Piste vidéo : H.264
-
Piste audio : Opus
La vidéo ingérée qui en résulte dans le flux vidéo Kinesis comportera les paramètres suivants : vidéo et audio H.264. AAC
Une fois qu'un participant principal a négocié une connexion via le WebRTC, la session multimédia ingérée est enregistrée dans le flux vidéo Kinesis. Plusieurs spectateurs peuvent ensuite lire du contenu multimédia en temps réel via notre fonction PlaybackAPIs.
Vous pouvez également utiliser les fonctionnalités existantes de Kinesis Video Streams, HLS telles que DASH la lecture, la génération d'images GetImagesvia, etc., avec du contenu multimédia Web ingéréRTC.
Note
La livraison d'images et les notifications S3 ne sont actuellement pas prises en charge.
Note
Supposons qu'un seul appareil de production vidéo client puisse être associé à une session pour le canal. Si plusieurs clients rejoignent la session d'une chaîne spécifique en tant que périphérique de production vidéo, la demande la plus récente du client a priorité.
Informations supplémentaires
-
Idempotent - Ce n'APIest pas idempotent.
-
Comportement des nouvelles tentatives : ceci est considéré comme un nouvel API appel.
-
Appels simultanés - Les appels simultanés sont autorisés. Une offre est envoyée une fois par appel.
Syntaxe de la requête
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "string"
}URIParamètres de demande
La demande n'utilise aucun URI paramètre.
Corps de la requête
La demande accepte les données suivantes au JSON format suivant.
- channelArn
-
Le nom de ressource Amazon (ARN) du canal de signalisation.
Important
Notez la capitalisation de ce paramètre d'entrée.
Type : chaîne
Modèle :
^arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+$Obligatoire : oui
Syntaxe de la réponse
HTTP/1.1 200
Eléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 200 avec un HTTP corps vide.
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- AccessDeniedException
-
Vous ne disposez pas des autorisations requises pour effectuer cette opération.
HTTPCode de statut : 403
- ClientLimitExceededException
-
Kinesis Video Streams a limité le nombre de demandes car vous avez dépassé le nombre maximal d'appels clients autorisés. Essayez de passer l'appel plus tard.
HTTPCode de statut : 400
- InvalidArgumentException
-
La valeur de ce paramètre d'entrée n'est pas valide.
HTTPCode de statut : 400
- ResourceNotFoundException
-
La ressource spécifiée est introuvable.
HTTPCode de statut : 404
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
