Sleutel-waardeopslag, of hoe onze applicaties handiger zijn geworden

Iedereen die op Voximplant ontwikkelt kent het concept van ‘apps’ die cloudscripts, telefoonnummers, gebruikers, regels en oproepwachtrijen met elkaar verbinden. Simpel gezegd vormen applicaties de hoeksteen van de ontwikkeling op ons platform, het toegangspunt tot elke op Voximplant gebaseerde oplossing, aangezien het creëren van een applicatie is waar het allemaal begint.

Voorheen ‘onthielden’ applicaties de acties die scripts uitvoerden of de resultaten van berekeningen niet, waardoor ontwikkelaars gedwongen werden waarden op te slaan in services van derden of op hun backend. Als je ooit met lokale opslag in een browser hebt gewerkt, dan lijkt onze nieuwe functionaliteit hier behoorlijk op, omdat... Hiermee kunnen apps sleutel-waardeparen onthouden die uniek zijn voor elke app in uw account. De bediening van de opslag werd mogelijk dankzij de nieuwe module Applicatieopslag – onder de snit vindt u een korte handleiding over het gebruik ervan, welkom!

Je hebt nodig

• Voximplant-account. Als je het niet hebt, dan registratie woont hier;
• Voximplant-applicatie, evenals een script, een regel en één gebruiker. We zullen dit allemaal in deze tutorial maken;
• webclient om te bellen - gebruik onze webtelefoon phone.voximplant.com.

Voxi-implantaat instellingen

Log eerst in op uw account: manage.voximplant.com/auth. Klik in het menu aan de linkerkant op "Toepassingen" en vervolgens op "Nieuwe applicatie" en maak een applicatie met de naam opslag. Ga naar de nieuwe applicatie, ga naar het tabblad Scripts om een ​​countingCalls-script te maken met de volgende code:

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

});

De eerste regel verbindt de ApplicationStorage-module, de rest van de logica wordt in de gebeurtenishandler geplaatst Oproepwaarschuwing.

Eerst declareren we een variabele zodat we de beginwaarde kunnen vergelijken met de oproepteller. Vervolgens proberen we de waarde van de totalCalls-sleutel uit de winkel te halen. Als zo'n sleutel nog niet bestaat, maken we deze:

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

Vervolgens moet u de sleutelwaarde in de opslag verhogen:

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

LET

Voor elke belofte moet u expliciet de afhandeling van fouten specificeren, zoals weergegeven in de bovenstaande lijst. Anders stopt het script met draaien en ziet u een fout in de logboeken. Details hier.

Nadat u met de repository heeft gewerkt, beantwoordt het script de inkomende oproep met behulp van spraaksynthese en vertelt u hoe vaak u eerder hebt gebeld. Na dit bericht beëindigt het script de sessie.

Nadat u het script heeft opgeslagen, gaat u naar het tabblad Routing van uw toepassing en klikt u op Nieuwe regel. Noem het startCounting, specificeer het countingCalls-script en laat het standaardmasker (.*) staan.

Het laatste is het aanmaken van een gebruiker. Om dit te doen, gaat u naar “Gebruikers”, klikt u op “Een gebruiker aanmaken”, specificeert u een naam (bijvoorbeeld gebruiker1) en wachtwoord en klikt u vervolgens op “Aanmaken”. We hebben dit login-wachtwoordpaar nodig voor authenticatie op de webtelefoon.

check de

Open de webtelefoon via de link phone.voximplant.com en log in met uw accountnaam, applicatienaam en gebruikersnaam-wachtwoord-paar van de applicatie. Nadat u succesvol bent ingelogd, voert u een willekeurige reeks tekens in het invoerveld in en klikt u op Bellen. Als alles correct is gedaan, hoort u een synthetische begroeting!

We wensen je een geweldige ontwikkeling op Voximplant en blijf op de hoogte voor meer nieuws - we zullen nog veel meer hebben 😉

Bron: www.habr.com