Ukladací priestor kľúč – hodnota alebo ako sa naše aplikácie stali pohodlnejšími

Každý, kto vyvíja na Voximplante, vie o koncepte „aplikácií“, ktoré navzájom spájajú cloudové skripty, telefónne čísla, používateľov, pravidlá a fronty hovorov. Jednoducho povedané, aplikácie sú základným kameňom vývoja na našej platforme, vstupným bodom do akéhokoľvek riešenia založeného na Voximplante, pretože vytvorením aplikácie to všetko začína.

Predtým si aplikácie „nepamätali“ ani akcie, ktoré skripty vykonali, ani výsledky výpočtov, takže vývojári boli nútení ukladať hodnoty do služieb tretích strán alebo na ich backend. Ak ste niekedy pracovali s lokálnym úložiskom v prehliadači, potom je naša nová funkcia celkom podobná tejto, pretože Umožňuje aplikáciám zapamätať si páry kľúč – hodnota, ktoré sú jedinečné pre každú aplikáciu vo vašom účte. Prevádzka skladu bola umožnená vďaka novému modulu ApplicationStorage – pod strihom nájdete krátky návod, ako ho používať, vitajte!

Budete potrebovať

• Voximplantový účet. Ak ho nemáte, tak registrácia býva tu;
• Aplikácia Voximplant, ako aj skript, pravidlo a jeden používateľ. Toto všetko vytvoríme v tomto návode;
• webový klient na uskutočnenie hovoru - použite náš webtelefón phone.voximplant.com.

Nastavenia voximplantátu

Najprv sa prihláste do svojho účtu: manage.voximplant.com/auth. V ponuke vľavo kliknite na „Aplikácie“, potom na „Nová aplikácia“ a vytvorte aplikáciu s názvom úložisko. Prejdite do novej aplikácie, prepnite sa na kartu Skripty a vytvorte skript countingCalls s nasledujúcim kódom:

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

});

Prvý riadok spája modul ApplicationStorage, zvyšok logiky je umiestnený v obsluhe udalosti Call Alerting.

Najprv deklarujeme premennú, aby sme mohli porovnať počiatočnú hodnotu s počítadlom hovorov. Potom sa pokúsime získať hodnotu kľúča totalCalls z obchodu. Ak takýto kľúč ešte neexistuje, vytvoríme ho:

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

Ďalej musíte zvýšiť hodnotu kľúča v úložisku:

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

UPOZORNENIE

Pre každý prísľub musíte explicitne špecifikovať spracovanie zlyhania, ako je uvedené vo vyššie uvedenom zozname - inak sa skript zastaví a v protokoloch sa zobrazí chyba. Podrobnosti tu.

Po práci s úložiskom skript odpovie na prichádzajúci hovor pomocou hlasovej syntézy a povie vám, koľkokrát ste predtým volali. Po tejto správe skript ukončí reláciu.

Po uložení skriptu prejdite vo svojej aplikácii na kartu Smerovanie a kliknite na položku Nové pravidlo. Nazvite to startCounting, zadajte skript countingCalls a ponechajte predvolenú masku (.*).

Posledná vec je vytvoriť používateľa. Ak to chcete urobiť, prejdite na „Používatelia“, kliknite na „Vytvoriť používateľa“, zadajte meno (napríklad používateľ1) a heslo a potom kliknite na „Vytvoriť“. Tento pár prihlasovacieho mena a hesla budeme potrebovať na autentifikáciu vo webovom telefóne.

check

Otvorte webový telefón pomocou odkazu phone.voximplant.com a prihláste sa pomocou názvu svojho účtu, názvu aplikácie a páru používateľské meno-heslo z aplikácie. Po úspešnom prihlásení zadajte do vstupného poľa ľubovoľnú sadu znakov a kliknite na Zavolať. Ak bolo všetko vykonané správne, budete počuť syntetizovaný pozdrav!

Prajeme vám skvelý vývoj na Voximplante a zostaňte naladení na ďalšie novinky - budeme mať oveľa viac 😉

Zdroj: hab.com