ذخیره سازی کلید-مقدار، یا اینکه چگونه برنامه های ما راحت تر شده اند

هرکسی که در Voximplant توسعه می‌دهد، از مفهوم «برنامه‌هایی» که اسکریپت‌های ابری، شماره تلفن، کاربران، قوانین و صف‌های تماس را به یکدیگر متصل می‌کنند، می‌دانند. به زبان ساده، برنامه‌ها سنگ بنای توسعه در پلتفرم ما هستند، نقطه ورود به هر راه‌حل مبتنی بر Voximplant، زیرا ایجاد یک برنامه از آنجا شروع می‌شود.

پیش از این، برنامه‌ها نه اقداماتی که اسکریپت‌ها انجام می‌دادند و نه نتایج محاسبات را «به خاطر می‌آوردند»، بنابراین توسعه‌دهندگان مجبور بودند مقادیر را در خدمات شخص ثالث یا در باطن خود ذخیره کنند. اگر تا به حال با حافظه محلی در مرورگر کار کرده اید، عملکرد جدید ما کاملاً شبیه به این است، زیرا... به برنامه‌ها اجازه می‌دهد جفت‌های کلید-مقدار را که برای هر برنامه موجود در حساب شما منحصربه‌فرد هستند، به خاطر بسپارند. عملیات ذخیره سازی به لطف ماژول جدید امکان پذیر شد ApplicationStorage - در زیر برش، راهنمای کوتاهی در مورد نحوه استفاده از آن پیدا خواهید کرد، خوش آمدید!

شما نیاز دارید

• حساب Voximplant. اگر آن را ندارید، پس ثبت نام اینجا زندگی می کند;
• برنامه Voximplant، و همچنین یک اسکریپت، یک قانون و یک کاربر. ما همه اینها را در این آموزش ایجاد خواهیم کرد.
• مشتری وب برای برقراری تماس - از تلفن وب ما استفاده کنید phone.voximplant.com.

تنظیمات Voximplant

ابتدا وارد حساب کاربری خود شوید: manager.voximplant.com/auth. در منوی سمت چپ، روی "Applications" و سپس "New Application" کلیک کنید و یک برنامه به نام Storage ایجاد کنید. به برنامه جدید بروید، به تب Scripts بروید تا یک اسکریپت countingCalls با کد زیر ایجاد کنید:

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

});

خط اول ماژول ApplicationStorage را به هم متصل می کند، بقیه منطق در کنترل کننده رویداد قرار می گیرد CallAlerting.

ابتدا یک متغیر اعلام می کنیم تا بتوانیم مقدار اولیه را با شمارنده تماس مقایسه کنیم. سپس سعی می کنیم مقدار کلید totalCalls را از فروشگاه دریافت کنیم. اگر چنین کلیدی هنوز وجود نداشته باشد، آن را ایجاد می کنیم:

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

در مرحله بعد، باید مقدار کلید را در حافظه افزایش دهید:

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

لطفا توجه داشته باشید

برای هر وعده، باید به صراحت مدیریت شکست را مشخص کنید، همانطور که در فهرست بالا نشان داده شده است - در غیر این صورت اسکریپت اجرا نمی‌شود و شما یک خطا در گزارش‌ها خواهید دید. جزئیات اینجا.

پس از کار با مخزن، اسکریپت با استفاده از ترکیب صدا به تماس ورودی پاسخ می دهد و به شما می گوید که قبلا چند بار تماس گرفته اید. پس از این پیام، اسکریپت جلسه را پایان می دهد.

هنگامی که اسکریپت را ذخیره کردید، به تب Routing برنامه خود بروید و روی New Rule کلیک کنید. آن را startCounting صدا بزنید، اسکریپت countingCalls را مشخص کنید و ماسک پیش‌فرض (.*) را رها کنید.

آخرین چیز ایجاد یک کاربر است. برای انجام این کار، به «کاربران» بروید، روی «ایجاد کاربر» کلیک کنید، نام (به عنوان مثال، user1) و رمز عبور را مشخص کنید، سپس روی «ایجاد» کلیک کنید. ما برای احراز هویت در تلفن وب به این جفت ورود و رمز عبور نیاز داریم.

چک کردن

تلفن وب را با استفاده از پیوند باز کنید phone.voximplant.com و با استفاده از نام حساب کاربری، نام برنامه و جفت نام کاربری - رمز عبور از برنامه وارد شوید. پس از ورود موفق، هر مجموعه ای از کاراکترها را در قسمت ورودی وارد کرده و روی Call کلیک کنید. اگر همه چیز به درستی انجام شده باشد، یک سلام ترکیبی می شنوید!

ما برای شما آرزوی پیشرفت عالی در Voximplant داریم و منتظر اخبار بیشتر باشید - ما چیزهای بیشتری خواهیم داشت 😉

منبع: www.habr.com