Key-value tároló, avagy hogyan váltak kényelmesebbé alkalmazásaink

Aki a Voximplant-en fejleszt, tud a "alkalmazások" koncepciójáról, amely összekapcsolja a felhői forgatókönyveket, telefonszámokat, felhasználókat, szabályokat és hívási sorokat. Egyszerűsítve az alkalmazások a platformunkon való fejlesztés sarokkövei, belépési pont minden Voximplant alapú megoldásba, hiszen az alkalmazás létrehozásával kezdődik minden.

Korábban az alkalmazások nem „emlékeztek” sem a forgatókönyvek által végzett műveletekre, sem a számítási eredményekre, így a fejlesztők kénytelenek voltak értékeket harmadik fél szolgáltatásokban vagy saját backendjükön tárolni. Ha valaha is dolgozott a böngészőbeli helyi tárolóval, akkor az új funkciónk hasonló ehhez, mivel lehetővé teszi az alkalmazások számára, hogy „kulcs-érték” párokat tároljanak, amelyek minden alkalmazásra egyediek a fiókjában. A tároló működése a új modulnak köszönhető. ApplicationStorage – az alábbiakban egy rövid útmutató vár önre a használatáról, üdvözöljük!

Szüksége lesz

• Voximplant fiókra. Ha még nincs, akkor a regisztráció itt található;
• Voximplant alkalmazásra, valamint egy forgatókönyvre, szabályra és egy felhasználóra. Mindezt létrehozzuk ebben a tutorialban;
• web kliensre a hívás lebonyolításához – használjuk a webtelefonunkat phone.voximplant.com.

Voximplant Beállításai

Először is, jelentkezzen be a fiókjába: manage.voximplant.com/auth. A bal oldali menüben kattintson az „Alkalmazások” lehetőségre, majd a „Új alkalmazás” gombra, és hozzon létre egy storage nevű alkalmazást. Lépjen be az új alkalmazásba, váltson a „Forgatókönyvek” fülre, hogy létrehozhassa a countingCalls forgatókönyvet a következő kóddal:

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('Hiba a totalCalls értékének lekérésekor');
    }

    try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    } catch(e) {
        Logger.write('Hiba a totalCalls értékének frissítésekor');
    }
    
    e.call.answer();
    e.call.say(`Üdvözöljük. Az előző hívások száma: ${r.value}. `, Language.RU_RUSSIAN_MALE);

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

});

Az első sor csatlakoztatja az ApplicationStorage modult, a fennmaradó logika pedig a CallAlerting eseménykezelőjébe kerül. CallAlerting.

Először deklaráljuk a változót, hogy összehasonlíthassuk a kezdeti értéket a hívások számával. Ezután megpróbáljuk lekérni a totalCalls kulcs értékét a tárolóból. Ha még nem létezik ilyen kulcs, létrehozzuk:

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

Ezután növelnünk kell a kulcs értékét a tárolóban:

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

FIGYELEM

Minden ígéret esetében egyértelműen meg kell határozni a hiba kezelését, ahogy az a fenti listában is látható – különben a szkript végrehajtása leáll, és a naplóban hibát fog látni. További részletek itt.

A tárolóval végzett munka után a szkript válaszol a bejövő hívásra hangszintézissel, és elmondja, hányszor próbálkozott már a hívással. Ezt követően a szkript befejezi a munkamenetet.

Miután elmentette a szkriptet, lépjen a alkalmazásának "Routing" fülére, és kattintson az "Új szabály" gombra. Nevezze el startCounting-ra, adja meg a countingCalls szkriptet, és hagyja az alapértelmezett maszkot (.*).

A legutolsó lépés – felhasználó létrehozása. Ehhez lépjen a "Felhasználók" menübe, kattintson a "Felhasználó létrehozása" lehetőségre, adja meg a nevet (például user1) és a jelszót, majd kattintson a "Létrehozás" gombra. Erre a bejelentkezési névre és jelszóra lesz szükségünk a webtelefonba való belépéshez.

Ellenőrzés

Nyissa meg a webtelefont a következő linken phone.voximplant.com és jelentkezzen be a fiók nevével, az alkalmazás nevével és a felhasználó jelszópárosával. Sikeres bejelentkezés után írjon be bármilyen karaktert a beviteli mezőbe, és nyomja meg a Call gombot. Ha mindent jól csinált, hallani fogja a szintetizált üdvözlést!

Kívánunk Önnek remek fejlesztést a Voximplant-en és figyelje a híreinket – sok újdonság vár még ránk 😉

Forrás: habr.com