Grundlegendes zum Programmiermodell des PSTN Audio Service

Der PSTN Audio-Dienst verwendet ein Anforderungs-/Antwort-Programmiermodell, das wiederum Funktionen verwendet. AWS Lambda Ihre AWS Lambda Funktion wird automatisch für eingehende und ausgehende Anrufe aufgerufen. Wenn beispielsweise ein neuer eingehender Anruf eingeht, ruft der PSTN-Audiodienst Ihre AWS Lambda Funktion mit einem NEW_INCOMING_CALL Ereignis auf und wartet auf Befehle, die als Aktionen bezeichnet werden. Ihre Anwendung kann beispielsweise Aktionen wie das Abspielen einer Audioaufforderung, das Sammeln von Ziffern, das Aufzeichnen von Audio oder das Weiterleiten des Anrufs auswählen. Diese Aktionen im JSON-Format werden mithilfe eines Rückrufs von Ihrer Funktion an den PSTN-Audiodienst zurückgesendet. AWS Lambda

Dieses Beispiel zeigt eine Aktion. PlayAudio

{
    "Type": "PlayAudio",
    "Parameters": {
        "CallId": "call-id-1",
        "ParticipantTag": "LEG-A",
        "PlaybackTerminators": ["1", "8", "#"],
        "Repeat": "5",
        "AudioSource": {
            "Type": "S3",
            "BucketName": "valid-S3-bucket-name",
            "Key": "wave-file.wav"
        }
    }
}

Dieses Beispiel zeigt eine RecordAudio Aktion.

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

Sobald der PSTN Audio-Dienst die Aktion ausführt, ruft er Ihre AWS Lambda Funktion erneut auf und gibt entweder eine Erfolgs- oder eine Fehlschlagsmeldung aus.

Ihre Anwendung kann auch ausgehende Telefonanrufe tätigen und Ihre AWS Lambda Funktion verwenden, um den Anrufablauf, das Anrufererlebnis und den Anrufkontext zu steuern. In diesem Fall rufen Sie die CreateSipMediaApplicationCallAPI auf und Ihre AWS Lambda wird mit einem Ereignis aufgerufen. NEW_OUTBOUND_CALL Sobald der Anruf beantwortet wurde, können Sie Aktionen wie das Abspielen einer Sprachansage und das Sammeln von vom Benutzer eingegebenen Ziffern zurückgeben. Sie können Ihre AWS Lambda Funktion auch mithilfe der UpdateSipMediaApplicationCallAPI auslösen, um Timer, Teilnehmerstummschaltung und Warteräume zu implementieren.