Storan nilai kunci, atau cara aplikasi kami menjadi lebih mudah

Sesiapa yang membangun di Voximplant tahu tentang konsep "apl" yang menghubungkan skrip awan, nombor telefon, pengguna, peraturan dan baris gilir panggilan antara satu sama lain. Ringkasnya, aplikasi adalah asas pembangunan pada platform kami, titik masuk ke dalam mana-mana penyelesaian berasaskan Voximplant, kerana mencipta aplikasi adalah tempat semuanya bermula.

Sebelum ini, aplikasi tidak "mengingat" sama ada tindakan yang dilakukan skrip atau hasil pengiraan, jadi pembangun terpaksa menyimpan nilai dalam perkhidmatan pihak ketiga atau pada bahagian belakang mereka. Jika anda pernah bekerja dengan storan tempatan dalam penyemak imbas, maka fungsi baharu kami agak serupa dengan ini, kerana Membenarkan apl mengingati pasangan nilai kunci yang unik untuk setiap apl dalam akaun anda. Operasi storan menjadi mungkin terima kasih kepada modul baharu ApplicationStorage – di bawah potongan anda akan menemui panduan ringkas tentang cara menggunakannya, selamat datang!

Anda perlukan

• Akaun Voximplant. Jika anda tidak memilikinya, maka pendaftaran tinggal di sini;
• Aplikasi Voximplant, serta skrip, peraturan dan satu pengguna. Kami akan mencipta semua ini dalam tutorial ini;
• pelanggan web untuk membuat panggilan - gunakan telefon web kami phone.voximplant.com.

Tetapan voximplant

Mula-mula, log masuk ke akaun anda: manage.voximplant.com/auth. Dalam menu di sebelah kiri, klik "Aplikasi", kemudian "Aplikasi Baharu" dan buat aplikasi yang dipanggil storan. Pergi ke aplikasi baharu, tukar ke tab Skrip untuk mencipta skrip countingCalls dengan kod berikut:

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

});

Baris pertama menghubungkan modul ApplicationStorage, selebihnya logik diletakkan dalam pengendali acara CallAlerting.

Mula-mula kita mengisytiharkan pembolehubah supaya kita boleh membandingkan nilai awal dengan pembilang panggilan. Kemudian kami cuba mendapatkan nilai kunci totalCalls daripada kedai. Jika kunci sedemikian belum wujud lagi, maka kami menciptanya:

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

Seterusnya, anda perlu meningkatkan nilai kunci dalam storan:

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

SILA NOTA

Untuk setiap janji, anda mesti menyatakan pengendalian kegagalan secara eksplisit, seperti yang ditunjukkan dalam penyenaraian di atas - jika tidak skrip akan berhenti berjalan dan anda akan melihat ralat dalam log. Butiran di sini.

Selepas bekerja dengan repositori, skrip menjawab panggilan masuk menggunakan sintesis suara dan memberitahu anda berapa kali anda membuat panggilan sebelum ini. Selepas mesej ini, skrip menamatkan sesi.

Sebaik sahaja anda telah menyimpan skrip, pergi ke tab Penghalaan aplikasi anda dan klik Peraturan Baharu. Panggilnya startCounting, nyatakan skrip countingCalls dan biarkan topeng lalai (.*).

Perkara terakhir ialah mencipta pengguna. Untuk melakukan ini, pergi ke "Pengguna", klik "Buat pengguna", nyatakan nama (contohnya, pengguna1) dan kata laluan, kemudian klik "Buat". Kami memerlukan pasangan log masuk-kata laluan ini untuk pengesahan dalam telefon web.

Memeriksa

Buka telefon web menggunakan pautan phone.voximplant.com dan log masuk menggunakan nama akaun anda, nama aplikasi dan pasangan nama pengguna-kata laluan daripada aplikasi. Selepas log masuk berjaya, masukkan mana-mana set aksara dalam medan input dan klik Panggil. Jika semuanya dilakukan dengan betul, anda akan mendengar ucapan yang disintesis!

Kami mendoakan perkembangan hebat anda di Voximplant dan nantikan berita lanjut - kami akan mempunyai lebih banyak lagi 😉

Sumber: www.habr.com