Depoja key-value, ose si aplikacionet tona u bënë më të përshtatshme

Kushdo që zhvillon në Voximplant di për konceptin e "aplikacioneve", të cilat lidhin skenarët cloud, numrat e telefonit, përdoruesit, rregullat dhe radhët e thirrjeve. Në terma të thjeshtë, aplikacionet janë themeli i zhvillimit në platformën tonë, pika hyrëse në çdo zgjidhje bazuar në Voximplant, sepse pikërisht me krijimin e një aplikacioni fillon gjithçka.

Më parë, aplikacionet "nuk e mbahen mend" as veprimet që kryejnë skenarët, as rezultatet e llogaritjeve, kështu që zhvilluesit ishin të detyruar të ruanin vlerat në shërbime të jashtme ose në backend-in e tyre. Nëse keni punuar ndonjëherë me local storage në shfletues, funksionaliteti ynë i ri është shumë i ngjashëm me këtë, pasi lejon aplikacionet të mbajnë mend çiftet "çelës-vlerë", të cilat janë unike për çdo aplikacion në llogarinë tuaj. Funksionimi i magazinës është bërë i mundur falë modulit të ri ApplicationStorage – poshtë ju pret një udhëzues i shkurtër për përdorimin e tij, mirëseerdhët!

Do t'ju nevojitet

• një llogari Voximplant. Nëse nuk e keni atë, atëherë regjistrimi ndodhet këtu;
• një aplikacion Voximplant, si dhe një skenar, një rregull dhe një përdorues. Të gjitha këto do t'i krijojmë në këtë udhëzues;
• një klient web, për të bërë thirrjen – do të përdorim telefonin tonë web phone.voximplant.com.

Cilësimet e Voximplant

Së pari, hyni në llogarinë tuaj: manage.voximplant.com/auth. Në menunë e majtë, klikoni "Aplikacione", pastaj "Aplikacion i ri" dhe krijoni një aplikacion me emrin storage. Hyni në aplikacionin e ri, kaloni te skeda "Skenarët" për të krijuar skenarin countingCalls me këtë kod:

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('Dështim gjatë marrjes së vlerës totalCalls');
    }

    try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    } catch(e) {
        Logger.write('Dështim gjatë përditësimit të vlerës totalCalls');
    }
    
    e.call.answer();
    e.call.say(`Përshëndetje. Numri i thirrjeve të kaluara: ${r.value}. `, Language.RU_RUSSIAN_MALE);

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

});

Rreshti i parë lidh modulit ApplicationStorage, ndërsa logjika tjetër është vendosur në trajtuesin e ngjarjes CallAlerting.

Së pari shpallim një variabël, për të krahasuar vlerën fillestare me numëruesin e thirrjeve. Më pas, përpiqemi të marrim vlerën e çelësit totalCalls nga ruajtja. Nëse çelësi i tillë nuk ekziston akoma, atëherë ne e krijojmë atë:

provoni {
    r = await ApplicationStorage.get('totalCalls');
    nëse (r === null) {
        r = await ApplicationStorage.put('totalCalls', 0);
    }
}

Më pas, nevojitet të rritet vlera e çelësit në ruajtje:

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

KËRKOHUNI VËMENDJE

Për çdo premisë është e nevojshme të specifikohet qartë trajtimi i dështimit, siç është treguar në listën më sipër – përndryshe ekzekutimi i skenarit do të ndalet, dhe në logje do të shihni një gabim. Më shumë detaje këtu.

Pasi të keni punuar me ruajtjen, skenari i përgjigjet një thirrjeje hyrëse përmes sintezës vokale dhe thotë se sa herë keni thiruar deri atëherë. Pas këtij mesazhi, skenari përfundon seancën.

Pas ruajtjes së skenarit, kaloni në skedën "Rruga" të aplikacionit tuaj dhe klikoni "Rregull i ri". Emërojeni atë startCounting, specifikoni skenarin countingCalls dhe lëreni maskën të mbetet në parazgjedhjen e vet (.*).

E fundit – krijoni një përdorues. Për këtë, kaloni te "Përdoruesit", klikoni "Krijo përdorues", specifikoni emrin (p.sh. user1) dhe fjalëkalimin, pastaj klikoni "Krijo". Kjo çift emër përdoruesi-fjalëkalim do të na nevojitet për autentifikimin në webfon.

Po kontrollojmë

Hapni webfonin përmes lidhjes phone.voximplant.com dhe hyni, duke përdorur emrin e llogarisë, emrin e aplikacionit dhe çiftin emër përdoruesi-fjalëkalim nga aplikacioni. Pas hyrjes së suksesshme, shkruani çdo grup simbolesh në fushën e hyrjes dhe klikoni Call. Nëse gjithçka është bërë siç duhet, do të dëgjoni një përshëndetje të sintetizuar!

Ju urojmë zhvillim të shkëlqyer në Voximplant dhe qëndroni të informuar – do të kemi shumë më tepër lajme 😉

Burimi: habr.com