Aktualisierung laufender Anrufe - Amazon Chime SDK

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.

Aktualisierung laufender Anrufe

Als Teil des PSTN Audio Service können Sie mit SIP-Medienanwendungen Aktionen festlegen, die bei einem Anruf ausgeführt werden, indem Sie benutzerdefinierte Lambda-Funktionen aufrufen, die auf den Anrufereignissen basieren, z. B. einem eingehenden Anruf oder DTMF-Ziffern. Die UpdateSipMediaApplicationCallAPI ermöglicht es Ihnen, jederzeit eine Lambda-Funktion auszulösen, während ein Aufruf aktiv ist. Dabei werden die aktuellen Aktionen durch neue Aktionen ersetzt, die vom Aufruf zurückgegeben werden.

Workflow

Sie verwenden die UpdateSipMediaApplicationCallAPI in einer Vielzahl von Fällen, z. B. beim Hinzufügen von Teilnehmern zu einem Meeting, beim Stummschalten und Aufheben der Stummschaltung von Benutzern, beim Trennen der Verbindung usw. Der folgende Anwendungsfall beschreibt einen typischen Arbeitsablauf.

Ein Benutzer ruft an und hört Musik, während das Amazon Chime SDK das Meeting einrichtet. Sobald die Einrichtung abgeschlossen ist, stoppt das Amazon Chime SDK die Audiowiedergabe und lässt den Anrufer zur Besprechung zu. Gehen Sie als Nächstes davon aus, dass Sie ein separates System verwendenMyMeetingService, das Besprechungen verwaltet. Jeder eingehende Anruf sollte in die Warteschleife gestellt werden. Chime benachrichtigt MyMeetingService über eingehende Anrufe und erstellt MyMeetingService dann für jeden Anruf einen Teilnehmer. Wenn dieser bereit MyMeetingService ist, das Meeting zu starten, benachrichtigt es die SIP-Medienanwendung und stellt ein Token für die Teilnahme an der Besprechung bereit.

Um diesen Fall zu behandeln, muss die Lambda-Funktion die folgende Logik implementieren.

  • Wenn ein neuer eingehender Anruf eingeht, wird Lambda mit einem NEW_INBOUND_CALL Ereignis aufgerufen. Das Lambda ruft den auf MyMeetingService und übergibt dentransactionId, der den aktuellen Aufruf identifiziert, und gibt die PlayAudio Aktion zurück.

  • Wenn der bereit MyMeetingService ist, den Anrufer zum Meeting hinzuzufügen, ruft der Dienst die UpdateSipMediaApplicationCallAPI auf und leitet das transactionId und des Anrufs JoinToken als Teil seiner Argumente weiter. Dieser API-Aufruf löst erneut die Lambda-Funktion aus, jetzt mit dem CALL_UPDATE_REQUESTED Ereignis. Der MyMeetingService übergibt die JoinToken an die Lambda-Funktion als Teil des Ereignisses, und das Token wird verwendet, um die JoinChimeMeeting Aktion an die SIP-Medienanwendung zurückzugeben, die die PlayAudio Aktion unterbricht und den Anrufer mit dem Meeting verbindet.

Diagramm, das den Datenfluss in der API zeigt. UpdateSipMediaApplicationCall
Anmerkung

Die UpdateSipMediaApplicationCallAPI gibt HTTP 202 (Accepted) zurück. Die SIP-Medienanwendung bestätigt, dass der Anruf läuft und aktualisiert werden kann, und versucht daher, die Lambda-Funktion aufzurufen. Der Aufruf erfolgt asynchron, sodass eine erfolgreiche Antwort der API nicht garantiert, dass die Lambda-Funktion gestartet oder abgeschlossen wurde.

Das folgende Beispiel zeigt die Anforderungssyntax.

{ "SipMediaApplicationId": "string", "TransactionId": "string", "Arguments": { "string": "string" } }

Anfrageparameter

  • SipMediaApplicationId— Die ID der SIP-Medienanwendung, die den Anruf bearbeitet.

  • TransactionId— Die ID der Aufruftransaktion. Bei eingehenden Aufrufen TransactionId kann das aus dem NEW_INCOMING_CALL Ereignis abgerufen werden, das bei ihrem ersten Aufruf an die Lambda-Funktion übergeben wurde. Bei ausgehenden Aufrufen TransactionId wird in der Antwort von zurückgegeben. CreateSipMediaApplicationCall

  • Argumente — Benutzerdefinierte Argumente, die der Lambda-Funktion als Teil der CallUpdateRequest Aktionsdaten zur Verfügung gestellt werden. Kann 0 bis 20 Schlüssel-Wert-Paare enthalten.

