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

Този, който разработва на Voximplant, знае за концепцията за "приложения", които свързват облачни сценарии, телефонни номера, потребители, правила и опашки за повиквания. По-просто казано, приложенията са основата на разработката на нашата платформа, входната точка за всяко решение на базата на Voximplant, тъй като именно с разработването на приложение всичко започва.

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

Ще ви трябва

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

Настройки Voximplant

Първо влезте в акаунта си: manage.voximplant.com/auth. В лявото меню кликнете на "Приложения", след това "Нов спор" и създайте приложение с име storage. Влезте в новото приложение, преместете се на таба "Сценарии", за да създадете сценарий 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('Неуспех при получаване на стойността totalCalls');
    }

    try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    } catch(e) {
        Logger.write('Неуспех при обновяване на стойността totalCalls');
    }
    
    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);
    }

OBRATITE VNIUMANIE

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

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

След като сте запазили сценариите, преминете на таба „Роутинг“ на вашето приложение и натиснете „Нов индекс“. Назовете го startCounting, задайте сценария countingCalls и оставете маската по подразбиране (.*).

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

Проверяваме.

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

Пожелаваме ви отлична разработка на Voximplant и следете новините – ще имаме още много 😉

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