Key-value salvestus, või kuidas meie rakendused muutusid mugavamaks

See, kes arendab Voximplanti platvormil, teab kontseptsioonist "rakendused", mis ühendavad omavahel pilveskeeme, telefoninumbreid, kasutajaid, reegleid ja kõnede järjekordi. Ütlemiseks lihtsalt, rakendused on meie platvormi arendamise aluseks, sisenemispunkt kõigisse Voximplanti põhistes lahendustes, kuna just rakenduse loomine on esimene samm igasuguses arenduses.

Varem rakendused ei "mäletanud" ei tegevusi, mida stsenaariumid täidavad, ega arvutuste tulemusi, nii et arendajad pidid säilitama väärtusi kolmandate osapoolte teenustes või oma tagaplaanil. Kui olete kunagi töötanud brauseri kohaliku salvestusega, siis meie uus funktsionaalsus on sellele sarnane, kuna see võimaldab rakendustel meelde jätta paarid "võti-väärtus", mis on iga teie konto rakenduse jaoks unikaalsed. Salvestuse töö on saanud võimalikuks tänu uuele moodulile ApplicationStorage – allpool on lühike juhend selle kasutamiseks, tere tulemast!

Teil on vaja

• Voximplanti kontot. Kui teil seda ei ole, siis registreerimine toimub siin;
• Voximplanti rakendust, samuti stsenaariumi, reeglit ja ühte kasutajat. Kõike seda loome selles õpikute sees;
• veebi klienti, et teha kõne – kasutame meie veebitelefoni phone.voximplant.com.

Voximplanti seaded

Esiteks logige oma kontole sisse: manage.voximplant.com/auth. Vasakul menüüs klõpsake "Rakendused", seejärel "Uus rakendus" ja looge rakendus nimega storage. Mine uude rakendusse, vaheta vahelehelt "Stsenaariumid" üle, et luua stsenaarium countingCalls sellise koodiga:

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('Viga totalCalls väärtuse hankimisel');
    }

    try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    } catch(e) {
        Logger.write('Viga totalCalls väärtuse uuendamisel');
    }
    
    e.call.answer();
    e.call.say(`Tere. Eelmiste kõnede arv: ${r.value}.`, Language.RU_RUSSIAN_MALE);

    e.call.addEventListener(CallEvents.PlaybackFinished, VoxEngine.terminate);

});

Esimene rida ühendab mooduli ApplicationStorage, ülejäänud loogika on asetatud sündmuse töötleja sisse CallAlerting.

Esiteks deklareerime muutuja, et saaksime võrrelda algväärtust helistamiste arvuga. Seejärel proovime hankida võtme totalCalls väärtuse salvestusest. Kui sellist võtit veel ei ole, siis loome selle:

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

Järgmiseks tuleb suurendada võtme väärtust salvestuses:

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

PEA MEELD

Iga lubaduse puhul tuleb selgelt näidata vea töötlemist, nagu on näidatud eespool olevas loendis – muidu peatub skripti täitmine ja logides näete viga. Üksikasjad siit.

Pärast salvestuse töötlemist vastab skript saabuvatele kõnedele hääl Sünteesi abil ja ütleb, kui palju kordi olete varem helistanud. Pärast seda teadet lõpetab skript seansi.

Pärast skeemi salvestamist minge oma rakenduse jaotisse 'Routimine' ja klõpsake 'Uus reegel'. Nimetage see startCounting, määrake skeem countingCalls ja jätke mask vaikimisi (.*).

Viimane samm on kasutaja loomine. Selleks minge jaotisse 'Kasutajad', klõpsake 'Loo kasutaja', sisestage nimi (nt user1) ja parool, seejärel klõpsake 'Loo'. See kasutajanimi-parool paar on vajalik veebitelefoni autentimiseks.

Kontrollime.

Avage veebitelefon lingilt phone.voximplant.com ja logige sisse, kasutades konto nime, rakenduse nime ja rakenduse kasutaja kasutajanime-parooli paari. Pärast edukat sisselogimist sisestage sisestusväljavälja mis tahes märgise komplekt ja klõpsake 'Call'. Kui kõik on õigesti tehtud, kuulete sünteesitud tervitust!

Soovime teile suurepäraseid arendusi Voximplant'is ja jälgige meie uudiseid – neid on veel palju 😉

Allikas: habr.com