Emmagatzematge de valor-clau o com s'han tornat més convenients les nostres aplicacions

Qualsevol persona que desenvolupi a Voximplant és conscient del concepte d'"aplicacions" que connecten scripts en núvol, números de telèfon, usuaris, regles i cues de trucades entre si. En poques paraules, les aplicacions són la pedra angular del desenvolupament de la nostra plataforma, el punt d'entrada a qualsevol solució basada en Voximplant, ja que tot comença amb la creació d'una aplicació.

Anteriorment, les aplicacions no "recordaven" ni les accions que realitzaven els scripts ni els resultats dels càlculs, de manera que els desenvolupadors es veien obligats a emmagatzemar valors en serveis de tercers o al seu backend. Si alguna vegada heu treballat amb emmagatzematge local en un navegador, la nostra nova funcionalitat és molt semblant a aquesta, perquè. Permet que les aplicacions recordin parells clau-valor que són únics per a cada aplicació del vostre compte. El funcionament d'emmagatzematge va ser possible gràcies al nou mòdul Emmagatzematge d'aplicacions - sota el tall trobareu una petita guia sobre com utilitzar-lo, benvingut!

Necessitaràs

• Compte de Voximplant. Si no el tens, doncs el registre viu aquí;
• l'aplicació Voximplant, així com un script, una regla i un sol usuari. Tot això ho crearem en aquest tutorial;
• client web per fer una trucada: utilitzeu el nostre telèfon web phone.voximplant.com.

Configuració de Voximplant

Primer inicieu sessió al vostre compte: manage.voximplant.com/auth. Al menú de l'esquerra, feu clic a "Aplicacions", després "Aplicació nova" i creeu una aplicació anomenada emmagatzematge. Aneu a la nova aplicació, canvieu a la pestanya Scripts per crear un script countingCalls amb el codi següent:

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

});

La primera línia connecta el mòdul ApplicationStorage, la resta de la lògica es col·loca al controlador d'esdeveniments alerta de trucada.

Primer, declarem una variable perquè puguem comparar el valor inicial amb el recompte de trucades. Aleshores intentem obtenir el valor de la clau totalCalls de la botiga. Si encara no hi ha aquesta clau, la creem:

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

A continuació, heu d'augmentar el valor de la clau a l'emmagatzematge:

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

ATENU-ho

Per a cada promesa, heu d'especificar explícitament la migració per error, tal com es mostra a la llista anterior; en cas contrari, l'script deixarà d'executar-se i veureu un error als registres. Detalls aquí.

Després de treballar amb el repositori, l'script respon la trucada entrant mitjançant la síntesi de veu i us indica quantes vegades heu trucat abans. Després d'aquest missatge, l'script finalitza la sessió.

Un cop hàgiu desat l'script, aneu a la pestanya Encaminament de la vostra aplicació i feu clic a Nova regla. Anomeneu-lo startCounting, especifiqueu l'script countingCalls i deixeu la màscara predeterminada (.*).

L'últim és crear un usuari. Per fer-ho, aneu a "Usuaris", feu clic a "Crear usuari", introduïu un nom (per exemple, usuari1) i una contrasenya i, a continuació, feu clic a "Crear". Necessitarem aquest parell d'inici de sessió-contrasenya per a l'autenticació al telèfon web.

Comprovació

Obriu el telèfon web des de l'enllaç phone.voximplant.com i inicieu la sessió amb el nom del compte, el nom de l'aplicació i el parell nom d'usuari/contrasenya de l'aplicació. Després d'iniciar sessió correctament, introduïu qualsevol conjunt de caràcters al camp d'entrada i feu clic a Truca. Si tot s'ha fet correctament, escoltaràs una salutació sintetitzada!

Us desitgem un gran desenvolupament a Voximplant i estigueu atents: en tindrem molts més 😉

Font: www.habr.com