Shranjevanje ključa in vrednosti ali kako so naše aplikacije postale bolj priročne

Vsakdo, ki razvija na Voximplantu, pozna koncept »aplikacij«, ki med seboj povezujejo skripte v oblaku, telefonske številke, uporabnike, pravila in čakalne vrste klicev. Preprosto povedano, aplikacije so temelj razvoja na naši platformi, vstopna točka v katero koli rešitev, ki temelji na Voximplantu, saj je ustvarjanje aplikacije tam, kjer se vse začne.

Prej si aplikacije niso »zapomnile« niti dejanj, ki so jih izvedli skripti, niti rezultatov izračunov, zato so bili razvijalci prisiljeni shranjevati vrednosti v storitvah tretjih oseb ali v svojem zaledju. Če ste kdaj delali z lokalnim pomnilnikom v brskalniku, je naša nova funkcionalnost precej podobna tej, ker ... Omogoča aplikacijam, da si zapomnijo pare ključ-vrednost, ki so edinstveni za vsako aplikacijo v vašem računu. Delovanje skladišča je postalo možno z novim modulom ApplicationStorage – pod rezom najdete kratek vodnik o uporabi, dobrodošli!

Potrebovali boste

• Račun Voximplant. Če ga nimate, potem registracija živi tukaj;
• Aplikacija Voximplant ter skripta, pravilo in en uporabnik. Vse to bomo ustvarili v tej vadnici;
• spletni odjemalec za klic - uporabite naš spletni telefon phone.voximplant.com.

Nastavitve Voximplanta

Najprej se prijavite v svoj račun: manage.voximplant.com/auth. V meniju na levi kliknite »Aplikacije«, nato »Nova aplikacija« in ustvarite aplikacijo, imenovano shranjevanje. Pojdite v novo aplikacijo, preklopite na zavihek Skripti, da ustvarite skript countingCalls z naslednjo 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('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);

});

Prva vrstica povezuje modul ApplicationStorage, preostala logika je nameščena v obdelovalniku dogodkov CallAlerting.

Najprej deklariramo spremenljivko, da lahko primerjamo začetno vrednost s števcem klicev. Nato poskušamo pridobiti vrednost ključa totalCalls iz trgovine. Če tak ključ še ne obstaja, ga ustvarimo:

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

Nato morate povečati ključno vrednost v pomnilniku:

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

OPOZORILO

Za vsako obljubo morate izrecno podati obravnavo napak, kot je prikazano v zgornjem seznamu – drugače se bo skript prenehal izvajati in v dnevnikih boste videli napako. Podrobnosti tukaj.

Po delu z repozitorijem skript odgovori na dohodni klic z glasovno sintezo in vam pove, kolikokrat ste klicali prej. Po tem sporočilu skript konča sejo.

Ko shranite skript, pojdite na zavihek Usmerjanje v aplikaciji in kliknite Novo pravilo. Pokličite ga startCounting, določite skript countingCalls in pustite privzeto masko (.*).

Zadnja stvar je ustvariti uporabnika. Če želite to narediti, pojdite na »Uporabniki«, kliknite »Ustvari uporabnika«, določite ime (na primer uporabnik1) in geslo ter kliknite »Ustvari«. Ta par prijava-geslo bomo potrebovali za preverjanje pristnosti v spletnem telefonu.

Preverite

Odprite spletni telefon s povezavo phone.voximplant.com in se prijavite z imenom vašega računa, imenom aplikacije in parom uporabniško ime-geslo iz aplikacije. Po uspešni prijavi vnesite poljuben nabor znakov v polje za vnos in kliknite Pokliči. Če je bilo vse narejeno pravilno, boste slišali sintetiziran pozdrav!

Želimo vam velik razvoj na Voximplantu in ostanite z nami za več novic - imeli jih bomo še veliko več 😉

Vir: www.habr.com