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

Секој што развива на Voximplant знае за концептот на „апликации“ кои ги поврзуваат скриптите во облак, телефонски броеви, корисници, правила и редици за повици едни со други. Едноставно кажано, апликациите се камен-темелник на развојот на нашата платформа, влезна точка во секое решение базирано на Voximplant, бидејќи креирањето апликација е местото каде што сè започнува.

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

Ќе ви треба

• Сметка на Voximplant. Ако го немате, тогаш регистрацијата живее овде;
• Апликација Voximplant, како и скрипта, правило и еден корисник. Сето ова ќе го создадеме во ова упатство;
• веб-клиент за да остварите повик - користете го нашиот веб-телефон phone.voximplant.com.

Поставки за Voximplant

Прво, најавете се на вашата сметка: управување.voximplant.com/auth. Во менито лево, кликнете „Апликации“, потоа „Нова апликација“ и креирајте апликација наречена складирање. Одете во новата апликација, префрлете се на картичката Скрипти за да креирате скрипта за countingCalls со следниов код:

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

});

Првата линија го поврзува модулот ApplicationStorage, а остатокот од логиката се става во управувачот на настани CallAlerting.

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

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

Следно, треба да ја зголемите клучната вредност во складиштето:

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

ВНИМАВАЈТЕ

За секое ветување, мора експлицитно да наведете справување со неуспехот, како што е прикажано во списокот погоре - инаку скриптата ќе престане да работи и ќе видите грешка во дневниците. Детали тука.

По работа со складиштето, скриптата одговара на дојдовниот повик користејќи синтеза на глас и ви кажува колку пати сте се јавиле претходно. По оваа порака, скриптата ја завршува сесијата.

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

Последното нешто е да креирате корисник. За да го направите ова, одете во „Корисници“, кликнете „Креирај корисник“, наведете име (на пример, корисник1) и лозинка, потоа кликнете „Креирај“. Ќе ни треба овој пар најава-лозинка за автентикација во веб-телефонот.

Проверка

Отворете го веб-телефонот користејќи ја врската phone.voximplant.com и најавете се користејќи го името на вашата сметка, името на апликацијата и парот корисничко име-лозинка од апликацијата. По успешното најавување, внесете кој било сет на знаци во полето за внесување и кликнете Повикај. Ако сè е направено правилно, ќе слушнете синтетизиран поздрав!

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

Извор: www.habr.com