Penyimpanan bernilai kunci, atau bagaimana aplikasi kami menjadi lebih nyaman

Siapa pun yang mengembangkan di Voximplant tahu tentang konsep “aplikasi” yang menghubungkan skrip cloud, nomor telepon, pengguna, aturan, dan antrean panggilan satu sama lain. Sederhananya, aplikasi adalah landasan pengembangan platform kami, titik masuk ke dalam solusi berbasis Voximplant, karena pembuatan aplikasi adalah tempat semuanya dimulai.

Sebelumnya, aplikasi tidak “mengingat” tindakan yang dilakukan skrip atau hasil perhitungan, sehingga pengembang terpaksa menyimpan nilai di layanan pihak ketiga atau di backend mereka. Jika Anda pernah bekerja dengan penyimpanan lokal di browser, maka fungsi baru kami sangat mirip dengan ini, karena... Mengizinkan aplikasi mengingat pasangan nilai kunci yang unik untuk setiap aplikasi di akun Anda. Pengoperasian penyimpanan menjadi mungkin berkat modul baru Penyimpanan Aplikasi – di bawah potongan Anda akan menemukan panduan singkat tentang cara menggunakannya, selamat datang!

Anda akan membutuhkannya

• akun voximplant. Jika Anda tidak memilikinya, maka pendaftaran tinggal di sini;
• Aplikasi Voximplant, serta skrip, aturan, dan satu pengguna. Kami akan membuat semua ini dalam tutorial ini;
• klien web untuk melakukan panggilan - gunakan telepon web kami telepon.voximplant.com.

Pengaturan voximplant

Pertama, masuk ke akun Anda: kelola.voximplant.com/auth. Pada menu sebelah kiri, klik "Aplikasi", lalu "Aplikasi Baru" dan buat aplikasi bernama penyimpanan. Masuk ke aplikasi baru, alihkan ke tab Scripts untuk membuat skripcountingCalls dengan kode 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, logika lainnya ditempatkan di event handler Peringatan Panggilan.

Pertama kita mendeklarasikan sebuah variabel sehingga kita dapat membandingkan nilai awal dengan penghitung panggilan. Kemudian kami mencoba mendapatkan nilai kunci totalCalls dari toko. Jika kunci tersebut belum ada, maka kita membuatnya:

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

Selanjutnya, Anda perlu meningkatkan nilai kunci dalam penyimpanan:

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

PERHATIKAN

Untuk setiap janji, Anda harus secara eksplisit menentukan penanganan kegagalan, seperti yang ditunjukkan dalam daftar di atas - jika tidak, skrip akan berhenti berjalan, dan Anda akan melihat kesalahan di log. Detail di sini.

Setelah bekerja dengan repositori, skrip menjawab panggilan masuk menggunakan sintesis suara dan memberi tahu Anda berapa kali Anda menelepon sebelumnya. Setelah pesan ini, skrip mengakhiri sesi.

Setelah Anda menyimpan skrip, buka tab Perutean aplikasi Anda dan klik Aturan Baru. Sebut saja startCounting, tentukan skripcountingCalls, dan biarkan mask default (.*).

Hal terakhir adalah membuat pengguna. Untuk melakukan ini, buka “Pengguna”, klik “Buat pengguna”, tentukan nama (misalnya, pengguna1) dan kata sandi, lalu klik “Buat”. Kami memerlukan pasangan kata sandi login ini untuk otentikasi di telepon web.

Memeriksa

Buka telepon web menggunakan tautan telepon.voximplant.com dan login menggunakan nama akun, nama aplikasi dan pasangan username-password dari aplikasi tersebut. Setelah login berhasil, masukkan kumpulan karakter apa pun di kolom input dan klik Panggil. Jika semuanya dilakukan dengan benar, Anda akan mendengar salam yang disintesis!

Kami berharap Anda mendapatkan perkembangan yang luar biasa di Voximplant dan nantikan berita lainnya - kami akan memiliki lebih banyak lagi 😉

Sumber: www.habr.com