View a markdown version of this page

RecordAudio - SDK Amazon Chime
Gestione degli eventi ACTION_SUCCESSFULGestione ACTION_FAILED eventi

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à.

RecordAudio

Consente all'applicazione multimediale SIP di registrare contenuti multimediali da un determinato ID di chiamata. Ad esempio, un'applicazione di segreteria telefonica e gli annunci dei partecipanti alla riunione. L'applicazione registra fino al raggiungimento della durata impostata, o quando un utente preme uno dei pulsanti o quando l'applicazione rileva RecordingTerminators il 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 fornire s3:PutObject e s3:PutObjectAcl autorizzare l'entità principale del servizio Amazon Chime SDK Voice Connector, l'entità 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 di comunicazioni elettroniche. È responsabilità dell'utente e degli utenti finali rispettare tutte le leggi applicabili relative alla registrazione, inclusa la corretta notifica a tutti i partecipanti a una sessione o comunicazione registrata che la sessione o la comunicazione è in fase di registrazione e l'ottenimento del loro consenso.

Il seguente esempio di policy IAM concede le s3:PutObjectAcl autorizzazioni s3:PutObject e al principale del servizio Amazon Chime SDK Voice Connector:

Esempio: politica IAM per la registrazione delle chiamate
{
    "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/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

L'esempio seguente interrompe la registrazione quando il chiamante preme il tasto cancelletto (#) o trascorrono 10 secondi senza alcuna attività o 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 alla CallDetails chiamata della AWS Lambda funzione

Valori consentiti: un ID di chiamata valido

Obbligatorio: no

Valore predefinito - nessuno

ParticipantTag

Descrizione: ParticipantTag di uno dei partecipanti connessi al CallDetails

Valori consentiti — LEG-A o LEG-B

Obbligatorio: no

Valore predefinito: ParticipantTag del valore callLeg Ignorato richiamato se si specifica CallId

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 servizio principale di 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 and. s3:PutObject s3:PutObjectAcl

Obbligatorio: Sì

Valore predefinito - nessuno

RecordingDestination.Prefix

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 la sezione Caratteri sicuri nella Amazon Simple Storage Service User Guide.

Obbligatorio: no

Impostazione predefinita: nessuna. Se non specificato, le registrazioni vengono salvate nella directory principale 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 specificato, il rilevamento del silenzio è disabilitato.

Valori consentiti: [1; 1000]

Obbligatorio: no

Valore predefinito: 200

SilenceThreshold

Descrizione: livello di rumore considerato «silenzio». Se non lo specifichiSilenceDurationInSeconds, 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 ad alto volume 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 cifre e simboli singoli a partire 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 passa l'evento ACTION_SUCCESSFUL, insieme ai risultati dell'invocazione.

{
    "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'ACTION_SUCCESSFULevento contiene, che contiene i seguenti campi: 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 chiama la AWS Lambda funzione con il messaggio di errore appropriato. La tabella seguente elenca i possibili messaggi di errore.

Errore Messaggio Motivo

InvalidActionParameter

CallIdo ParticipantTag il parametro di azione non è valido.

DurationInSecondsil valore del parametro non è valido.

SilenceDurationInSecondsil valore del parametro non è valido.

SilenceThresholdil valore del parametro non è valido.

RecordingDestinationil valore del parametro non è valido.

Si è verificato un errore durante il caricamento della registrazione nel bucket S3.

Qualsiasi parametro non è valido.

SystemException

Errore di sistema durante l'esecuzione di un'azione.

Si è verificato un altro tipo di errore di sistema durante l'esecuzione di un'azione.

Gestione ACTION_FAILED eventi

Quando l'azione non riesce a registrare il file multimediale su un segmento di chiamata, l'applicazione multimediale SIP richiama una AWS Lambda funzione con il tipo di evento. ACTION_FAILED 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