Specificazione delle azioni in risposta agli eventi di telefonia per il servizio audio PSTN di Amazon Chime SDK

Nel servizio audio, le applicazioni multimediali SIP AWS Lambda richiamano funzioni. A sua volta, una funzione Lambda può restituire un elenco di istruzioni note come azioni. Un'azione è un elemento che si desidera eseguire durante una chiamata telefonica, ad esempio inviare o ricevere cifre, partecipare a una riunione e così via. Per ulteriori informazioni sulle azioni richiamate dal servizio audio PSTN, vedere. Comprensione degli eventi di telefonia per il servizio audio PSTN Amazon Chime SDK

Quando un'applicazione multimediale SIP esegue correttamente un elenco di azioni, chiama la AWS Lambda funzione con un tipo di evento di invocazione di. ACTION_SUCCESSFUL Se una delle azioni non viene completata, l'applicazione multimediale SIP richiama la AWS Lambda funzione con l'evento. ACTION_FAILED

L'applicazione multimediale SIP viene restituita solo ACTION_SUCCESSFUL se tutte le azioni dell'elenco hanno esito positivo. Se una delle azioni nell'elenco fallisce, l'applicazione multimediale SIP richiama la AWS Lambda funzione con l'ACTION_FAILEDevento e cancella le azioni rimanenti nell'elenco dopo quella fallita. L'applicazione multimediale SIP esegue quindi l'azione successiva restituita dalla funzione. AWS Lambda Si utilizza la ActionData chiave per identificare quale chiamata ha richiamato la funzione.

L'evento seguente mostra un payload di esempio per il tipo di evento di ACTION_SUCCESSFUL invocazione dopo un'azione. PlayAudioAndGetDigits

{
    "SchemaVersion": "1.0",
    "Sequence": 3,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type": "PlayAudioAndGetDigits",
        "Parameters" : {
            "CallId": "call-id-1",
            "AudioSource": {
                "Type": "S3",
                "BucketName": "bucket-name",
                "Key": "failure-audio-file.wav"
            },
            "FailureAudioSource": {
                "Type": "S3",
                "BucketName": "bucket-name",
                "Key": "failure-audio-file.wav"
            },
            "MinNumberOfDigits": 3,
            "MaxNumberOfDigits": 5,
            "TerminatorDigits": ["#"],
            "InBetweenDigitsDurationInMilliseconds": 5000,
            "Repeat": 3,
            "RepeatDurationInMilliseconds": 10000
        },
        "ReceivedDigits": "123"
    }
    "CallDetails": {
        "TransactionId": "transaction-id",
        "AwsAccountId": "aws-account-id",
        "AwsRegion": "us-east-1",
        "SipRuleId": "sip-rule-id",
        "SipApplicationId": "sip-application-id",
        "Participants": [
            {
                "CallId": "call-id-1",
                "ParticipantTag": "LEG-A",
                "To": "+12065551212",
                "From": "+15105550101",
                "Direction": "Inbound",
                "StartTimeInMilliseconds": "159700958834234",
                "Status": "Connected"
                }
            ]
        }
    }
}

Quando un'azione in un elenco non viene completata correttamente, l'applicazione multimediale SIP richiama la AWS Lambda funzione per avvisare l'utente dell'errore e per ottenere un nuovo set di azioni da eseguire su quella chiamata. L'evento seguente mostra il payload di esempio per il tipo di evento di ACTION_FAILED invocazione dopo un'azione. PlayAudio

{
    "SchemaVersion": "1.0",
    "Sequence": 4,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type": "PlayAudio",
        "Parameters" : {
            "CallId": "call-id-1",
            "AudioSource": {
                "Type": "S3",
                "BucketName": "bucket-name",
                "Key": "audio-file.wav"            
            }
        },
        "ErrorType": "InvalidAudioSource",
        "ErrorMessage": "Audio Source parameter value is invalid."
    }
    "CallDetails": {
        "TransactionId": "transaction-id",
        "AwsAccountId": "aws-account-id",
        "AwsRegion": "us-east-1",
        "SipRuleId": "sip-rule-id",
        "SipApplicationId": "sip-application-id",
        "Participants": [
            {
                "CallId": "call-id-1",
                "ParticipantTag": "LEG-A",
                "To": "+12065551212",
                "From": "+15105550101",
                "Direction": "Inbound",
                "StartTimeInMilliseconds": "159700958834234",
                "Status": "Connected"
            }
        ]
    }
}
}