Stocarea cheie-valoare sau modul în care aplicațiile noastre au devenit mai convenabile

Oricine se dezvoltă pe Voximplant este conștient de conceptul de „aplicații” care conectează scripturi cloud, numere de telefon, utilizatori, reguli și cozi de apeluri între ele. Mai simplu spus, aplicațiile sunt piatra de temelie a dezvoltării pe platforma noastră, punctul de intrare în orice soluție bazată pe Voximplant, deoarece totul începe cu crearea unei aplicații.

Anterior, aplicațiile nu își „aminteau” nici acțiunile efectuate de scripturi, nici rezultatele calculelor, așa că dezvoltatorii erau obligați să stocheze valori în servicii terțe sau pe backend-ul lor. Dacă ați lucrat vreodată cu stocarea locală într-un browser, atunci noua noastră funcționalitate este foarte asemănătoare cu aceasta, deoarece. Permite aplicațiilor să-și amintească perechi cheie-valoare care sunt unice pentru fiecare aplicație din contul dvs. Operațiunea de stocare a devenit posibilă datorită noului modul ApplicationStorage - sub tăietură vei găsi un scurt ghid despre cum să-l folosești, bine ai venit!

Veți avea nevoie

• cont Voximplant. Daca nu il ai, atunci înregistrarea locuiește aici;
• aplicația Voximplant, precum și un script, o regulă și un singur utilizator. Toate acestea le vom crea în acest tutorial;
• client web pentru a efectua un apel - utilizați telefonul nostru web phone.voximplant.com.

Setări Voximplant

Mai întâi conectați-vă la contul dvs.: manage.voximplant.com/auth. În meniul din stânga, faceți clic pe „Aplicații”, apoi pe „Aplicație nouă” și creați o aplicație numită stocare. Accesați noua aplicație, comutați la fila Scripturi pentru a crea un script countingCalls cu următorul cod:

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

});

Prima linie conectează modulul ApplicationStorage, restul logicii este plasat în handlerul de evenimente alertă de apel.

Mai întâi, declarăm o variabilă, astfel încât să putem compara valoarea inițială cu numărul de apeluri. Apoi încercăm să obținem valoarea cheii totalCalls din magazin. Dacă nu există încă o astfel de cheie, atunci o creăm:

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

În continuare, trebuie să creșteți valoarea cheii în stocare:

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

ATENȚIE

Pentru fiecare promisiune, trebuie să specificați în mod explicit failover-ul, așa cum se arată în lista de mai sus - altfel scriptul va fi oprit și veți vedea o eroare în jurnale. Detalii aici.

După ce lucrați cu depozitul, scriptul răspunde la apelul primit folosind sinteza vocală și vă spune de câte ori ați sunat înainte. După acest mesaj, scriptul încheie sesiunea.

După ce ați salvat scriptul, accesați fila Rutare a aplicației dvs. și faceți clic pe Regulă nouă. Numiți startCounting, specificați scriptul countingCalls și lăsați masca implicită (.*).

Ultima este crearea unui utilizator. Pentru a face acest lucru, accesați „Utilizatori”, faceți clic pe „Creați utilizator”, introduceți un nume (de exemplu, user1) și o parolă, apoi faceți clic pe „Creați”. Vom avea nevoie de această pereche de autentificare-parolă pentru autentificare pe telefonul web.

Control

Deschideți telefonul web din link phone.voximplant.com și conectați-vă folosind numele contului, numele aplicației și perechea nume de utilizator/parolă din aplicație. După o conectare cu succes, introduceți orice set de caractere în câmpul de introducere și faceți clic pe Apelare. Dacă totul a fost făcut corect, atunci veți auzi un salut sintetizat!

Vă dorim o mare dezvoltare la Voximplant și rămâneți pe fază - vom avea multe altele 😉

Sursa: www.habr.com