Съхранение на ключ-стойност или как нашите приложения са станали по-удобни

Всеки, който разработва на Voximplant, знае за концепцията за „приложения“, които свързват облачни скриптове, телефонни номера, потребители, правила и опашки за обаждания помежду си. Просто казано, приложенията са крайъгълният камък на разработката на нашата платформа, входната точка към всяко базирано на Voximplant решение, тъй като създаването на приложение е мястото, където всичко започва.

Преди това приложенията не „помнеха“ нито действията, които изпълняват скриптовете, нито резултатите от изчисленията, така че разработчиците бяха принудени да съхраняват стойности в услуги на трети страни или в своя бекенд. Ако някога сте работили с локално хранилище в браузър, нашата нова функционалност е доста подобна на тази, защото... Позволява на приложенията да запомнят двойки ключ-стойност, които са уникални за всяко приложение във вашия акаунт. Работата на хранилището стана възможна благодарение на новия модул ApplicationStorage – под разреза ще намерите кратко ръководство как да го използвате, добре дошли!

Ще ви трябва

• Voximplant акаунт. Ако го нямате, тогава регистрацията живее тук;
• Приложение Voximplant, както и скрипт, правило и един потребител. Ще създадем всичко това в този урок;
• уеб клиент за осъществяване на обаждане - използвайте нашия уеб телефон phone.voximplant.com.

Настройки на Voximplant

Първо влезте в акаунта си: manage.voximplant.com/auth. В менюто отляво щракнете върху „Приложения“, след това „Ново приложение“ и създайте приложение, наречено съхранение. Отидете до новото приложение, превключете към раздела Скриптове, за да създадете скрипт за броене на повиквания със следния код:

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

ВНИМАНИЕ

За всяко обещание трябва изрично да укажете обработка на грешки, както е показано в списъка по-горе - в противен случай скриптът ще спре да се изпълнява и ще видите грешка в регистрационните файлове. Подробности тук.

След работа с хранилището, скриптът отговаря на входящото повикване чрез гласов синтез и ви казва колко пъти сте се обаждали преди. След това съобщение скриптът прекратява сесията.

След като запазите скрипта, отидете в раздела Routing на вашето приложение и щракнете върху New Rule. Наречете го startCounting, посочете скрипта countingCalls и оставете маската по подразбиране (.*).

Последното нещо е да създадете потребител. За да направите това, отидете на „Потребители“, щракнете върху „Създаване на потребител“, посочете име (например user1) и парола, след което щракнете върху „Създаване“. Ще ни трябва тази двойка вход-парола за удостоверяване в уеб телефона.

проверите

Отворете уеб телефона, като използвате връзката phone.voximplant.com и влезте, като използвате името на вашия акаунт, името на приложението и двойката потребителско име-парола от приложението. След успешно влизане въведете произволен набор от знаци в полето за въвеждане и щракнете върху Повикване. Ако всичко е направено правилно, ще чуете синтезиран поздрав!

Желаем ви страхотно развитие на Voximplant и оставайте на линия за още новини - ще имаме още много 😉

Източник: www.habr.com