RecordAudio

Ermöglicht der SIP-Medienanwendung, Medien von einer bestimmten Anruf-ID aufzuzeichnen. Zum Beispiel eine Voicemail-Anwendung und Ankündigungen von Besprechungsteilnehmern. Die Anwendung zeichnet auf, bis die von Ihnen festgelegte Dauer erreicht ist, bis ein Benutzer eine der Tasten drückt oder bis die Anwendung feststelltRecordingTerminators, dass keine Pause eingelegt ist. In diesen Fällen weist die Aktion Ihre Anwendung an, die resultierende Mediendatei in den angegebenen S3-Bucket zu legen. Der S3-Bucket muss zu demselbenAWS Konto gehören wie die SIP-Medienanwendung. Darüber hinaus muss die Aktion dem Amazon Chime SDK Voice Connector Service Principal, Amazon Chime SDK Voice Connector Service Principal, eines3:PutObjectAcl Genehmigung erteilenvoiceconnector.chime.amazonaws.com.s3:PutObject

Anmerkung

Aufzeichnungen, die mit dieser Funktion gemacht wurden, können Gesetzen oder Vorschriften zur Aufzeichnung elektronischer Kommunikation unterliegen. Es liegt in Ihrer Verantwortung und Ihrer Endnutzer, alle geltenden Gesetze in Bezug auf die Aufzeichnung einzuhalten, einschließlich der ordnungsgemäßen Benachrichtigung aller Teilnehmer einer aufgezeichneten Sitzung oder Kommunikation darüber, dass die Sitzung oder Kommunikation aufgezeichnet wird, und deren Zustimmung einzuholen.

Das folgende Beispiel erteilt dem Amazon Chime SDK Voice Connector-Dienstprinzipal dies3:PutObjectAcl Berechtigungs3:PutObject und.

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

