Skladište key-value, ili kako su naše aplikacije postale praktičnije

Tko razvija na Voximplant zna za koncept "aplikacija" koje međusobno povezuju oblačne scenarije, telefonske brojeve, korisnike, pravila i redove poziva. Jednostavno rečeno, aplikacije su temelj razvoja na našoj platformi, ulazna tačka u bilo koje rešenje zasnovano na Voximplant, jer sve počinje od kreiranja aplikacije.

Ranije aplikacije "nisu pamtile" ni akcije koje scenariji izvode, ni rezultate izračunavanja, pa su programeri bili prisiljeni čuvati vrednosti na spoljnim uslugama ili na svojoj pozadini. Ako ste ikada radili s lokalnom pohranom u pretraživaču, naša nova funkcionalnost je slična tome, jer omogućava aplikacijama da pamte parove "ključ-vrednost" koji su jedinstveni za svaku aplikaciju u vašem računu. Rad skladišta postao je moguć zahvaljujući novom modulu ApplicationStorage – ispod vas čeka kratki vodič za njegovu upotrebu, dobrodošli!

Trebaće vam

• Voximplant račun. Ako ga nemate, registracija je ovde prijava za Voximplant, kao i scenarij, pravilo i jedan korisnik. Sve ćemo to kreirati u ovom tutorijalu;;
• web klijent kako bismo obavili poziv – iskoristimo naš web telefon
• phone.voximplant.com Podešavanja Voximplant.

Prvo se prijavite na svoj račun:

manage.voximplant.com/auth . U meniju s leva kliknite na "Aplikacije", zatim "Nova aplikacija" i kreirajte aplikaciju pod nazivom storage. Uđite u novu aplikaciju, prebacite se na karticu "Scenariji" kako biste kreirali scenarij countingCalls s ovim kodom: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('Greška prilikom dobijanja vrednosti totalCalls'); }try { await ApplicationStorage.put('totalCalls', (r.value | 0) + 1); } catch(e) { Logger.write('Greška prilikom ažuriranja vrednosti totalCalls'); } e.call.answer(); e.call.say(`Pozdrav. Broj prethodnih poziva: ${r.value}. `, Language.RU_RUSSIAN_MALE);e.call.addEventListener(CallEvents.PlaybackFinished, VoxEngine.terminate);});

Prvi redak povezuje modul ApplicationStorage, a ostatak logike je smješten u obradnik događaja

CallAlerting CallAlerting.

Prvo izjavljujemo varijablu kako bismo mogli usporediti početnu vrijednost s brojačem poziva. Zatim pokušavamo dobiti vrijednost ključa totalCalls iz spremišta. Ako takvog ključa još nema, stvaramo ga:

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

Zatim je potrebno povećati vrijednost ključa u spremištu:

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

OBRATITE PAŽNJU

Za svaku obećanje potrebno je izričito navesti obradu greške, kao što je prikazano u gornjem isječku – inače će izvođenje skripte biti zaustavljeno, a u logovima ćete vidjeti grešku. Detalji ovdje.

Nakon rada sa spremištem, skripta odgovara na dolazni poziv pomoću glasovne sinteze i govori koliko ste puta zvali prije. Nakon te poruke, skripta završava sesiju.

Nakon što ste sačuvali skriptu, idite na karticu "Rutiranje" vaše aplikacije i kliknite "Novo pravilo". Nazovite ga startCounting, navedite skriptu countingCalls i ostavite masku zadano (.*).

Posljednje – kreirati korisnika. Za to idite na "Korisnici", kliknite "Kreiraj korisnika", navedite ime (npr. user1) i lozinku, zatim kliknite "Kreiraj". Ova kombinacija korisničkog imena i lozinke bit će nam potrebna za autentifikaciju u web telefonu.

Provjeravamo

Otvorite web telefon putem veze Podešavanja Voximplant i prijavite se koristeći ime računa, naziv aplikacije i par korisničkog imena i lozinke korisnika iz aplikacije. Nakon uspješnog prijavljivanja, unesite bilo koji niz znakova u polje za unos i pritisnite Call. Ako je sve napravljeno ispravno, čut ćete sintetizirani pozdrav!

Želimo vam uspješan razvoj na Voximplant i pratite vijesti – bit će ih još puno 😉

Izvor: habr.com