Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
SendAlexaOfferToMaster
Nota
Prima di utilizzare questa API, devi chiamarla per ottenere un endpoint. GetSignalingChannelEndpoint Devi quindi specificare l'endpoint e la regione nella tua richiesta SendAlexaOfferToMaster API.
Questa API ti consente di connettere dispositivi abilitati per WebRTC con dispositivi di visualizzazione Alexa. Quando viene richiamata, invia l'offerta Alexa Session Description Protocol (SDP) al peer principale. L'offerta viene fornita non appena il master viene collegato al canale di segnalazione specificato. Questa API restituisce la risposta SDP dal master connesso. Se il master non è collegato al canale di segnalazione, le richieste di riconsegna vengono effettuate fino alla scadenza del messaggio.
Sintassi della richiesta
POST /v1/send-alexa-offer-to-master HTTP/1.1
Content-type: application/json
{
"ChannelARN": "string",
"MessagePayload": "string",
"SenderClientId": "string"
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ChannelARN
-
L'Amazon Resource Name (ARN) del canale di segnalazione tramite il quale Alexa e il master peer comunicano.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.
Modello:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+Campo obbligatorio: sì
- MessagePayload
-
L'SDP con codifica base64 offre contenuti.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 10000.
Modello:
[a-zA-Z0-9+/=]+Campo obbligatorio: sì
- SenderClientId
-
L'identificatore univoco del client mittente.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"Answer": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- Answer
-
Il contenuto della risposta SDP con codifica in base 64.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 10000.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- ClientLimitExceededException
-
La tua richiesta è stata limitata perché hai superato il limite di chiamate consentite ai client. Prova a effettuare la chiamata più tardi.
Codice di stato HTTP: 400
- InvalidArgumentException
-
Il valore di questo parametro di input non è valido.
Codice di stato HTTP: 400
- NotAuthorizedException
-
Il chiamante non è autorizzato a eseguire questa operazione.
Codice di stato HTTP: 401
- ResourceNotFoundException
-
La risorsa specificata non è stata trovata.
Codice di stato HTTP: 404
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
