გასაღების მნიშვნელობის შენახვა, ან როგორ გახდა ჩვენი აპლიკაციები უფრო მოსახერხებელი

ვინც ავითარებს Voximplant-ზე, იცის „აპლიკაციების“ კონცეფცია, რომლებიც ერთმანეთთან აკავშირებს ღრუბლის სკრიპტებს, ტელეფონის ნომრებს, მომხმარებლებს, წესებს და ზარების რიგებს. მარტივად რომ ვთქვათ, აპლიკაციები არის ჩვენი პლატფორმის განვითარების ქვაკუთხედი, ნებისმიერი Voximplant-ზე დაფუძნებული გადაწყვეტის შესასვლელი წერტილი, რადგან ეს ყველაფერი იწყება აპლიკაციის შექმნით.

ადრე, აპლიკაციებს "ახსოვდათ" არც სკრიპტების მიერ შესრულებული მოქმედებები და არც გამოთვლების შედეგები, ამიტომ დეველოპერები იძულებულნი იყვნენ შეინახონ მნიშვნელობები მესამე მხარის სერვისებში ან მათ სარეზერვო სისტემაში. თუ თქვენ ოდესმე გიმუშავიათ ბრაუზერში ლოკალურ საცავთან, მაშინ ჩვენი ახალი ფუნქციონირება ძალიან ჰგავს ამას, რადგან. აპებს უფლებას აძლევს დაიმახსოვრონ გასაღები-მნიშვნელობის წყვილები, რომლებიც უნიკალურია თქვენი ანგარიშის თითოეული აპისთვის. შენახვა შესაძლებელი გახდა ახალი მოდულის წყალობით განაცხადის შენახვა - ჭრილის ქვეშ ნახავთ მოკლე სახელმძღვანელოს გამოყენების შესახებ, მოგესალმებით!

თქვენ დაგჭირდებათ

• Voximplant ანგარიში. თუ არ გაქვთ, მაშინ რეგისტრაცია აქ ცხოვრობს;
• Voximplant აპლიკაცია, ასევე სკრიპტი, წესი და ერთი მომხმარებელი. ამ ყველაფერს შევქმნით ამ ტუტორიალში;
• ვებ კლიენტი ზარის განსახორციელებლად - გამოიყენეთ ჩვენი ვებ ტელეფონი phone.voximplant.com.

Voximplant პარამეტრები

პირველი შედით თქვენს ანგარიშზე: manager.voximplant.com/auth. მენიუში მარცხნივ დააწკაპუნეთ "აპლიკაციები", შემდეგ "ახალი აპლიკაცია" და შექმენით აპლიკაცია სახელად საცავი. გადადით ახალ აპლიკაციაში, გადადით 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 მოდულს, დანარჩენი ლოგიკა მოთავსებულია მოვლენის დამმუშავებელში ზარის გაფრთხილება.

პირველ რიგში, ჩვენ ვაცხადებთ ცვლადს, რათა შევადაროთ საწყისი მნიშვნელობა ზარების რაოდენობას. შემდეგ ჩვენ ვცდილობთ მივიღოთ 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 სკრიპტი და დატოვეთ ნაგულისხმევი ნიღაბი (.*).

ბოლო არის მომხმარებლის შექმნა. ამისათვის გადადით "მომხმარებლებზე", დააჭირეთ "მომხმარებლის შექმნა", შეიყვანეთ სახელი (მაგალითად, user1) და პაროლი, შემდეგ დააჭირეთ "შექმნა". ჩვენ დაგვჭირდება ეს შესვლა-პაროლი წყვილი ავთენტიფიკაციისთვის ვებ ტელეფონში.

შემოწმება

გახსენით ვებ ტელეფონი ბმულიდან phone.voximplant.com და შედით ანგარიშის სახელის, აპის სახელის და მომხმარებლის სახელის/პაროლის წყვილის გამოყენებით აპიდან. წარმატებული შესვლის შემდეგ, შეყვანის ველში შეიყვანეთ ნებისმიერი სიმბოლო და დააწკაპუნეთ ზარზე. თუ ყველაფერი სწორად გაკეთდა, მაშინ მოისმენთ სინთეზირებულ მისალმებას!

გისურვებთ დიდ განვითარებას Voximplant-ში და იყავით თვალყური - კიდევ ბევრი გვექნება 😉

წყარო: www.habr.com