Gako-balioen biltegiratzea, edo gure aplikazioak erosoagoak nola bihurtu diren

Voximplant-en garatzen duen edonork badaki hodeiko script-ak, telefono-zenbakiak, erabiltzaileak, arauak eta deien ilarak elkarren artean lotzen dituzten "aplikazioen" kontzeptua. Besterik gabe, aplikazioak gure plataformako garapenaren oinarria dira, Voximplant-en oinarritutako edozein soluziorako sarrera-puntua, aplikazio bat sortzea dena hasten baita.

Aurretik, aplikazioek ez zituzten "gogoratzen" ez scriptek egiten zituzten ekintzak ez kalkuluen emaitzak, beraz, garatzaileek hirugarrenen zerbitzuetan edo beren backend-ean balioak gordetzera behartuta zeuden. Inoiz arakatzaile batean tokiko biltegiratzearekin lan egin baduzu, gure funtzionalitate berria honen antzekoa da, zeren... Zure kontuko aplikazio bakoitzerako bereziak diren gako-balio bikoteak gogoratzeko aukera ematen die aplikazioei. Biltegiratze funtzionamendua modulu berriari esker egin zen posible Aplikazioen biltegiratzea – ebakiaren azpian hura erabiltzeko gida labur bat aurkituko duzu, ongi etorri!

Behar izango duzu

• Voximplant kontua. Ez baduzu, orduan izen-ematea hemen bizi da;
• Voximplant aplikazioa, baita script bat, arau bat eta erabiltzaile bat ere. Hau guztia tutorial honetan sortuko dugu;
• web bezeroa dei bat egiteko - erabili gure web telefonoa phone.voximplant.com.

Voximplant ezarpenak

Lehenik eta behin, hasi saioa zure kontuan: manage.voximplant.com/auth. Ezkerreko menuan, sakatu "Aplikazioak", gero "Aplikazio berria" eta sortu biltegiratze izeneko aplikazioa. Joan aplikazio berrira, aldatu Scripts fitxara countingCalls script bat sortzeko kode honekin:

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

});

Lehenengo lerroak ApplicationStorage modulua konektatzen du, gainerako logika gertaeren kudeatzailean jartzen da Deia alerta.

Lehenik eta behin aldagai bat deklaratzen dugu, hasierako balioa dei-kontagailuarekin alderatu ahal izateko. Ondoren, totalCalls gakoaren balioa dendatik lortzen saiatzen gara. Halako gakorik oraindik ez badago, orduan sortuko dugu:

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

Ondoren, biltegian gako-balioa handitu behar duzu:

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

OHARRA

Promes bakoitzeko, hutsegiteen kudeaketa esplizituki zehaztu behar duzu, goiko zerrendan agertzen den bezala; bestela, scripta exekutatzen geldituko da eta akats bat ikusiko duzu erregistroetan. Xehetasunak Hemen.

Biltegiarekin lan egin ondoren, gidoiak sarrerako deiari erantzun dio ahots-sintesia erabiliz eta aurretik zenbat aldiz deitu duzun esaten dizu. Mezu honen ondoren, gidoiak saioa amaitzen du.

Scripta gorde ondoren, joan zure aplikazioko Bideraketa fitxara eta egin klik Arau berria. Deitu startCounting, zehaztu countingCalls script-a eta utzi maskara lehenetsia (.*).

Azken gauza erabiltzaile bat sortzea da. Horretarako, joan “Erabiltzaileak”, sakatu “Sortu erabiltzailea”, zehaztu izen bat (adibidez, user1) eta pasahitza, eta sakatu “Sortu”. Saio-hasiera-pasahitz bikote hau beharko dugu web telefonoan autentifikatzeko.

check

Ireki web telefonoa esteka erabiliz phone.voximplant.com eta hasi saioa zure kontuaren izena, aplikazioaren izena eta erabiltzaile-izen-pasahitza bikotea aplikaziotik. Saioa hasi ondoren, idatzi edozein karaktere multzoa sarrera eremuan eta egin klik Deitu. Dena ondo egin bada, agur sintetizatu bat entzungo duzu!

Voximplant-en garapen handia opa dizugu eta adi egon berri gehiago lortzeko - askoz gehiago izango ditugu 😉

Iturria: www.habr.com