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 amCallDetails
AWS Lambda FunktionsaufrufZulässige Werte — Eine gültige Anruf-ID
Erforderlich — Nein
Standardwert – Kein
- ParticipantTag
-
Beschreibung —
ParticipantTag
eines der verbundenen Teilnehmer an derCallDetails
Zulässige Werte —
LEG-A
oderLEG-B
Erforderlich — Nein
Standardwert —
ParticipantTag
der aufgerufene Wert wirdcallLeg
ignoriert, wenn Sie Folgendes angebenCallId
- 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
Aktionens3: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 angeben
SilenceDurationInSeconds
, 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 |
---|---|---|
|
Beim Hochladen der Aufzeichnung in den S3-Bucket ist ein Fehler aufgetreten. |
Jeder Parameter ist ungültig. |
|
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": { ... } }