View a markdown version of this page

RecordAudio - Amazon Chime SDK
Behandlung von ACTION_SUCCESSFULHandhabung AKTION IST FEHLGESCHLAGEN Veranstaltungen

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 von Ihnen festgelegte Dauer erreicht ist oder wenn ein Benutzer eine der Tasten drückt oder wenn die RecordingTerminators Anwendung eine Stille feststellt. In diesen Fällen weist die Aktion Ihre Anwendung an, die resultierende Mediendatei in den angegebenen S3-Bucket zu legen. Der S3-Bucket muss zum selben 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 erteilen. s3:PutObject voiceconnector.chime.amazonaws.com

Anmerkung

Aufzeichnungen, die mit dieser Funktion gemacht wurden, können Gesetzen oder Vorschriften in Bezug auf die Aufzeichnung elektronischer Kommunikation unterliegen. Es liegt in Ihrer Verantwortung und Ihrer Endnutzer, alle geltenden Gesetze in Bezug auf die Aufzeichnung einzuhalten. Dazu gehört auch, dass alle Teilnehmer einer aufgezeichneten Sitzung oder Kommunikation ordnungsgemäß darüber informiert werden, dass die Sitzung oder Kommunikation aufgezeichnet wird, und deren Zustimmung einzuholen.

Die folgende Beispiel-IAM-Richtlinie gewährt dem Amazon Chime SDK Voice Connector-Serviceprinzipal die s3:PutObject und s3:PutObjectAcl -Berechtigungen:

Beispiel: IAM-Richtlinie für die Anrufaufzeichnung
{
    "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"
                }
            }
        }
    ]
}

Im folgenden Beispiel wird die Aufzeichnung beendet, wenn der Anrufer die Rautentaste (#) drückt oder wenn 10 Sekunden ohne Aktivität verstreichen oder der Anrufer 3 Sekunden lang stumm bleibt, und die resultierende Mediendatei wird an den durch den Parameter definierten Speicherort geschrieben. 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 des aufgerufenen Objekts 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-Serviceprinzipal haben,voiceconnector.chime.amazonaws.com.

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

Erforderlich — Ja

Standardwert – Kein

RecordingDestination.Prefix

Beschreibung — S3-Präfix der Aufnahmedatei

Zulässige Werte — Ein gültiger Präfixname, der bis zu 979 sichere Zeichen enthält. Weitere Informationen zu sicheren Zeichen finden Sie im Amazon Simple Storage Service-Benutzerhandbuch unter Sichere Zeichen.

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 deren Ablauf die Aufnahme beendet wird. Wenn nicht angegeben, ist die Stilleerkennung 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. bei Flüstern oder leises 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 — Eine Reihe von einzelnen Ziffern und Symbolen aus [123456789*0#]

Erforderlich — Ja

Standardwert – Kein

Behandlung von ACTION_SUCCESSFUL

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

{
    "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 die folgenden Felder enthält:

Type

Beschreibung — Die Art 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 Aufzeichnungsdatei enthält.

RecordingDestination.Key

Beschreibung — Der S3-Schlüssel der Aufzeichnungsdatei.

RecordingTerminatorUsed

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

Fehlerbehandlung

Bei Überprüfungsfehlern 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.

Handhabung AKTION IST FEHLGESCHLAGEN Veranstaltungen

Wenn die Aktion die Medien in einem Anrufabschnitt 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