Das folgende Beispiel zeigt eine typische Anfrage.

aws chime update-sip-media-application-call --sip-media-application-id feb37a7e-2b66-49fb-b2dd-30f4780dc36d --transaction-id 1322a4e7-c106-4e70-aaaf-a8fa4c77c0cb --arguments '{"JoinToken": "abc123"}'

Antwortsyntax

{ "SipMediaApplicationCall": { "TransactionId": "string" } }

Antwortelemente

  • TransactionId— Die ID der Aufruftransaktion, dieselbe ID wie die Anfrage.

Das folgende Beispiel zeigt ein CALL_UPDATE_REQUESTED Aufrufereignis.

{ "SchemaVersion": "1.0", "Sequence": 2, "InvocationEventType": "CALL_UPDATE_REQUESTED", "ActionData": { "Type": "CallUpdateRequest", "Parameters": { "Arguments": { "string": "string" } } }, "CallDetails": { ... } }

Elemente des Ereignisses

  • SchemaVersion— Die Version des JSON-Schemas (1.0)

  • Sequenz — Die Sequenznummer des Ereignisses im Aufruf

  • InvocationEventType— Der Typ des Lambda-Aufrufereignisses, in diesem Fall CALL_UPDATE_REQUESTED

  • ActionData— Die mit der Aktion verknüpften Daten. CallUpdateRequest

    • Typ — Die Art der Aktion, in diesem Fall CallUpdateRequest

    • Parameter — Die Parameter der Aktion

      • Argumente — Die Argumente, die als Teil der UpdateSipMediaApplicationCall API-Anfrage übergeben wurden

  • CallDetails— Die Informationen über den aktuellen Anrufstatus

Grundlegendes zu unterbrechenden und unterbrechungsfreien Aktionen

Wenn eine Lambda-Funktion eine neue Liste von Aktionen zurückgibt, während bestehende Aktionen ausgeführt werden, werden alle Aktionen, die auf die laufende Aktion folgen, durch die neuen Aktionen ersetzt. In einigen Fällen unterbricht die Lambda-Funktion laufende Aktionen, um sofort neue Aktionen auszuführen.

Das folgende Diagramm zeigt ein typisches Beispiel. Der Text unter dem Diagramm erklärt die Logik.

Das Diagramm zeigt, wie Aktionen während eines laufenden SIP-Medienanwendungsaufrufs ersetzt werden können.

Wenn Aktion 2 unterbrechbar ist, beenden wir sie und führen stattdessen die neue Aktion 1 aus.

Wenn Aktion 2 nicht unterbrechbar ist, wird sie abgeschlossen, bevor die neue Aktion 1 beginnt.

In beiden Fällen wird Aktion 3 nicht ausgeführt.

Wenn etwas eine Aktion unterbricht, wird die Lambda-Funktion mit einem Ereignis aufgerufen. ACTION_INTERRUPTED Dieses Ereignis wird nur zu Informationszwecken verwendet. Die SIP-Medienanwendung ignoriert alle Aktionen, die von diesem Aufruf zurückgegeben werden.

Arten von unterbrechbaren Aktionen:

  • PlayAudio

  • RecordAudio

  • Pause

Beispiel-Lambda-Funktion

Dieses Beispiel zeigt eine typische Lambda-Funktion, die eine Audiodatei abspielt, ein Join-Token übergibt und den Aufruf aktualisiert.

const MMS = require('my-meeting-service'); const myMeetingServiceClient = new MMS.Client(); exports.handler = async (event) => { console.log('Request: ' + JSON.stringify(event)); const playAudio = () => { return { Type: 'PlayAudio', Parameters: { ParticipantTag: 'LEG-A', AudioSource: { Type: 'S3', BucketName: 'chime-meetings-audio-files-bucket-name', Key: 'welcome.wav' } } } } const joinChimeMeeting = (joinToken) => { return { Type: 'JoinChimeMeeting', Parameters: { JoinToken: joinToken } } } const response = (...actions) => { const r = { SchemaVersion: '1.0', Actions: actions }; console.log('Response: ' + JSON.stringify(r)); return r; }; switch (event.InvocationEventType) { case 'NEW_INBOUND_CALL': myMeetingServiceClient.addPendingCall(event.CallDetails.TransactionId); return response(playAudio()); case 'CALL_UPDATE_REQUESTED': const joinToken = event.ActionData.Parameters.Arguments['JoinToken'] return response(joinChimeMeeting(joinToken)); default: return response(); } }