Úložiště párů klíč-hodnota aneb jak se naše aplikace staly pohodlnějšími

Každý, kdo vyvíjí na Voximplantu, ví o konceptu „aplikací“, které propojují cloudové skripty, telefonní čísla, uživatele, pravidla a fronty hovorů. Jednoduše řečeno, aplikace jsou základním kamenem vývoje na naší platformě, vstupním bodem do jakéhokoli řešení založeného na Voximplantu, protože vytvořením aplikace vše začíná.

Dříve si aplikace „nepamatovaly“ ani akce, které skripty prováděly, ani výsledky výpočtů, takže vývojáři byli nuceni ukládat hodnoty ve službách třetích stran nebo na jejich backendu. Pokud jste někdy pracovali s místním úložištěm v prohlížeči, pak je naše nová funkce docela podobná této, protože Umožňuje aplikacím zapamatovat si páry klíč–hodnota, které jsou jedinečné pro každou aplikaci ve vašem účtu. Provoz úložiště byl umožněn díky novému modulu ApplicationStorage – pod střihem najdete krátký návod, jak jej používat, vítejte!

Budete potřebovat

• Účet Voximplant. Pokud ho nemáte, tak registrace zde žije;
• Aplikace Voximplant, stejně jako skript, pravidlo a jeden uživatel. To vše vytvoříme v tomto tutoriálu;
• webový klient pro volání - použijte náš webtelefon phone.voximplant.com.

Nastavení voximplantátu

Nejprve se přihlaste ke svému účtu: manage.voximplant.com/auth. V nabídce vlevo klikněte na „Aplikace“, poté na „Nová aplikace“ a vytvořte aplikaci s názvem úložiště. Přejděte do nové aplikace, přepněte na kartu Skripty a vytvořte skript countingCalls s následujícím kódem:

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

});

První řádek spojuje modul ApplicationStorage, zbytek logiky je umístěn v obsluze události Call Alerting.

Nejprve deklarujeme proměnnou, abychom mohli porovnat počáteční hodnotu s počítadlem hovorů. Poté se z obchodu pokusíme získat hodnotu klíče totalCalls. Pokud takový klíč ještě neexistuje, vytvoříme jej:

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

Dále musíte zvýšit hodnotu klíče v úložišti:

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

UPOZORNĚNÍ

Pro každý příslib musíte výslovně specifikovat zpracování selhání, jak je uvedeno ve výpisu výše – jinak se skript zastaví a v protokolech se zobrazí chyba. Podrobnosti zde.

Po práci s úložištěm skript odpoví na příchozí hovor pomocí hlasové syntézy a řekne vám, kolikrát jste předtím volali. Po této zprávě skript ukončí relaci.

Jakmile skript uložíte, přejděte na kartu Směrování vaší aplikace a klikněte na Nové pravidlo. Nazvěte to startCounting, zadejte skript countingCalls a ponechte výchozí masku (.*).

Poslední věcí je vytvoření uživatele. Chcete-li to provést, přejděte na „Uživatelé“, klikněte na „Vytvořit uživatele“, zadejte jméno (například uživatel1) a heslo a klikněte na „Vytvořit“. Tento pár přihlašovací jméno-heslo budeme potřebovat pro ověření ve webovém telefonu.

Zkontrolujte

Otevřete webový telefon pomocí odkazu phone.voximplant.com a přihlaste se pomocí názvu svého účtu, názvu aplikace a dvojice uživatelské jméno-heslo z aplikace. Po úspěšném přihlášení zadejte do vstupního pole libovolnou sadu znaků a klikněte na Volat. Pokud bylo vše provedeno správně, uslyšíte syntetizovaný pozdrav!

Přejeme vám skvělý vývoj na Voximplantu a zůstaňte naladěni na další novinky - budeme mít mnohem více 😉

Zdroj: www.habr.com