Schlüsselwertspeicher oder wie unsere Anwendungen komfortabler geworden sind

Jeder, der auf Voximplant entwickelt, kennt das Konzept von „Apps“, die Cloud-Skripte, Telefonnummern, Benutzer, Regeln und Anrufwarteschlangen miteinander verbinden. Einfach ausgedrückt sind Anwendungen der Eckpfeiler der Entwicklung auf unserer Plattform, der Einstiegspunkt in jede Voximplant-basierte Lösung, denn mit der Erstellung einer Anwendung beginnt alles.

Bisher „merkten“ sich Anwendungen weder an die von Skripten durchgeführten Aktionen noch an die Ergebnisse von Berechnungen, sodass Entwickler gezwungen waren, Werte in Diensten von Drittanbietern oder in ihrem Backend zu speichern. Wenn Sie schon einmal mit lokaler Speicherung in einem Browser gearbeitet haben, dann ist unsere neue Funktionalität dieser ziemlich ähnlich, denn... Ermöglicht Apps, sich Schlüssel-Wert-Paare zu merken, die für jede App in Ihrem Konto eindeutig sind. Der Betrieb des Speichers wurde dank des neuen Moduls möglich Anwendungsspeicher – unter dem Schnitt finden Sie eine kurze Anleitung zur Verwendung, herzlich willkommen!

Du wirst brauchen

• Voximplant-Konto. Wenn Sie es nicht haben, dann Die Anmeldung lebt hier;
• Voximplant-Anwendung sowie ein Skript, eine Regel und ein Benutzer. All dies werden wir in diesem Tutorial erstellen;
• Web-Client zum Tätigen eines Anrufs – nutzen Sie unser Webphone phone.voximplant.com.

Voximplant-Einstellungen

Melden Sie sich zunächst bei Ihrem Konto an: manage.voximplant.com/auth. Klicken Sie im Menü links auf „Anwendungen“, dann auf „Neue Anwendung“ und erstellen Sie eine Anwendung namens „Speicher“. Gehen Sie zur neuen Anwendung und wechseln Sie zur Registerkarte „Skripte“, um ein countingCalls-Skript mit dem folgenden 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('Failure while getting totalCalls value');
    }

    try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    } catch(e) {
        Logger.write('Failure while updating totalCalls value');
    }
    
    e.call.answer();
    e.call.say(`Приветствую.  Количество прошлых звонков: ${r.value}. `, Language.RU_RUSSIAN_MALE);

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

});

Die erste Zeile verbindet das ApplicationStorage-Modul, der Rest der Logik wird im Event-Handler platziert CallAlerting.

Zuerst deklarieren wir eine Variable, damit wir den Anfangswert mit dem Aufrufzähler vergleichen können. Dann versuchen wir, den Wert des totalCalls-Schlüssels aus dem Store abzurufen. Wenn ein solcher Schlüssel noch nicht existiert, dann erstellen wir ihn:

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

Als nächstes müssen Sie den Schlüsselwert im Speicher erhöhen:

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

BITTE BEACHTEN

Für jedes Versprechen müssen Sie die Fehlerbehandlung explizit angeben, wie in der obigen Auflistung gezeigt. Andernfalls wird die Ausführung des Skripts gestoppt und in den Protokollen wird ein Fehler angezeigt. Einzelheiten hier.

Nach der Arbeit mit dem Repository beantwortet das Skript den eingehenden Anruf mithilfe der Sprachsynthese und teilt Ihnen mit, wie oft Sie zuvor angerufen haben. Nach dieser Meldung beendet das Skript die Sitzung.

Nachdem Sie das Skript gespeichert haben, gehen Sie zur Registerkarte „Routing“ Ihrer Anwendung und klicken Sie auf „Neue Regel“. Nennen Sie es startCounting, geben Sie das countingCalls-Skript an und belassen Sie die Standardmaske (.*).

Als letztes müssen Sie einen Benutzer erstellen. Gehen Sie dazu zu „Benutzer“, klicken Sie auf „Benutzer erstellen“, geben Sie einen Namen (z. B. Benutzer1) und ein Passwort ein und klicken Sie dann auf „Erstellen“. Dieses Login-Passwort-Paar benötigen wir zur Authentifizierung im Webphone.

Überprüfung

Öffnen Sie das Webphone über den Link phone.voximplant.com und melden Sie sich mit Ihrem Kontonamen, Anwendungsnamen und Benutzername-Passwort-Paar aus der Anwendung an. Geben Sie nach erfolgreicher Anmeldung einen beliebigen Zeichensatz in das Eingabefeld ein und klicken Sie auf Anrufen. Wenn alles richtig gemacht wurde, hören Sie eine synthetische Begrüßung!

Wir wünschen Ihnen eine tolle Entwicklung bei Voximplant und bleiben auf dem Laufenden für weitere Neuigkeiten – wir werden noch viel mehr haben 😉

Source: habr.com