Raktų vertės saugykla arba kaip mūsų programos tapo patogesnės

Kiekvienas, kuris kuria „Voximplant“, žino apie „programėlių“, kurios sujungia debesies scenarijus, telefono numerius, vartotojus, taisykles ir skambučių eiles, sąvoką. Paprasčiau tariant, programos yra mūsų platformos kūrimo kertinis akmuo, įėjimo taškas į bet kurį Voximplant pagrįstą sprendimą, nes viskas prasideda nuo programos kūrimo.

Anksčiau programos „neatsiminė“ nei scenarijų atliktų veiksmų, nei skaičiavimų rezultatų, todėl kūrėjai buvo priversti saugoti reikšmes trečiųjų šalių paslaugose arba savo foninėje sistemoje. Jei kada nors dirbote su vietine saugykla naršyklėje, mūsų naujos funkcijos yra gana panašios į šią, nes... Leidžiama programoms atsiminti rakto ir verčių poras, kurios yra unikalios kiekvienai jūsų paskyros programai. Saugyklos veikimas tapo įmanomas naujojo modulio dėka ApplicationStorage – po pjūviu rasite trumpą naudojimo instrukciją, sveiki atvykę!

Jums reikės

• Voximplant sąskaita. Jei jo neturite, tada registracija gyvena čia;
• „Voximplant“ programa, taip pat scenarijus, taisyklė ir vienas vartotojas. Visa tai sukursime šioje pamokoje;
• žiniatinklio klientas, kad galėtumėte skambinti – naudokite mūsų internetinį telefoną phone.voximplant.com.

Voksimplanto nustatymai

Pirmiausia prisijunkite prie savo paskyros: manage.voximplant.com/auth. Kairėje esančiame meniu spustelėkite „Programos“, tada „Nauja programa“ ir sukurkite programą, vadinamą saugykla. Eikite į naują programą, perjunkite į skirtuką Scenarijai, kad sukurtumėte CountingCalls scenarijų su šiuo kodu:

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

});

Pirmoji eilutė jungia „ApplicationStorage“ modulį, likusi logikos dalis yra įvykių tvarkyklėje Skambučio įspėjimas.

Pirmiausia deklaruojame kintamąjį, kad galėtume palyginti pradinę reikšmę su skambučių skaitikliu. Tada bandome iš parduotuvės gauti totalCalls rakto vertę. Jei tokio rakto dar nėra, mes jį sukuriame:

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

Tada turite padidinti rakto reikšmę saugykloje:

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

PASTABA

Kiekvienam pažadui turite aiškiai nurodyti gedimų apdorojimą, kaip parodyta aukščiau esančiame sąraše – kitaip scenarijus nustos veikti, o žurnaluose pamatysite klaidą. Detalės čia.

Po darbo su saugykla scenarijus atsiliepia į gaunamą skambutį naudodamas balso sintezę ir nurodo, kiek kartų skambinote anksčiau. Po šio pranešimo scenarijus baigia seansą.

Išsaugoję scenarijų, eikite į savo programos skirtuką Maršrutas ir spustelėkite Nauja taisyklė. Iškvieskite jį startCounting, nurodykite scenarijų countingCalls ir palikite numatytąją kaukę (.*).

Paskutinis dalykas yra sukurti vartotoją. Norėdami tai padaryti, eikite į „Vartotojai“, spustelėkite „Sukurti vartotoją“, nurodykite vardą (pavyzdžiui, vartotojas1) ir slaptažodį, tada spustelėkite „Sukurti“. Mums reikės šios prisijungimo ir slaptažodžio poros autentifikavimui žiniatinklio telefone.

Patikrinkite

Atidarykite internetinį telefoną naudodami nuorodą phone.voximplant.com ir prisijunkite naudodami savo paskyros pavadinimą, programos pavadinimą ir vartotojo vardo ir slaptažodžio porą iš programos. Sėkmingai prisijungę, įvesties lauke įveskite bet kurį simbolių rinkinį ir spustelėkite Skambinti. Jei viskas buvo padaryta teisingai, išgirsite sintezuotą sveikinimą!

Linkime puikios Voximplant plėtros ir laukite daugiau naujienų – turėsime dar daug 😉

Šaltinis: www.habr.com