Складиштење кључ/вредност или како су наше апликације постале практичније

Свако ко развија на Вокимпланту зна за концепт „апликација“ које међусобно повезују скрипте у облаку, бројеве телефона, кориснике, правила и редове позива. Једноставно речено, апликације су камен темељац развоја на нашој платформи, улазна тачка у било које решење засновано на Вокимплант-у, јер креирање апликације је место где све почиње.

Раније, апликације нису „памтиле“ ни радње које су скрипте изводиле, ни резултате прорачуна, па су програмери били приморани да чувају вредности у услугама трећих страна или на њиховој позадини. Ако сте икада радили са локалним складиштем у претраживачу, онда је наша нова функционалност прилично слична овој, јер Омогућава апликацијама да памте парове кључ/вредност који су јединствени за сваку апликацију на вашем налогу. Рад складишта је омогућен захваљујући новом модулу АпплицатионСтораге – испод реза ћете наћи кратак водич како да га користите, добродошли!

Потребан вам је

• Вокимплант налог. Ако га немате, онда регистрација живи овде;
• Вокимплант апликација, као и скрипта, правило и један корисник. Све ово ћемо креирати у овом туторијалу;
• веб клијент за позивање - користите наш веб телефон пхоне.вокимплант.цом.

Вокимплант сеттингс

Прво се пријавите на свој налог: манаге.вокимплант.цом/аутх. У менију са леве стране кликните на „Апликације“, затим на „Нова апликација“ и креирајте апликацију под називом складиште. Идите на нову апликацију, пређите на картицу Скрипте да бисте креирали скрипту за бројање позива са следећим кодом:

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

});

Прва линија повезује модул АпплицатионСтораге, остатак логике је смештен у обрађивач догађаја ЦаллАлертинг.

Прво декларишемо променљиву тако да можемо да упоредимо почетну вредност са бројачем позива. Затим покушавамо да добијемо вредност кључа тоталЦаллс из продавнице. Ако такав кључ још не постоји, онда га креирамо:

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

Затим морате повећати вредност кључа у складишту:

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

НАПОМЕНА

За свако обећање морате експлицитно да наведете руковање грешкама, као што је приказано у листи изнад - у супротном ће скрипта престати да се изводи и видећете грешку у евиденцији. Детаљи овде.

Након рада са спремиштем, скрипта одговара на долазни позив користећи синтезу гласа и говори вам колико пута сте раније позвали. Након ове поруке, скрипта завршава сесију.

Када сачувате скрипту, идите на картицу Роутинг у вашој апликацији и кликните на Ново правило. Назовите га стартЦоунтинг, наведите скрипту цоунтингЦаллс и оставите подразумевану маску (.*).

Последња ствар је креирање корисника. Да бисте то урадили, идите на „Корисници“, кликните на „Креирај корисника“, наведите име (на пример, усер1) и лозинку, а затим кликните на „Креирај“. Биће нам потребан овај пар за пријаву и лозинку за аутентификацију на веб телефону.

Провера

Отворите веб телефон користећи везу пхоне.вокимплант.цом и пријавите се користећи име свог налога, име апликације и пар корисничко име-лозинка из апликације. Након успешне пријаве, унесите било који скуп знакова у поље за унос и кликните на Позови. Ако је све урађено како треба, чућете синтетизовани поздрав!

Желимо вам одличан развој на Вокимпланту и останите са нама за још вести - имаћемо још много 😉

Извор: ввв.хабр.цом