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 feststellt`RecordingTerminators`, 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html), 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. Dazu gehört auch, alle Teilnehmer einer aufgezeichneten Sitzung oder Kommunikation ordnungsgemäß darüber zu informieren, 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. ------ #### [ JSON ] **** ``` { "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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines-safe-characters) 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ält`ActionData`, das die folgenden 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` | `CallId`oder der `ParticipantTag` Aktionsparameter ist ungültig.
`DurationInSeconds`Der Parameterwert ist ungültig.
`SilenceDurationInSeconds`Der Parameterwert ist ungültig.
`SilenceThreshold`Der Parameterwert ist ungültig.
`RecordingDestination`Der 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](https://github.com/aws-samples/amazon-chime-sma-bridging)