Key-value storage, o kung paano naging mas maginhawa ang aming mga application

Alam ng sinumang bubuo sa Voximplant ang tungkol sa konsepto ng "mga app" na nagkokonekta sa mga cloud script, numero ng telepono, user, panuntunan, at pila ng tawag sa isa't isa. Sa madaling salita, ang mga application ay ang pundasyon ng pag-unlad sa aming platform, ang entry point sa anumang Voximplant-based na solusyon, dahil ang paglikha ng isang application ay kung saan nagsisimula ang lahat.

Dati, hindi "naaalala" ng mga application ang alinman sa mga aksyon na isinagawa ng mga script o ang mga resulta ng mga kalkulasyon, kaya napilitan ang mga developer na mag-imbak ng mga halaga sa mga serbisyo ng third-party o sa kanilang backend. Kung nagtrabaho ka na sa lokal na storage sa isang browser, ang aming bagong functionality ay medyo katulad nito, dahil... Nagbibigay-daan sa mga app na matandaan ang mga pares ng key-value na natatangi sa bawat app sa iyong account. Ang pagpapatakbo ng imbakan ay naging posible salamat sa bagong module ApplicationStorage – sa ibaba ng cut makikita mo ang isang maikling gabay sa kung paano gamitin ito, maligayang pagdating!

Kakailanganin mo

• Voximplant account. Kung wala ka nito, kung gayon dito nakatira ang pagpaparehistro;
• Voximplant application, pati na rin ang isang script, isang panuntunan at isang user. Gagawin namin ang lahat ng ito sa tutorial na ito;
• web client para tumawag - gamitin ang aming webphone phone.voximplant.com.

Mga setting ng voximplant

Una, mag-log in sa iyong account: manage.voximplant.com/auth. Sa menu sa kaliwa, i-click ang "Mga Application", pagkatapos ay "Bagong Application" at lumikha ng isang application na tinatawag na storage. Pumunta sa bagong application, lumipat sa tab na Mga Script upang lumikha ng script ng countingCalls na may sumusunod na code:

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

});

Ang unang linya ay nagkokonekta sa ApplicationStorage module, ang natitirang logic ay inilalagay sa event handler CallAlerting.

Una, idedeklara namin ang isang variable upang maihambing namin ang paunang halaga sa call counter. Pagkatapos ay sinusubukan naming makuha ang halaga ng totalCalls key mula sa tindahan. Kung wala pang ganoong susi, gagawin namin ito:

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

Susunod, kailangan mong dagdagan ang pangunahing halaga sa imbakan:

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

PAKITANDAAN

Para sa bawat pangako, dapat mong tahasang tukuyin ang paghawak ng pagkabigo, tulad ng ipinapakita sa listahan sa itaas - kung hindi ay hihinto sa pagtakbo ang script, at makakakita ka ng error sa mga log. Mga Detalye dito.

Pagkatapos magtrabaho kasama ang repositoryo, sinasagot ng script ang papasok na tawag gamit ang voice synthesis at sasabihin sa iyo kung ilang beses kang tumawag noon. Pagkatapos ng mensaheng ito, tatapusin ng script ang session.

Kapag na-save mo na ang script, pumunta sa tab na Routing ng iyong application at i-click ang Bagong Panuntunan. Tawagan itong startCounting, tukuyin ang countingCalls script, at iwanan ang default na mask (.*).

Ang huling bagay ay lumikha ng isang user. Upang gawin ito, pumunta sa "Mga Gumagamit", i-click ang "Lumikha ng isang user", tukuyin ang isang pangalan (halimbawa, user1) at password, pagkatapos ay i-click ang "Lumikha". Kakailanganin namin ang pares ng login-password na ito para sa pagpapatunay sa webphone.

Suriin

Buksan ang webphone gamit ang link phone.voximplant.com at mag-log in gamit ang pangalan ng iyong account, pangalan ng application at pares ng username-password mula sa application. Pagkatapos ng matagumpay na pag-login, ipasok ang anumang hanay ng mga character sa input field at i-click ang Tawag. Kung nagawa nang tama ang lahat, makakarinig ka ng synthesized na pagbati!

Hinihiling namin sa iyo ang mahusay na pag-unlad sa Voximplant at manatiling nakatutok para sa higit pang mga balita - magkakaroon kami ng marami pa 😉

Pinagmulan: www.habr.com