Võtmeväärtuste salvestus ehk kuidas meie rakendused on muutunud mugavamaks

Kõik, kes Voximplantis arendavad, on teadlikud "rakenduste" kontseptsioonist, mis ühendavad omavahel pilveskripte, telefoninumbreid, kasutajaid, reegleid ja kõnejärjekordi. Lihtsamalt öeldes on rakendused meie platvormi arenduse nurgakivi, mis tahes Voximplant-põhise lahenduse sisenemise punkt, kuna kõik saab alguse rakenduse loomisest.

Varem ei mäletanud rakendused ei skriptide tehtud toiminguid ega arvutuste tulemusi, nii et arendajad olid sunnitud salvestama väärtusi kolmandate osapoolte teenustesse või oma taustaprogrammi. Kui olete kunagi brauseris kohaliku salvestusruumiga töötanud, on meie uus funktsioon sellega väga sarnane, kuna. Võimaldab rakendustel meeles pidada võtme-väärtuste paare, mis on teie konto iga rakenduse jaoks ainulaadsed. Salvestustöö sai võimalikuks tänu uuele moodulile ApplicationStorage - lõike alt leiad lühikese juhendi, kuidas seda kasutada, tere tulemast!

Peate

• Voximplant konto. Kui sul seda pole, siis registreerimine elab siin;
• rakendus Voximplant, samuti skript, reegel ja üks kasutaja. Kõik see loome selles õpetuses;
• veebiklient helistamiseks – kasutage meie veebitelefoni phone.voximplant.com.

Voximplant'i seaded

Esimene sisselogimine oma kontole: manage.voximplant.com/auth. Klõpsake vasakpoolses menüüs "Rakendused", seejärel "Uus rakendus" ja looge rakendus nimega salvestusruum. Avage uus rakendus, minge vahekaardile Skriptid, et luua järgmise koodiga countingCallsi skript:

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

});

Esimene rida ühendab moodulit ApplicationStorage, ülejäänud loogika paigutatakse sündmuste käitlejasse kõne märguanne.

Esiteks deklareerime muutuja, et saaksime võrrelda algväärtust kõnede arvuga. Seejärel proovime poest saada totalCalls võtme väärtust. Kui sellist võtit veel pole, loome selle:

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

Järgmisena peate suurendama võtme väärtust salvestusruumis:

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

TÄHELEPANU

Iga lubaduse puhul peate selgelt määrama tõrkesiirde, nagu on näidatud ülaltoodud loendis – vastasel juhul skript peatatakse ja logides näete viga. Üksikasjad siin.

Pärast hoidlaga töötamist vastab skript sissetulevale kõnele häälsünteesi abil ja ütleb teile, mitu korda olete varem helistanud. Pärast seda teadet lõpetab skript seansi.

Kui olete skripti salvestanud, minge oma rakenduse vahekaardile Marsruutimine ja klõpsake nuppu Uus reegel. Nimetage see startCounting, määrake skript countingCalls ja jätke vaikemask (.*).

Viimane on kasutaja loomine. Selleks minge "Kasutajad", klõpsake "Loo kasutaja", sisestage nimi (näiteks kasutaja1) ja parool, seejärel klõpsake "Loo". Vajame seda sisselogimis-parooli paari veebitelefonis autentimiseks.

Kontrollige

Avage veebitelefon lingilt phone.voximplant.com ja logige sisse, kasutades rakenduse konto nime, rakenduse nime ja kasutajanime/parooli paari. Pärast edukat sisselogimist sisestage sisestusväljale mis tahes märgikomplekt ja klõpsake nuppu Helista. Kui kõik tehti õigesti, kuulete sünteesitud tervitust!

Soovime teile Voximplantis suurepärast arengut ja püsige lainel – meil on veel palju 😉

Allikas: www.habr.com