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à.
Consente all'applicazione multimediale SIP di registrare contenuti multimediali da un determinato ID di chiamata. Ad esempio, un'applicazione di posta vocale e gli annunci dei partecipanti alla riunione. L'applicazione registra fino al raggiungimento della durata impostata, o quando un utente preme una delle opzioni o quando l'applicazione rileva il RecordingTerminators
silenzio. In questi casi, l'azione indica all'applicazione di inserire il file multimediale risultante nel bucket S3 specificato. Il bucket S3 deve appartenere allo stesso AWS account dell'applicazione multimediale SIP. Inoltre, l'azione deve concedere s3:PutObject
l's3:PutObjectAcl
autorizzazione al responsabile del servizio Amazon Chime SDK Voice Connector, al responsabile del servizio Amazon Chime SDK Voice Connector,. voiceconnector.chime.amazonaws.com
Nota
Le registrazioni effettuate utilizzando questa funzionalità possono essere soggette a leggi o regolamenti relativi alla registrazione delle comunicazioni elettroniche. È responsabilità dell'utente e degli utenti finali rispettare tutte le leggi applicabili in materia di registrazione, inclusa la corretta notifica a tutti i partecipanti a una sessione o comunicazione registrata che la sessione o la comunicazione è in corso di registrazione e l'ottenimento del loro consenso.
L'esempio seguente fornisce l's3:PutObjectAcl
autorizzazione s3:PutObject
e al responsabile del servizio Amazon Chime SDK Voice Connector.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "SMARead",
"Effect": "Allow",
"Principal": {
"Service": "voiceconnector.chime.amazonaws.com"
},
"Action": [
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": "arn:aws:s3:::bucket-name
/*"
}
]
}
L'esempio seguente interrompe la registrazione quando il chiamante preme il tasto cancelletto (#), o trascorrono 10 secondi senza alcuna attività, oppure il chiamante rimane in silenzio per 3 secondi e scrive il file multimediale risultante nella posizione definita dal parametro. RecordingDestination
Nota
Questo esempio utilizza il parametro. CallId
È possibile utilizzare invece il ParticipantTag
parametro, ma non entrambi.
{
"Type": "RecordAudio",
"Parameters": {
"CallId": "call-id-1
",
"DurationInSeconds": "10
",
"SilenceDurationInSeconds": 3
,
"SilenceThreshold": 100
,
"RecordingTerminators": [
"#
"
],
"RecordingDestination": {
"Type": "S3",
"BucketName": "valid-bucket-name
",
"Prefix": "valid-prefix-name
"
}
}
}
- CallId
-
Descrizione:
CallId
del partecipante all'CallDetails
invocazione della AWS Lambda funzioneValori consentiti: un ID di chiamata valido
Obbligatorio: no
Valore predefinito - nessuno
- ParticipantTag
-
Descrizione:
ParticipantTag
di uno dei partecipanti connessi alCallDetails
Valori consentiti,
LEG-A
oppureLEG-B
Obbligatorio: no
Valore predefinito:
ParticipantTag
del valorecallLeg
Ignorato richiamato, se si specificaCallId
- RecordingDestination.Type
-
Descrizione: tipo di destinazione. Solo S3.
Valori consentiti: S3
Obbligatorio: Sì
Valore predefinito - nessuno
- RecordingDestination.BucketName
-
Descrizione: un nome di bucket S3 valido. Il bucket deve avere accesso al principale servizio Amazon Chime SDK Voice Connector,.
voiceconnector.chime.amazonaws.com
Valori consentiti: un bucket S3 valido per il quale Amazon Chime SDK ha accesso alle azioni e.
s3:PutObject
s3:PutObjectAcl
Obbligatorio: sì
Valore predefinito - nessuno
- RecordingDestination.Prefisso
-
Descrizione: prefisso S3 del file di registrazione
Valori consentiti: un nome di prefisso valido contenente fino a 979 caratteri sicuri. Per ulteriori informazioni sui caratteri sicuri, consulta Caratteri sicuri nella Guida per l'utente di Amazon Simple Storage Service.
Obbligatorio: no
Impostazione predefinita: nessuna. Se non specificato, le registrazioni vengono salvate nella radice del bucket S3.
- DurationInSeconds
-
Descrizione: la durata della registrazione, in secondi
Valori consentiti: >0
Obbligatorio: no
Valore predefinito - nessuno
- SilenceDurationInSeconds
-
Descrizione: la durata del silenzio in secondi, dopo la quale la registrazione si interrompe. Se non viene specificato, il rilevamento del silenzio è disabilitato.
Valori consentiti: [1; 1000]
Obbligatorio: no
Valore predefinito: 200
- SilenceThreshold
-
Descrizione: livello di rumore considerato «silenzio». Se non si specifica
SilenceDurationInSeconds
, questo parametro viene ignorato.Valori di riferimento (livelli di rumore e soglie per trattare il rumore come silenzio):
1-30 dB o inferiore, ad esempio in una stanza silenziosa
100—40-50 dB, ad esempio un sussurro o un ufficio silenzioso
200—60 dB, ad esempio in un ufficio affollato
1000-75 dB, ad esempio una persona rumorosa o musica
Valori consentiti: [1; 1000]
Obbligatorio: no
Valore predefinito: 200
- RecordingTerminators
-
Descrizione: elenca tutti i terminatori di registrazione disponibili.
Valori consentiti: una matrice di singole cifre e simboli tratti da [123456789*0#]
Obbligatorio: sì
Valore predefinito - nessuno
Gestione degli eventi ACTION_SUCCESSFUL
Al termine della registrazione, l'applicazione multimediale SIP Amazon Chime SDK chiama la AWS Lambda funzione e le trasmette l'evento ACTION_SUCCESSFUL, insieme ai risultati della chiamata.
{
"SchemaVersion": "1.0",
"Sequence": INTEGER,
"InvocationEventType": "ACTION_SUCCESSFUL",
"ActionData": {
"Type" : "RecordAudio",
"Parameters": {
...
},
"RecordingDestination": {
"Type": "S3",
"BucketName": "valid-bucket-name
",
"Key": "valid-S3-key
"
},
"RecordingTerminatorUsed":"#
"
},
"CallDetails": {
...
}
}
L'evento contiene, che contiene i seguenti campiACTION_SUCCESSFUL
: ActionData
- Type
-
Descrizione: il tipo di azione,
RecordAudio
. - Parameters
-
Descrizione: i parametri dell'azione.
- RecordingDestination.Type
-
Descrizione: tipo di destinazione. Solo S3.
- RecordingDestination.BucketName
-
Descrizione: il bucket S3 che contiene il file di registrazione.
- RecordingDestination.Key
-
Descrizione: la chiave S3 del file di registrazione.
- RecordingTerminatorUsed
-
Descrizione: il terminatore utilizzato per interrompere la registrazione, uno dei terminatori passati nel parametro.
RecordingTerminators
Se la registrazione si interrompe dopo aver raggiunto la durata massima (DurationInSeconds
) o a causa del silenzio (SilenceDurationInSeconds
), questa coppia chiave-valore non è inclusa nell'output.
Gestione degli errori
In caso di errori di convalida, l'applicazione multimediale SIP richiama la AWS Lambda funzione con il messaggio di errore appropriato. La tabella seguente elenca i possibili messaggi di errore.
Errore | Messaggio | Motivo |
---|---|---|
|
Si è verificato un errore durante il caricamento della registrazione nel bucket S3. |
Qualsiasi parametro non è valido. |
|
Errore di sistema durante l'esecuzione di un'azione. |
Si è verificato un altro tipo di errore di sistema durante l'esecuzione di un'azione. |
Manipolazione ACTION_FAILED events
Quando l'azione non riesce a registrare i file multimediali su una sessione di chiamata, l'applicazione multimediale SIP richiama una AWS Lambda funzione con il ACTION_FAILED
tipo di evento. Guarda l'esempio seguente.
{
"SchemaVersion": "1.0",
"Sequence": 5
,
"InvocationEventType": "ACTION_FAILED",
"ActionData": {
"Type" : "RecordAudio",
"Parameters": {
...
},
"ErrorType": "InvalidActionParameter",
"ErrorMessage": "RecordingDestination parameter value is invalid."
},
"CallDetails": {
...
}
}
Guarda un esempio funzionante su: GitHub https://github.com/aws-samples/amazon-chime-sma-bridging