StartCallRecording

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.

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.

L'StartCallRecordingaction lance l'enregistrement d'un segment d'appel. Vous démarrez l'enregistrement des appels dans vos applications multimédia SIP, soit à la demande, soit en réponse à un événement SIP.

Vous spécifiez si vous souhaitez enregistrer la piste audio de l'étape entrante, de la partie sortante ou des deux. Les sections suivantes expliquent comment utiliser cette StartCallRecording action.

Demander une StartCallRecording action

L'exemple suivant montre comment demander l'StartCallRecordingaction pour les BOTH pistes.

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

Spécification d'une destination d'enregistrement

Le SDK Amazon Chime fournit les enregistrements d'appels à votre compartiment Amazon S3. Le bucket doit appartenir à votre AWS compte. Vous spécifiez l'emplacement du compartiment dans le Destination paramètre de l'StartCallRecordingaction. Le Type champ du Destination paramètre doit êtreS3. Le Location champ comprend votre compartiment Amazon S3, plus un préfixe de clé d'objet facultatif dans lequel l'enregistrement des appels est transmis.

L'application multimédia SIP utilise la date et l'heure spécifiéesLocation, la date et l'heure du segment d'appel, l'ID de transaction et l'ID d'appel pour formater la clé d'objet Amazon S3. La réponse à l'StartCallRecordingaction renvoie la clé complète de l'objet Amazon S3.

Lorsque vous fournissez uniquement le compartiment Amazon S3 Location sur le terrain, l'application multimédia SIP ajoute un préfixe par défautAmazon-Chime-SMA-Call-Recordings, au chemin Amazon S3. L'application multimédia SIP ajoute également l'année, le mois et le jour de début de l'appel pour aider à organiser les enregistrements. L'exemple suivant montre le format général d'un chemin Amazon S3 avec le préfixe par défaut. Cet exemple utilise myRecordingBucket comme Location valeur.

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'exemple suivant montre les données représentées dans le chemin Amazon S3 qui enregistre les appels.

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

Lorsque vous fournissez le compartiment Amazon S3 et le préfixe de clé d'objet Location sur le terrain, l'application multimédia SIP utilise votre préfixe de clé d'objet dans le chemin Amazon S3 de destination au lieu du préfixe par défaut. L'exemple suivant montre le format général d'un appel enregistrant le chemin Amazon S3 avec votre préfixe. Par exemple, vous pouvez spécifier myRecordingBucket /TechnicalSupport/English comme. 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'exemple suivant montre les données du chemin Amazon S3.

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

L'enregistrement envoyé à votre compartiment Amazon S3 contient des métadonnées d'objet Amazon S3 supplémentaires concernant le segment d'appel. Le tableau suivant répertorie les métadonnées d'objets Amazon S3 prises en charge.

Octroi d'autorisations de compartiment Amazon S3

Votre compartiment Amazon S3 de destination doit appartenir au même AWS compte que votre application. En outre, l'action doit donner une s3:PutObject s3:PutObjectAcl autorisation au responsable du service Amazon Chime SDK Voice Connector,. voiceconnector.chime.amazonaws.com L'exemple suivant accorde l'autorisation appropriée.

{
    "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"
                }
            }
        }
    ]
}

Le service audio PSTN lit et écrit dans votre compartiment S3 pour le compte de votre application Sip Media. Pour éviter le problème des adjoints confus, vous pouvez limiter les autorisations du bucket S3 à une seule application multimédia 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"
                }
            }
        }
    ]
}
    

Action, réponse réussie

Lorsque l'enregistrement d'appel est démarré avec succès sur un segment d'appel, l'application multimédia SIP invoque une AWS Lambda fonction du type d'ACTION_SUCCESSFULévénement. L'emplacement de l'enregistrement des appels est renvoyé dans la réponse.

{
    "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": {
        ...
    }
}

Réponse à une erreur d'action

En cas d'erreur de validation, l'application multimédia SIP appelle la AWS Lambda fonction avec le message d'erreur approprié. Le tableau suivant répertorie les messages d'erreur.

Lorsque l'action ne parvient pas à enregistrer le contenu multimédia lors d'un segment d'appel, l'application multimédia SIP invoque une AWS Lambda fonction du type d'ActionFailedévénement.

L'exemple suivant montre une réponse d'erreur typique.

{
    "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": {
        ...
    }
}

Voir un exemple pratique sur GitHub : https://github.com/aws-samples/amazon-chime-sma-on-demand-recording