Ruajtja e vlerës së çelësit ose mënyra se si aplikacionet tona janë bërë më të përshtatshme

Kushdo që zhvillon në Voximplant di për konceptin e "aplikacioneve" që lidhin skriptet e cloud, numrat e telefonit, përdoruesit, rregullat dhe radhët e thirrjeve me njëri-tjetrin. E thënë thjesht, aplikacionet janë gurthemeli i zhvillimit në platformën tonë, pika hyrëse në çdo zgjidhje të bazuar në Voximplant, pasi krijimi i një aplikacioni është vendi ku gjithçka fillon.

Më parë, aplikacionet nuk "kujtonin" as veprimet që kryenin skriptet dhe as rezultatet e llogaritjeve, kështu që zhvilluesit u detyruan të ruanin vlerat në shërbimet e palëve të treta ose në pjesën e pasme të tyre. Nëse keni punuar ndonjëherë me ruajtjen lokale në një shfletues, atëherë funksionaliteti ynë i ri është mjaft i ngjashëm me këtë, sepse... Lejon aplikacionet të mbajnë mend çifte çelës-vlera që janë unike për secilin aplikacion në llogarinë tuaj. Funksionimi i ruajtjes u bë i mundur falë modulit të ri Ruajtja e aplikacionit – poshtë prerjes do të gjeni një udhëzues të shkurtër se si ta përdorni, mirë se vini!

Ju do të keni nevojë

• Llogaria e Voximplantit. Nëse nuk e keni, atëherë regjistrimi jeton këtu;
• Aplikimi Voximplant, si dhe një skenar, një rregull dhe një përdorues. Ne do t'i krijojmë të gjitha këto në këtë tutorial;
• klienti në internet për të bërë një telefonatë - përdorni telefonin tonë në internet telefon.voximplant.com.

Cilësimet e Voximplantit

Së pari, hyni në llogarinë tuaj: menaxhoj.voximplant.com/auth. Në menynë në të majtë, klikoni "Aplikacionet", më pas "Aplikacioni i ri" dhe krijoni një aplikacion të quajtur "Storage". Shkoni te aplikacioni i ri, kaloni te skeda Scripts për të krijuar një skript countingCalls me kodin e mëposhtëm:

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);

});

Rreshti i parë lidh modulin ApplicationStorage, pjesa tjetër e logjikës vendoset në mbajtësin e ngjarjeve CallAlerting.

Së pari ne deklarojmë një variabël në mënyrë që të krahasojmë vlerën fillestare me numëruesin e thirrjeve. Pastaj përpiqemi të marrim vlerën e çelësit totalCalls nga dyqani. Nëse një çelës i tillë nuk ekziston ende, atëherë ne e krijojmë atë:

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

Tjetra, duhet të rrisni vlerën kryesore në ruajtje:

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

SHËNIM

Për çdo premtim, duhet të specifikoni në mënyrë eksplicite trajtimin e dështimit, siç tregohet në listën e mësipërme - përndryshe skripti do të ndalojë së funksionuari dhe do të shihni një gabim në regjistrat. Detajet këtu.

Pas punës me depon, skripti i përgjigjet thirrjes hyrëse duke përdorur sintezën e zërit dhe ju tregon sa herë keni thirrur më parë. Pas këtij mesazhi, skripti përfundon seancën.

Pasi të keni ruajtur skriptin, shkoni te skedari Routing i aplikacionit tuaj dhe klikoni Rregulli i ri. Quajeni startCounting, specifikoni skriptin countingCalls dhe lini maskën e paracaktuar (.*).

Gjëja e fundit është krijimi i një përdoruesi. Për ta bërë këtë, shkoni te "Përdoruesit", klikoni "Krijo një përdorues", specifikoni një emër (për shembull, përdoruesi1) dhe fjalëkalimin, pastaj kliko "Krijo". Ne do të na duhet ky çift identifikimi-fjalëkalim për vërtetim në telefon.

Po kontrollon

Hapni telefonin në internet duke përdorur lidhjen telefon.voximplant.com dhe identifikohuni duke përdorur emrin e llogarisë tuaj, emrin e aplikacionit dhe çiftin emër përdoruesi-fjalëkalim nga aplikacioni. Pas hyrjes me sukses, futni çdo grup karakteresh 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!

Ne ju dëshirojmë zhvillim të madh në Voximplant dhe qëndroni të sintonizuar për më shumë lajme - do të kemi shumë më tepër 😉

Burimi: www.habr.com