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

StartCallRecording

L'StartCallRecordingazione avvia la registrazione di una sessione di chiamata. Si avvia la registrazione delle chiamate nelle applicazioni multimediali SIP, su richiesta o in risposta a un evento SIP.

È possibile specificare se si desidera registrare la traccia audio per la tappa in entrata, la tratta in uscita o entrambe. Le sezioni seguenti spiegano come utilizzare l'azioneStartCallRecording.

Richiedere un'azione StartCallRecording

L'esempio seguente mostra come richiedere l'StartCallRecordingazione per BOTH le tracce.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Type": "StartCallRecording",
            "Parameters":
            {
                "CallId": "call-id-1",
                "Track": "BOTH",
                "Destination":
                {
                    "Type": "S3",
                    "Location": "valid-bucket-name-and-optional-prefix"
                }
            }
        }
    ]
}

Specificare una destinazione di registrazione

L'SDK Amazon Chime fornisce le registrazioni delle chiamate nel tuo bucket Amazon S3. Il bucket deve appartenere al tuo account. AWS Specificate la posizione del bucket nel Destination parametro dell'StartCallRecordingazione. Il Type campo nel Destination parametro deve essereS3. Il Location campo è composto dal tuo bucket Amazon S3, più un prefisso object-key opzionale in cui viene consegnata la registrazione delle chiamate.

L'applicazione multimediale SIP utilizza la data e l'ora specificateLocation, la data e l'ora della chiamata, l'ID della transazione e l'ID della chiamata per formattare la chiave oggetto Amazon S3. La risposta StartCallRecording all'azione restituisce la chiave dell'oggetto Amazon S3 completa.

Quando fornisci solo il bucket Amazon S3 Location sul campo, l'applicazione multimediale SIP aggiunge un prefisso predefinito Amazon-Chime-SMA-Call-Recordings al percorso Amazon S3. L'applicazione multimediale SIP aggiunge anche l'anno, il mese e il giorno dell'ora di inizio della chiamata per facilitare l'organizzazione delle registrazioni. L'esempio seguente mostra il formato generale di un percorso Amazon S3 con il prefisso predefinito. Questo esempio utilizza myRecordingBucket come valore. Location

myRecordingBucket/Amazon-Chime-SMA-Call-Recordings/2019/03/01/2019–03–01–17–10–00–010_c4640e3b–1478–40fb-8e38–6f6213adf70b_7ab7748e–b47d–4620-ae2c–152617d3333c.wav

L'esempio seguente mostra i dati rappresentati nel percorso di registrazione delle chiamate Amazon S3.

s3Bucket/Amazon-Chime-SMA-Call-Recordings/year/month/date/year-month-date-hour-minute-second-millisecond_transactionId_callId.wav

Quando fornisci il bucket Amazon S3 e il prefisso della chiave oggetto Location sul campo, l'applicazione multimediale SIP utilizza il prefisso della chiave oggetto nel percorso Amazon S3 di destinazione anziché il prefisso predefinito. L'esempio seguente mostra il formato generale di un percorso di registrazione delle chiamate in Amazon S3 con il tuo prefisso. Ad esempio, puoi specificare myRecordingBucket /TechnicalSupport/English come. Location

myRecordingBucket/technicalSupport/english/2019/03/01/2019–03–01–17–10–00–010_c4640e3b1478–40fb–8e38-6f6213adf70b_7ab7748e–b47d–4620–ae2c–152617d3333c.wav

L'esempio seguente mostra i dati nel percorso Amazon S3.

s3Bucket/yourObjectKeyPrefix/year/month/date/year-month-date-hour-minute-second-millisecond_transactionId_callId.wav

La registrazione inviata al tuo bucket Amazon S3 contiene metadati di oggetti Amazon S3 aggiuntivi relativi alla sessione di chiamata. La tabella seguente elenca i metadati degli oggetti Amazon S3 supportati.

Concessione delle autorizzazioni per i bucket Amazon S3

Il bucket Amazon S3 di destinazione deve appartenere allo stesso AWS account dell'applicazione. Inoltre, l'azione deve concedere s3:PutObject l's3:PutObjectAclautorizzazione al responsabile del servizio Amazon Chime SDK Voice Connector,. voiceconnector.chime.amazonaws.com L'esempio seguente concede l'autorizzazione appropriata.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "SIP media applicationRead",
            "Effect": "Allow",
            "Principal": {
                "Service": "voiceconnector.chime.amazonaws.com"
            },
            "Action": [                
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": "arn:aws:s3:::bucket-name/*",
	    "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "aws-account-id"
                }
            }
        }
    ]
}

Il servizio audio PSTN legge e scrive nel bucket S3 per conto dell'applicazione multimediale Sip. Per evitare il confuso problema secondario, puoi limitare le autorizzazioni del bucket S3 a una singola applicazione multimediale SIP.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "SIP media applicationRead",
            "Effect": "Allow",
            "Principal": {
                "Service": "voiceconnector.chime.amazonaws.com"
            },
            "Action": [                
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": "arn:aws:s3:::bucket-name/*",
	    "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "aws-account-id",
                    "aws:SourceArn": "arn:aws:chime:region:aws-account-id:sma/sip-media-application-id"
                }
            }
        }
    ]
}
    

Azione, risposta riuscita.

Quando la registrazione della chiamata viene avviata correttamente durante una sessione di chiamata, l'applicazione multimediale SIP richiama una AWS Lambda funzione con il ACTION_SUCCESSFUL tipo di evento. La posizione della registrazione della chiamata viene restituita nella risposta.

{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type" : "StartCallRecording",
        "Parameters": {
            "CallId": "call-id-1",
            "Track": "BOTH",
            "Destination": {
                "Type": "S3",
                "Location": "valid-bucket-name"
            }
        }
        "CallRecordingDestination": {
            "Type": "S3",
            "Location": "call-recording-bucket-and-key"
        }
    }
    "CallDetails": {
        ...
    }
}

Azione, errore, risposta

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 messaggi di errore.

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 ActionFailed tipo di evento.

L'esempio seguente mostra una tipica risposta di errore.

{
    "SchemaVersion": "1.0",
    "Sequence": 5,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type" : "StartCallRecording",
        "Parameters": {
            "CallId": "call-id-1",
            "Track": "BOTH",
            "Destination": {
                "Type": "S3",
                "Location": "valid-bucket-name"
            }
        }
        "Error": "NoAccessToDestination: Error while accessing destination"
    }
    "CallDetails": {
        ...
    }
}

Vedi un esempio funzionante su GitHub: https://github.com/aws-samples/ amazon-chime-sma-on -demand-recording