אחסון בעל ערך מפתח, או כיצד היישומים שלנו הפכו לנוחים יותר

כל מי שמפתח ב-Voximplant מודע למושג "יישומים" המחברים ביניהם סקריפטים בענן, מספרי טלפון, משתמשים, כללים ותורי שיחות. במילים פשוטות, יישומים הם אבן היסוד של הפיתוח בפלטפורמה שלנו, נקודת הכניסה לכל פתרון מבוסס Voximplant, שכן הכל מתחיל ביצירת אפליקציה.

בעבר, יישומים לא "זכרו" לא את הפעולות שביצעו סקריפטים ולא את תוצאות החישובים, כך שהמפתחים נאלצו לאחסן ערכים בשירותי צד שלישי או ב-backend שלהם. אם אי פעם עבדת עם אחסון מקומי בדפדפן, הפונקציונליות החדשה שלנו דומה מאוד לזה, כי. מאפשר לאפליקציות לזכור צמדי מפתח-ערך הייחודיים לכל אפליקציה בחשבון שלך. פעולת האחסון התאפשרה הודות למודול החדש ApplicationStorage - מתחת לגזרה תמצאו מדריך קצר כיצד להשתמש בו, ברוך הבא!

תצטרך

• חשבון ווקסימפלנט. אם אין לך את זה, אז הרישום חי כאן;
• היישום Voximplant, כמו גם סקריפט, כלל ומשתמש יחיד. את כל זה ניצור במדריך זה;
• לקוח אינטרנט לביצוע שיחה - השתמש בטלפון האינטרנט שלנו phone.voximplant.com.

הגדרות Voximplant

כניסה ראשונה לחשבון שלך: 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);
    }

הערה

עבור כל הבטחה, עליך לציין במפורש failover, כפי שמוצג ברשימה למעלה - אחרת הסקריפט יופסק ותראה שגיאה ביומנים. פרטים כאן.

לאחר העבודה עם המאגר, הסקריפט עונה לשיחה הנכנסת באמצעות סינתזה קולית ומספר לך כמה פעמים התקשרת בעבר. לאחר הודעה זו, הסקריפט מסיים את ההפעלה.

לאחר ששמרת את הסקריפט, עבור ללשונית ניתוב של היישום שלך ולחץ על כלל חדש. תן לזה שם startCounting, ציין את הסקריפט countingCalls והשאיר את מסיכת ברירת המחדל (.*).

האחרון הוא ליצור משתמש. לשם כך, עבור אל "משתמשים", לחץ על "צור משתמש", הזן שם (לדוגמה, משתמש1) וסיסמה ולאחר מכן לחץ על "צור". נצטרך את צמד הכניסה-סיסמת הזה לאימות בטלפון האינטרנט.

בדוק

פתח את טלפון האינטרנט מהקישור phone.voximplant.com והיכנס באמצעות שם החשבון, שם האפליקציה וצמד שם משתמש/סיסמה מהאפליקציה. לאחר כניסה מוצלחת, הזן כל ערכת תווים בשדה הקלט ולחץ על התקשר. אם הכל נעשה נכון, תשמע ברכה מסונתזת!

אנו מאחלים לכם התפתחות נהדרת בווקסימפלנט והישארו מעודכנים - יהיו לנו עוד הרבה 😉

מקור: www.habr.com