Atslēgas vērtību glabāšana jeb kā mūsu lietojumprogrammas ir kļuvušas ērtākas

Ikviens, kurš izstrādā Voximplant, zina par jēdzienu “lietotnes”, kas savieno mākoņa skriptus, tālruņu numurus, lietotājus, noteikumus un zvanu rindas. Vienkārši sakot, lietojumprogrammas ir mūsu platformas izstrādes stūrakmens, ieejas punkts jebkurā uz Voximplant balstītā risinājumā, jo ar lietojumprogrammas izveidi viss sākas.

Iepriekš lietojumprogrammas “neatcerējās” ne skriptu veiktās darbības, ne aprēķinu rezultātus, tāpēc izstrādātāji bija spiesti saglabāt vērtības trešo pušu pakalpojumos vai to aizmugursistēmā. Ja kādreiz esat pārlūkprogrammā strādājis ar lokālo krātuvi, mūsu jaunā funkcionalitāte ir diezgan līdzīga šai, jo... Ļauj lietotnēm atcerēties atslēgu un vērtību pārus, kas ir unikāli katrai jūsu konta lietotnei. Krātuves darbība kļuva iespējama, pateicoties jaunajam modulim Lietojumprogrammu krātuve – zem griezuma atradīsi īsu ceļvedi, kā to izmantot, laipni lūdzam!

Jums būs nepieciešams

• Voximplant konts. Ja jums tā nav, tad reģistrācija dzīvo šeit;
• Voximplant lietojumprogramma, kā arī skripts, noteikums un viens lietotājs. Mēs to visu izveidosim šajā apmācībā;
• tīmekļa klients, lai piezvanītu - izmantojiet mūsu tīmekļa tālruni phone.voximplant.com.

Voksimplanta iestatījumi

Vispirms piesakieties savā kontā: manage.voximplant.com/auth. Kreisajā pusē esošajā izvēlnē noklikšķiniet uz "Programmas", pēc tam uz "Jauna lietojumprogramma" un izveidojiet lietojumprogrammu ar nosaukumu krātuve. Dodieties uz jauno lietojumprogrammu, pārslēdzieties uz cilni Skripti, lai izveidotu countingCalls skriptu ar šādu 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);

});

Pirmā rinda savieno ApplicationStorage moduli, pārējā loģika tiek ievietota notikumu apstrādātājā Zvanu brīdināšana.

Vispirms mēs deklarējam mainīgo, lai mēs varētu salīdzināt sākotnējo vērtību ar zvanu skaitītāju. Pēc tam mēs cenšamies no veikala iegūt totalCalls atslēgas vērtību. Ja šādas atslēgas vēl nav, mēs to izveidojam:

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

Pēc tam jums ir jāpalielina atslēgas vērtība krātuvē:

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

LŪDZU, IEVĒROJIET

Katram solījumam ir skaidri jānorāda kļūmju apstrāde, kā parādīts iepriekš minētajā sarakstā — pretējā gadījumā skripts pārtrauks darboties un žurnālos redzēsit kļūdu. Sīkāka informācija šeit.

Pēc darba ar repozitoriju skripts atbild uz ienākošo zvanu, izmantojot balss sintēzi, un norāda, cik reižu jūs iepriekš zvanījāt. Pēc šī ziņojuma skripts pabeidz sesiju.

Kad skripts ir saglabāts, atveriet savas lietojumprogrammas cilni Maršrutēšana un noklikšķiniet uz Jauns noteikums. Izsauciet to startCounting, norādiet countingCalls skriptu un atstājiet noklusējuma masku (.*).

Pēdējā lieta ir lietotāja izveide. Lai to izdarītu, dodieties uz "Lietotāji", noklikšķiniet uz "Izveidot lietotāju", norādiet vārdu (piemēram, lietotājs1) un paroli, pēc tam noklikšķiniet uz "Izveidot". Šis pieteikšanās paroles pāris mums būs nepieciešams autentifikācijai tīmekļa tālrunī.

Pārbaude

Atveriet tīmekļa tālruni, izmantojot saiti phone.voximplant.com un piesakieties, izmantojot sava konta nosaukumu, lietojumprogrammas nosaukumu un lietotājvārda-paroles pāri no lietojumprogrammas. Pēc veiksmīgas pieteikšanās ievades laukā ievadiet jebkuru rakstzīmju kopu un noklikšķiniet uz Zvanīt. Ja viss tika izdarīts pareizi, jūs dzirdēsiet sintezētu sveicienu!

Novēlam jums lielisku attīstību Voximplant un sekojiet līdzi jaunumiem - mums būs daudz vairāk 😉

Avots: www.habr.com