RecordAudio - Amazon Chime SDK
Behandlung von ACTION_SUCCESSFULCBehandlung von ACTION_FAILED Ereignissen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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 Dauer erreicht ist, die Sie festgelegt haben, oder wenn ein Benutzer auf eine der Tasten drückt oder bis die Anwendung feststelltRecordingTerminators, dass Stille ausbleibt. 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 demselben AWS Konto gehören wie die SIP-Medienanwendung. Darüber hinaus muss die Aktion dem Amazon Chime SDK Voice Connector-Serviceprinzipal, dem Amazon Chime SDK Voice Connector-Serviceprinzipal, eine s3:PutObjectAcl Genehmigung erteilt werden. s3:PutObject voiceconnector.chime.amazonaws.com

Anmerkung

Aufzeichnungen, die mit dieser Funktion aufgenommen wurden, können Gesetzen oder Vorschriften in Bezug auf die Aufzeichnung elektronischer Kommunikation unterliegen. Es liegt in Ihrer Verantwortung und Ihren Endnutzern, 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-Serviceprinzipal die s3:PutObjectAcl Berechtigung s3: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 Rautetaste (#) drückt oder wenn 10 Sekunden ohne Aktivität vergehen oder der Anrufer 3 Sekunden lang stumm bleibt und die resultierende Mediendatei an den durch den Parameter definierten Ort schreibt. RecordingDestination

Anmerkung

In diesem Beispiel wird der Parameter verwendet. CallId Sie können stattdessen den ParticipantTag 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 Teilnehmers am CallDetails AWS Lambda Funktionsaufruf

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

Erforderlich — Nein

Standardwert – Kein

ParticipantTag

Beschreibung — ParticipantTag eines der verbundenen Teilnehmer an der CallDetails

Zulässige Werte — LEG-A oder LEG-B

Erforderlich — Nein

Standardwert — ParticipantTag der aufgerufene Wert wird callLeg ignoriert, wenn Sie Folgendes angeben CallId

RecordingDestination.Type

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 das Amazon Chime SDK Zugriff auf die s3:PutObjectAcl Aktionen s3:PutObject und hat.

Erforderlich — Ja

Standardwert – Kein

RecordingDestination.Prefix

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 Amazon Simple Storage Service-Benutzerhandbuch.

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 nichts 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. ein Flüsterton oder ein leises Büro

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

  • 1000—75 dB, z. B. bei lauter Person oder Musik

Zulässige Werte — [1; 1000]

Erforderlich — Nein

Standardwert — 200

RecordingTerminators

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

Zulässige Werte — Eine Reihe von einzelnen Ziffern und Symbolen aus [123456789*0#]

Erforderlich — Ja

Standardwert – Kein

Behandlung von ACTION_SUCCESSFULC

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

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

Das ACTION_SUCCESSFUL Ereignis enthältActionData, das folgende Felder enthält:

Type

Beschreibung — Der Typ der Aktion,RecordAudio.

Parameters

Beschreibung — Die Parameter der Aktion.

RecordingDestination.Type

Beschreibung — Art des Ziels. Nur S3.

RecordingDestination.BucketName

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

RecordingDestination.Key

Beschreibung — Der S3-Schlüssel der Aufnahmedatei.

RecordingTerminatorUsed

Beschreibung — Das Abschlusszeichen, mit dem die Aufnahme beendet wurde — eines der im Parameter übergebenen Abschlusszeichen. RecordingTerminators Wenn die Aufnahme nach Erreichen der maximalen Dauer (DurationInSeconds) oder aufgrund von Stille (SilenceDurationInSeconds) beendet wird, ist dieses Schlüssel-Wert-Paar nicht in der Ausgabe enthalten.

Fehlerbehandlung

Bei Validierungsfehlern ruft die SIP-Medienanwendung die AWS Lambda Funktion mit der entsprechenden Fehlermeldung auf. In der folgenden Tabelle sind die möglichen Fehlermeldungen aufgeführt.

Fehler Fehlermeldung Grund

InvalidActionParameter

CallIdoder der ParticipantTag 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 eines Anrufabschnitts nicht aufzeichnet, ruft die SIP-Medienanwendung eine AWS Lambda Funktion mit dem ACTION_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 unter GitHub: https://github.com/aws-samples/ amazon-chime-sma-bridging