Ein Key-Value-Speicher, oder wie unsere Anwendungen benutzerfreundlicher wurden.

Wer auf Voximplant entwickelt, ist mit dem Konzept von "Anwendungen" vertraut, die cloudbasierte Szenarien, Telefonnummern, Benutzer, Regeln und Warteschlangen miteinander verbinden. Einfach gesagt, Anwendungen sind der Grundpfeiler der Entwicklung auf unserer Plattform und der Einstieg in jede Lösung auf Basis von Voximplant, denn alles beginnt mit der Erstellung einer Anwendung.

Früher "speicherten" Anwendungen weder die Aktionen, die die Szenarien ausführten, noch die Ergebnisse der Berechnungen, sodass Entwickler gezwungen waren, Werte in externen Diensten oder auf ihrem Backend zu speichern. Wenn Sie jemals mit Local Storage im Browser gearbeitet haben, ist unsere neue Funktionalität sehr ähnlich, da sie Anwendungen ermöglicht, Paare von "Schlüssel-Wert" zu speichern, die für jede Anwendung in Ihrem Konto einzigartig sind. Die Funktionsweise des Speichers wurde durch ein neues Modul möglich gemacht. ApplicationStorage – im Folgenden finden Sie eine kurze Anleitung zur Nutzung, herzlich willkommen!

Sie benötigen

• ein Voximplant-Konto. Wenn Sie noch keines haben, wird die Registrierung hier angeboten.;
• eine Voximplant-Anwendung sowie ein Szenario, eine Regel und einen Benutzer. All dies werden wir in diesem Tutorial erstellen;
• Web-Client, um einen Anruf zu tätigen – verwenden Sie unsere Webphone phone.voximplant.com.

Voximplant Einstellungen

Zuerst melden Sie sich in Ihrem Konto an: manage.voximplant.com/auth. Klicken Sie im linken Menü auf „Anwendungen“, dann auf „Neue Anwendung“ und erstellen Sie eine Anwendung mit dem Namen storage. Gehen Sie zur neuen Anwendung, wechseln Sie zum Tab „Skripte“, um ein Skript namens countingCalls mit folgendem Code zu erstellen:

require(Modules.ApplicationStorage);

VoxEngine.addEventListener(AppEvents.CallAlerting, async (e) => {
let r = {value: -1};

    try {
        r = await ApplicationStorage.get('totalCalls');
        if (r === null) {
            r = await ApplicationStorage.put('totalCalls', 0);
        }
    } catch(e) {
        Logger.write('Fehler beim Abrufen des totalCalls Wertes');
    }

    try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    } catch(e) {
        Logger.write('Fehler beim Aktualisieren des totalCalls Wertes');
    }
    
    e.call.answer();
    e.call.say(`Willkommen. Anzahl der vorherigen Anrufe: ${r.value}. `, Language.RU_RUSSIAN_MALE);

    e.call.addEventListener(CallEvents.PlaybackFinished, VoxEngine.terminate);

});

Die erste Zeile verbindet das Modul ApplicationStorage, die restliche Logik ist im Ereignis-Handler enthalten. CallAlerting.

Zunächst deklarieren wir die Variable, um den Startwert mit dem Anrufzähler zu vergleichen. Dann versuchen wir, den Wert des Schlüssels totalCalls aus dem Speicher abzurufen. Falls dieser Schlüssel noch nicht vorhanden ist, erstellen wir ihn:

try {
    r = await ApplicationStorage.get('totalCalls');
    if (r === null) {
        r = await ApplicationStorage.put('totalCalls', 0);
    }
}

Als Nächstes müssen wir den Wert des Schlüssels im Speicher erhöhen:

try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    }

BITTE BEACHTEN

Für jedes Promise ist es erforderlich, eine Fehlerbehandlung explizit anzugeben, wie im obigen Listing gezeigt – andernfalls wird die Ausführung des Skripts gestoppt und Sie sehen einen Fehler in den Logs. Weitere Informationen hier.

Nachdem Sie mit dem Speicher gearbeitet haben, antwortet das Skript auf den eingehenden Anruf mit Sprachausgabe und sagt, wie oft Sie zuvor angerufen haben. Nach dieser Mitteilung beendet das Skript die Sitzung.

Nachdem Sie das Skript gespeichert haben, wechseln Sie zum Tab «Routing» Ihrer Anwendung und klicken Sie auf «Neue Regel». Nennen Sie es startCounting, geben Sie das Skript countingCalls an und lassen Sie die Standardmaske (.*) unverändert.

Das Letzte besteht darin, einen Benutzer zu erstellen. Gehen Sie dazu auf „Benutzer“, klicken Sie auf „Benutzer erstellen“, geben Sie einen Namen (zum Beispiel user1) und ein Passwort ein, und klicken Sie dann auf „Erstellen“. Dieses Login-Paar benötigen wir für die Authentifizierung im Webfon.

Wir überprüfen.

Öffnen Sie das Webfon über den Link phone.voximplant.com und melden Sie sich mit dem Kontonamen, dem Anwendungsnamen und dem Benutzer-Login-Paar aus der Anwendung an. Nach erfolgreichem Login geben Sie eine beliebige Zeichenfolge im Eingabefeld ein und drücken Sie auf Anruf. Wenn alles korrekt gemacht wurde, hören Sie einen synthetisierten Begrüßungston!

Wir wünschen Ihnen viel Freude bei der Entwicklung auf Voximplant und bleiben Sie dran – es wird noch viele Neuigkeiten geben 😉

Quelle: habr.com