Im folgenden Beispiel wird die Aufnahme beendet, wenn der Anrufer die Raute-Taste (#) drückt, oder wenn 10 Sekunden ohne Aktivität vergehen oder der Anrufer 3 Sekunden lang schweigt und die resultierende Mediendatei in den durch denRecordingDestination Parameter definierten Speicherort schreibt.

Anmerkung

In diesem Beispiel wird derCallId Parameter verwendet. Sie können stattdessen denParticipantTag Parameter verwenden, aber Sie können nicht beide verwenden.

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

Beschreibung —CallId des TeilnehmersCallDetails amAWS Lambda Funktionsaufruf

Zulässige Werte — Eine gültige Anruf-ID

Erforderlich — Nein

Standardwert – Kein

ParticipantTag

Beschreibung —ParticipantTag von einem der verbundenen Teilnehmer derCallDetails

Zulässige Werte —LEG-A oderLEG-B

Erforderlich — Nein

Standardwert —ParticipantTag der aufgerufenen OptioncallLeg Ignoriert, wenn Sie dies angebenCallId

RecordingDestination.Typ

Beschreibung — Art des Ziels. Nur S3.

Zulässige Werte — S3

Erforderlich — Ja

Standardwert – Kein

RecordingDestination.BucketName

Beschreibung — Ein gültiger S3-Bucket-Name. Der Bucket muss Zugriff auf den Amazon Chime SDK Voice Connector Service Principal haben,voiceconnector.chime.amazonaws.com.

Zulässige Werte — Ein gültiger S3-Bucket, für den Amazon Chime SDK Zugriff auf dies3:PutObjectAcl Aktionens3:PutObject und hat.

Erforderlich — Ja

Standardwert – Kein

RecordingDestination.Präfix

Beschreibung — S3-Präfix der Aufnahmedatei

Zulässige Werte — Ein gültiger Präfixname mit bis zu 979 sicheren Zeichen. Weitere Informationen zu sicheren Zeichen finden Sie unter Sichere Zeichen im Konsolenbenutzerhandbuch für Amazon Simple Storage Service.

Erforderlich — Nein

Standard — Keine. Wenn nicht angegeben, werden die Aufzeichnungen im Stammverzeichnis des S3-Buckets gespeichert.

DurationInSeconds

Beschreibung — Die Dauer der Aufnahme in Sekunden

Zulässige Werte — >0

Erforderlich — Nein

Standardwert – Kein

SilenceDurationInSeconds

Beschreibung — Die Dauer der Stille in Sekunden, nach der die Aufnahme beendet wird. Wenn nicht angegeben, ist die Erkennung von Stille deaktiviert.

Zulässige Werte — [1; 1000]

Erforderlich — Nein

Standardwert — 200

SilenceThreshold

Beschreibung — Geräuschpegel, der als „Stille“ gilt. Wenn Sie nicht angebenSilenceDurationInSeconds, wird dieser Parameter ignoriert.

Referenzwerte (Geräuschpegel und Schwellenwerte, um den Lärm als Stille zu behandeln):

• 1—30 dB oder weniger, z. B. in einem ruhigen Raum

• 100—40-50 dB, z. B. in einem flüsternden oder leisen Büro

• 200—60 dB, z. B. in einem überfüllten Büro

• 1000—75 dB, z. B. eine laute Person oder Musik

Zulässige Werte — [1; 1000]

Erforderlich — Nein

Standardwert — 200

RecordingTerminators

Beschreibung — Listet alle verfügbaren Aufnahmeabschlüsse auf.

Zulässige Werte — Ein Array aus einzelnen Ziffern und Symbolen aus [123456789*0#]

Erforderlich — Ja

Standardwert – Kein

Umgang mit ACTION_SUCCESSING-Ereignissen

Wenn die Aufzeichnung beendet ist, ruft die SIP-Medienanwendung des Amazon Chime SDK dieAWS Lambda Funktion auf und übergibt ihr zusammen mit den Aufrufergebnissen das Ereignis ACTION_SUCCESSFUL.

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

DasACTION_SUCCESSFUL Ereignis enthältActionData, das diese Felder enthält:

Typ

Beschreibung — Die Art der Aktion,RecordAudio.

Parameter

Beschreibung — Die Parameter der Aktion.

RecordingDestination.Typ

Beschreibung — Art des Ziels. Nur S3.

RecordingDestination.BucketName

Beschreibung — Der S3-Bucket, der die Aufnahmedatei enthält.

RecordingDestination.Schlüssel

Beschreibung — Der S3-Schlüssel der Aufnahmedatei.

RecordingTerminatorUsed

Beschreibung — Der Terminator, der verwendet wird, um die Aufnahme zu beenden — einer der imRecordingTerminators Parameter übergebenen Terminatoren. Wenn die Aufnahme nach Erreichen der maximalen Dauer (DurationInSeconds) oder aufgrund von Stille (SilenceDurationInSeconds) beendet wird, wird dieses Schlüssel-Wert-Paar nicht in der Ausgabe enthalten.

Fehlerbehandlung

Bei Validierungsfehlern ruft die SIP-Medienanwendung dieAWS Lambda Funktion mit der entsprechenden Fehlermeldung auf. In der folgenden Tabelle finden Sie die möglichen Fehlermeldungen.

Fehler	Fehlermeldung	Grund
InvalidActionParameter	CallIdoder derParticipantTag Aktionsparameter ist ungültig. DurationInSecondsDer Parameterwert ist ungültig. SilenceDurationInSecondsDer Parameterwert ist ungültig. SilenceThresholdDer Parameterwert ist ungültig. RecordingDestinationDer Parameterwert ist ungültig. Beim Hochladen der Aufzeichnung in den S3-Bucket ist ein Fehler aufgetreten.	Jeder Parameter ist ungültig.
SystemException	Systemfehler beim Ausführen einer Aktion.	Beim Ausführen einer Aktion ist ein anderer Systemfehler aufgetreten.

Behandlung von ACTION_FAILED-Ereignissen

Wenn die Aktion die Medien auf einer Anrufablage nicht aufzeichnen kann, ruft die SIP-Medienanwendung eineAWS Lambda Funktion mit demACTION_FAILED Ereignistyp auf. Sehen Sie sich das folgende -Beispiel an.

{
    "SchemaVersion": "1.0",
    "Sequence": 5,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type" : "RecordAudio",
        "Parameters": {
           ...           
        },
        "ErrorType": "InvalidActionParameter",
        "ErrorMessage": "RecordingDestination parameter value is invalid."
    },
    "CallDetails": {
        ...
    }
}

Ein funktionierendes Beispiel finden Sie auf GitHub: https://github.com/aws-samples/amazon-chime-sma-bridging