Shranjevanje ključ-vrednost, ali kako so naše aplikacije postale bolj uporabne

Tisti, ki razvijajo na Voximplant, vedo za koncept 'aplikacij', ki med seboj povezujejo oblačne scenarije, telefonske številke, uporabnike, pravila in čakalne vrste klicev. Preprosto povedano, aplikacije so temeljni kamen razvoja na naši platformi, vstopna točka v katerokoli rešitev, ki temelji na Voximplant, saj se vse začne s stvaritvijo aplikacije.

Preden aplikacije 'niso pomnile' ne dejanj, ki jih izvajajo scenariji, ne rezultatov izračunov, tako da so bili razvijalci prisiljeni shranjevati vrednosti v zunanjih storitvah ali na svojem backendu. Če ste kdaj delali z lokalnim shranjevanjem v brskalniku, je naša nova funkcionalnost precej podobna temu, saj aplikacijam omogoča, da si zapomnijo pare 'ključ-vrednost', ki so edinstveni za vsako aplikacijo v vašem računu. Delo shranjevanja je postalo možno zahvaljujoč novemu modulu ApplicationStorage – pod to boste našli kratko navodilo za uporabo, dobrodošli!

Potrebovali boste

• račun Voximplant. Če ga še nimate, lahko registracijo opravite tukaj;
• aplikacijo Voximplant, pa tudi scenarij, pravilo in enega uporabnika. Vse to bomo ustvarili v tem vadnici;
• spletnega odjemalca, da opravite klic – uporabili bomo našo spletno telefonijo phone.voximplant.com.

Nastavitve Voximplant

Najprej se prijavite v svoj račun: manage.voximplant.com/auth. V levem meniju kliknite 'Aplikacije', nato 'Nova aplikacija' in ustvarite aplikacijo z imenom storage. Vstopite v novo aplikacijo, preklopite na zavihek 'Scenariji', da ustvarite scenarij countingCalls s takim kodo:

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('Napaka pri pridobivanju vrednosti totalCalls');
    }

    try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    } catch(e) {
        Logger.write('Napaka pri posodabljanju vrednosti totalCalls');
    }
    
    e.call.answer();
    e.call.say(`Pozdravljeni.  Število prejšnjih klicev: ${r.value}. `, Language.RU_RUSSIAN_MALE);

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

});

Prva vrstica povezuje modul ApplicationStorage, preostala logika pa je spravljena v obdelovalec dogodkov CallAlerting.

Najpre najavimo varijablu kako bismo mogli uporediti početnu vrednost sa brojačem poziva. Zatim pokušavamo da dobijemo vrednost ključa totalCalls iz skladišta. Ako takav ključ još ne postoji, kreiramo ga:

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

Zatim je potrebno povećati vrednost ključa u skladištu:

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

OBRATITE PAŽNJU

Za svaki promis je potrebno jasno naznačiti obradu greške, kao što je prikazano u gornjem kodu – u suprotnom će izvršavanje skripte biti zaustavljeno, a u logovima ćete videti grešku. Detalji tukaj.

Nakon rada sa skladištem, skripta odgovara na dolazni poziv putem glasovne sinteze i govori koliko ste puta prethodno zvali. Nakon ovog obaveštenja, skripta završava sesiju.

Nakon što ste sačuvali skriptu, idite na karticu 'Routiranje' vašeg приложения i kliknite 'Novo pravilo'. Nazovite ga startCounting, navedite skriptu countingCalls i ostavite masku na podrazumevanu (.*).

Poslednje je kreiranje korisnika. Da biste to učinili, idite na 'Korisnici', kliknite 'Kreiraj korisnika', navedite ime (na primer, user1) i lozinku, zatim kliknite 'Kreiraj'. Ova kombinacija korisničkog imena i lozinke biće nam potrebna za autentifikaciju u veb telefonu.

Proveravamo.

Otvorite veb telefon putem linka phone.voximplant.com i prijavite se koristeći ime naloga, naziv aplikacije i kombinaciju korisničkog imena i lozinke korisnika iz aplikacije. Nakon uspešnog prijavljivanja, unesite bilo koji niz karaktera u polje za unos i pritisnite Call. Ako je sve urađeno ispravno, čućete sintetizovani pozdrav!

Želimo vam sjajan razvoj na Voximplant i pratite vesti – biće ih još mnogo 😉

Izvor: habr.com