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

Need, kes arendavad Voximplantis, teavad kontseptsiooni "rakendustest", mis ühendavad pilveskeeme, telefoninumbreid, kasutajaid, reegleid ja kõnede järjekordi. Lihtsalt öeldes on rakendused meie platvormi arenduse nurgakivi, sisenemispunkt igasse Voximplant'i tugilahendusse, kuna kõik algab rakenduse loomisega.

Varem ei "mäletanud" rakendused ei tegevusi, mida skeemid täidavad, ega arvutuste tulemusi, nii et arendajad pidid salvestama väärtused kolmandate osapoolte teenustes või oma tagaplaanil. Kui olete kunagi töötanud brauseri local storage'iga, siis meie uus funktsionaalsus on väga sarnane sellega, kuna see võimaldab rakendustel meeles pidada paarid "key-value", mis on unikaalsed iga rakenduse jaoks teie kontol. Salvestuse toimimine sai võimalikuks uue mooduli tõttu ApplicationStorage – allpool ootab teid lühike juhend selle kasutamiseks, tere tulemast!

Teil on vaja

• Voximplant'i kontot. Kui teil seda pole, siis registreerimine toimub siin;
• rakendus Voximplant, samuti stsenaarium, reegel ja üks kasutaja. Kõik need loome selles õpetuses;
• veebiklient, et teha kõne – kasutame meie veebitelefoni phone.voximplant.com.

Voximplant Seaded

Esmalt logige oma kontole sisse: manage.voximplant.com/auth. Vasakpoolses menüüs klõpsake „Rakendused”, seejärel „Uus rakendus” ja looge rakendus nimega storage. Avage uus rakendus, lülitage vahekaardile „Stsenaariumid”, et luua stsenaarium countingCalls järgnevate koodidega:

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 saamisel');
    }

    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 tulemast. 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.

Esmalt me kuulutan välja muutuja, et saaksime võrrelda algväärtust kõnede loendiga. Siis proovime hankida võtme totalCalls väärtuse salvestusest. Kui sellist võtit pole veel, loome selle:

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

Edasi tuleb suurendada võtme väärtust salvestuses:

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

PANGE TÄHELE

Iga lubaduse puhul tuleb selgelt määrata vea käsitlus, nagu on näidatud ülemises loendis - vastasel korral peatub skripti täitmine ja logides näete viga. Üksikasjad siin.

Pärast salvestusega töötamist vastab skript sissetulevale kõnele häälse sünteesi abil ja ütleb, mitu korda olete varem helistanud. Pärast seda teadet lõpetab skript seansi.

Pärast skripti salvestamist minge oma rakenduse vahekaardile 'Routimine' ja klõpsake 'Uus reegel'. Nimetage see startCounting, määrake skript countingCalls ja jätke mask vaikeväärtuseks (.*).

Viimane samm on kasutaja loomine. Selleks minge jaotisse „Kasutajad“, klõpsake „Loo kasutaja“, sisestage nimi (näiteks user1) ja parool, seejärel klõpsake „Loo“. See kasutajanime ja parooli paar on vajalikud meie autentimiseks veebitelefonis.

Kontrollime

Avage veebitelefon lingil phone.voximplant.com ja logige sisse, kasutades konto nime, rakenduse nime ja kasutaja login-parooli, mis on saadud rakendusest. Pärast eduka sisenemise korral sisestage mis tahes sümbolite komplekt sisendvälja ja vajutage Call. Kui kõik on õigesti tehtud, kuulete sünteesitud tervitust!

Soovime teile suurepäraseid arendusi Voximplandi platvormil ja järgige uudiseid – meil on tulemas veel palju 😉

Allikas: habr.com