تخزين القيمة الرئيسية ، أو كيف أصبحت تطبيقاتنا أكثر ملاءمة

يعرف أي شخص يقوم بالتطوير على Voximplant مفهوم "التطبيقات" التي تربط البرامج النصية السحابية وأرقام الهواتف والمستخدمين والقواعد وقوائم انتظار المكالمات ببعضها البعض. ببساطة، التطبيقات هي حجر الزاوية في التطوير على منصتنا، ونقطة الدخول إلى أي حل قائم على Voximplant، حيث أن إنشاء التطبيق هو المكان الذي يبدأ فيه كل شيء.

في السابق، لم تكن التطبيقات "تتذكر" الإجراءات التي تنفذها البرامج النصية أو نتائج العمليات الحسابية، لذلك اضطر المطورون إلى تخزين القيم في خدمات الطرف الثالث أو على الواجهة الخلفية الخاصة بهم. إذا كنت قد عملت من قبل مع التخزين المحلي في المتصفح، فإن وظائفنا الجديدة مشابهة تمامًا لهذه، لأن... يسمح للتطبيقات بتذكر أزواج القيمة الأساسية الفريدة لكل تطبيق في حسابك. أصبح تشغيل التخزين ممكنًا بفضل الوحدة الجديدة التطبيق: التخزين – ستجد أسفل المقطع دليلاً قصيرًا حول كيفية استخدامه، مرحبًا بك!

سوف تحتاج

• حساب فوكسيمبلانت. إذا لم يكن لديك، ثم التسجيل يعيش هنا;
• تطبيق Voximplant، بالإضافة إلى البرنامج النصي والقاعدة ومستخدم واحد. سنقوم بإنشاء كل هذا في هذا البرنامج التعليمي.
• عميل الويب لإجراء مكالمة - استخدم هاتف الويب الخاص بنا phone.voximplant.com.

إعدادات زراعة الشعر

أولا قم بتسجيل الدخول إلى حسابك: Manage.voximplant.com/auth. في القائمة الموجودة على اليسار، انقر فوق "التطبيقات"، ثم "تطبيق جديد" وقم بإنشاء تطبيق يسمى التخزين. انتقل إلى التطبيق الجديد، ثم قم بالتبديل إلى علامة التبويب "البرامج النصية" لإنشاء برنامج نصي لـ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، ويتم وضع باقي المنطق في معالج الحدث تنبيه المكالمات.

أولاً نعلن عن متغير حتى نتمكن من مقارنة القيمة الأولية مع عداد الاستدعاءات. ثم نحاول الحصول على قيمة مفتاح 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);
    }

يرجى ملاحظة

بالنسبة لكل وعد، يجب عليك تحديد معالجة الفشل بشكل صريح، كما هو موضح في القائمة أعلاه - وإلا فسيتوقف تشغيل البرنامج النصي، وسترى خطأ في السجلات. تفاصيل هنا.

بعد العمل مع المستودع، يجيب البرنامج النصي على المكالمة الواردة باستخدام التوليف الصوتي ويخبرك بعدد المرات التي اتصلت بها من قبل. بعد هذه الرسالة، ينهي البرنامج النصي الجلسة.

بمجرد حفظ البرنامج النصي، انتقل إلى علامة التبويب "التوجيه" في تطبيقك وانقر فوق "قاعدة جديدة". أطلق عليه اسم startCounting، وحدد البرنامج النصي countingCalls، واترك القناع الافتراضي (.*).

آخر شيء هو إنشاء مستخدم. للقيام بذلك، انتقل إلى "المستخدمون"، انقر فوق "إنشاء مستخدم"، حدد اسمًا (على سبيل المثال، المستخدم 1) وكلمة المرور، ثم انقر فوق "إنشاء". سنحتاج إلى زوج كلمة المرور لتسجيل الدخول هذا للمصادقة في هاتف الويب.

مراجعة

افتح هاتف الويب باستخدام الرابط phone.voximplant.com وقم بتسجيل الدخول باستخدام اسم حسابك واسم التطبيق وزوج اسم المستخدم وكلمة المرور من التطبيق. بعد تسجيل الدخول بنجاح، أدخل أي مجموعة من الأحرف في حقل الإدخال وانقر فوق اتصال. إذا تم كل شيء بشكل صحيح، فسوف تسمع تحية مركبة!

نتمنى لك تطورًا كبيرًا في Voximplant وترقب المزيد من الأخبار - سيكون لدينا الكثير 😉

المصدر: www.habr.com