VPS ဆာဗာသို့ ဖြန့်ကျက်ခြင်းဖြင့် .NET Core တွင် Discord bot တစ်ခုကို ဖန်တီးခြင်း။

မင်္ဂလာပါ Khabrovites။

ယနေ့တွင် .NET Core တွင် C# ကိုအသုံးပြု၍ bot တစ်ခုကိုဖန်တီးနည်းနှင့် အဝေးထိန်းဆာဗာတွင် ၎င်းကိုမည်ကဲ့သို့လုပ်ဆောင်ရမည်ကိုပြသမည့် ဆောင်းပါးတစ်ပုဒ်ကို သင်တွေ့ရပါမည်။

ဆောင်းပါးတွင် နောက်ခံတစ်ခု၊ ကြိုတင်ပြင်ဆင်သည့်အဆင့်၊ ယုတ္တိဗေဒရေးသားခြင်းနှင့် ဘော့တ်ကို အဝေးထိန်းဆာဗာသို့ လွှဲပြောင်းခြင်းတို့ ပါဝင်မည်ဖြစ်သည်။

ဒီဆောင်းပါးက အစပြုသူတော်တော်များများကို အထောက်အကူဖြစ်စေမယ်လို့ မျှော်လင့်ပါတယ်။

စောပိုငျးကာလ

အားလုံးဟာ Discord ဆာဗာမှာ အိပ်မပျော်တဲ့ ဆောင်းဦးညတစ်ညမှာ စတင်ခဲ့တာပါ။ ကျွန်တော် သူနဲ့ မကြာသေးခင်ကမှ စပြီး သူ့ကို အပေါ်အောက် လိုက်လေ့လာခဲ့တယ်။ စာသားချန်နယ် "Vacancies" ကို ရှာတွေ့ပြီးနောက် ကျွန်ုပ်စိတ်ဝင်စားလာပြီး ၎င်းကိုဖွင့်ကာ ကျွန်ုပ်ကို စိတ်မဝင်စားသော ကမ်းလှမ်းမှုများကြားတွင် တွေ့ရှိခဲ့သည်၊ ၎င်းတို့မှာ-

"ပရိုဂရမ်မာ (bot developer)၊
လိုအပ်ချက်များကို:

• ပရိုဂရမ်းမင်းဘာသာစကားများကို အသိပညာ၊
• ကိုယ်တိုင်လေ့လာသင်ယူနိုင်မှု။

အကြံပြုချက်များ:

• အခြားသူများ၏ကုဒ်ကို နားလည်နိုင်စွမ်း၊
• DISCORD လုပ်ဆောင်နိုင်စွမ်း အသိပညာ။

ရည်ရွယ်ချက်များ:

• bot ဖွံ့ဖြိုးတိုးတက်မှု;
• bot ၏ပံ့ပိုးမှုနှင့်ထိန်းသိမ်းမှု။

သင့်အကျိုးကျေးဇူး-

• သင်နှစ်သက်သော ပရောဂျက်ကို ပံ့ပိုးရန်နှင့် သြဇာလွှမ်းမိုးရန် အခွင့်အလမ်း၊
• အဖွဲ့တစ်ဖွဲ့တွင်အလုပ်လုပ်အတွေ့အကြုံများရရှိ;
• လက်ရှိ အရည်အချင်းများကို မြှင့်တင်ရန်နှင့် သရုပ်ပြရန် အခွင့်အလမ်း။

ဒါကို ချက်ချင်း စိတ်ဝင်စားတယ်။ ဟုတ်တယ်၊ သူတို့က ဒီအလုပ်အတွက် ပိုက်ဆံမပေးဘူး၊ ဒါပေမယ့် မင်းဆီက ဘာဝတ္တရားတွေမှ မတောင်းဘူး၊ ပြီးတော့ အစုစုအတွက် မလိုအပ်ပါဘူး။ ထို့ကြောင့်၊ ကျွန်ုပ်သည် ဆာဗာစီမံခန့်ခွဲသူထံ စာရေးခဲ့ပြီး World of Tanks တွင် ကစားသမား၏စာရင်းအင်းများကိုပြသမည့် bot တစ်ခုကိုရေးရန် တောင်းဆိုခဲ့သည်။

အဆိုပါကြိုတင်အဆင့်

သဘောထားကွဲလွဲ
ကျွန်ုပ်တို့၏ bot ကို မရေးမီ၊ Discord အတွက် ၎င်းကို ဖန်တီးရန် လိုအပ်ပါသည်။ သင်လိုအပ်သည်-

1. Discord အကောင့်သို့ ဝင်ရောက်ပါ။ လင့်ခ်
2. "လျှောက်လွှာများ" တက်ဘ်တွင်၊ "လျှောက်လွှာအသစ်" ခလုတ်ကိုနှိပ်ပြီး bot ကိုအမည်ပေးပါ။
3. သင့် bot သို့ဝင်ရောက်ပြီး “ဆက်တင်များ” စာရင်းရှိ “ဘော့တ်” တက်ဘ်ကို ရှာဖွေခြင်းဖြင့် ဘော့တ်တိုကင်ရယူပါ
4. တိုကင်ကို တစ်နေရာရာမှာ သိမ်းဆည်းပါ။

ဂိမ်းကစားခြင်း

ထို့အပြင် Wargaming API သို့ဝင်ရောက်ခွင့်ရရှိရန် Wargaming တွင် အက်ပလီကေးရှင်းတစ်ခုဖန်တီးရန်လိုအပ်သည်။ ဤတွင်လည်း၊ အရာအားလုံးသည် ရိုးရှင်းပါသည်။

1. သင်၏ Wargaming အကောင့်သို့ ဝင်ရောက်ပါ။ ဒီလင့်ခ်ကနေ
2. ကျွန်ုပ်တို့သည် "My Applications" သို့သွား၍ "လျှောက်လွှာအသစ်တစ်ခုထည့်ပါ" ခလုတ်ကိုနှိပ်ပါ၊ လျှောက်လွှာ၏အမည်ကိုပေး၍ ၎င်း၏အမျိုးအစားကိုရွေးချယ်ပါ။
3. လျှောက်လွှာ ID ကို သိမ်းဆည်းခြင်း။

Software များ

လွတ်လပ်စွာ ရွေးချယ်ပိုင်ခွင့် ရှိပြီးသားပါ။ တစ်စုံတစ်ယောက်သည် Visual Studio၊ Rider တစ်စုံတစ်ဦး၊ တစ်စုံတစ်ဦးသည် ယေဘုယျအားဖြင့် စွမ်းအားကြီးမားပြီး Vim တွင် ကုဒ်ရေးသည် (တကယ်တော့ ပရိုဂရမ်မာများသည် ကီးဘုတ်ကိုသာ အသုံးပြုသည်မဟုတ်လား)။ သို့သော်၊ Discord API ကို အကောင်အထည်မဖော်ရန်အတွက်၊ သင်သည် တရားဝင်မဟုတ်သော C# စာကြည့်တိုက် “DSharpPlus” ကို အသုံးပြုနိုင်သည်။ NuGet မှဖြစ်စေ သင်ထည့်သွင်းနိုင်သည် သို့မဟုတ် အရင်းအမြစ်များကို သိုလှောင်မှုမှ သင်ကိုယ်တိုင်တည်ဆောက်ခြင်းဖြင့်ဖြစ်စေ ထည့်သွင်းနိုင်သည်။

NuGet မှ application ကို install လုပ်နည်းမသိသေးသူများ၊Visual Studio အတွက် လမ်းညွှန်ချက်များ

1. tab ကိုသွားပါ Project - Manage NuGet Packages;
2. ပြန်လည်သုံးသပ်ချက်ကို နှိပ်ပြီး ရှာဖွေမှုအကွက်တွင် “DSharpPlus” ကို ရိုက်ထည့်ပါ။
3. မူဘောင်ကို ရွေးချယ်ပြီး ထည့်သွင်းပါ။
4. အမြတ်အစွန်း!

ကြိုတင်ပြင်ဆင်မှုအဆင့်ပြီးသွားပါပြီ၊ သင်သည် bot ကိုဆက်လက်ရေးသားနိုင်ပါသည်။

ယုတ္တိဗေဒ ရေးခြင်း။

အပလီကေးရှင်း၏ယုတ္တိတစ်ခုလုံးကိုကျွန်ုပ်တို့ထည့်သွင်းစဉ်းစားမည်မဟုတ်ပါ၊ ကျွန်ုပ်သည် bot မှမက်ဆေ့ခ်ျများကိုကြားဖြတ်ခြင်းနှင့်မည်သို့လုပ်ဆောင်ရမည်၊ Wargaming API နှင့်မည်သို့အလုပ်လုပ်ပုံကိုသာပြသပါမည်။

Discord bot နှင့်အလုပ်လုပ်ခြင်းသည် static async Task MainTask(string[] args);
ဤလုပ်ဆောင်ချက်ကိုခေါ်ဆိုရန်အတွက် Main တွင်သင်စာရင်းသွင်းရန်လိုအပ်သည်။

MainTask(args).ConfigureAwait(false).GetAwaiter().GetResult();

ထို့နောက် သင်၏ bot ကို စတင်ရန် လိုအပ်သည်-

discord = new DiscordClient(new DiscordConfiguration
{
    Token = token,
    TokenType = TokenType.Bot,
    UseInternalLogHandler = true,
    LogLevel = LogLevel.Debug
});

တိုကင်သည် သင့် bot ၏ တိုကင်ဘယ်မှာလဲ။
ထို့နောက် lambda မှတဆင့် bot သည် လုပ်ဆောင်သင့်သည့် လိုအပ်သော command များကို ရေးလိုက်ပါသည်။

discord.MessageCreated += async e =>
{
    string message = e.Message.Content;
    if (message.StartsWith("&"))
    {
        await e.Message.RespondAsync(“Hello, ” + e.Author.Username);
    }
};

e.Author.Username သည် အသုံးပြုသူ၏ အမည်ပြောင်ကို ရရှိသည့်နေရာ။

ဤနည်းအားဖြင့် သင်သည် & နှင့်စသည့် မည်သည့်မက်ဆေ့ဂျ်ကိုမဆို ပေးပို့သောအခါ၊ bot သည် သင့်ကို နှုတ်ဆက်လိမ့်မည်။

ဤလုပ်ဆောင်ချက်၏အဆုံးတွင်၊ သင်သည် စောင့်ဆိုင်းနေသော discord ကိုရေးရပါမည်။ConnectAsync(); Task.Delay(-1);

၎င်းသည် သင့်အား ပင်မစာကြောင်းကို မထည့်သွင်းဘဲ နောက်ခံရှိ အမိန့်များကို လုပ်ဆောင်နိုင်စေမည်ဖြစ်သည်။

ယခုကျွန်ုပ်တို့သည် Wargaming API ကိုကိုင်တွယ်ရန်လိုအပ်သည်။ အရာအားလုံးသည် ဤနေရာတွင် ရိုးရှင်းပါသည် - CURL တောင်းဆိုမှုများကို ရေးပါ၊ JSON စာကြောင်းပုံစံဖြင့် တုံ့ပြန်မှုကို ရယူပါ၊ လိုအပ်သောဒေတာကို ထိုနေရာမှ ဆွဲထုတ်ကာ ၎င်းတို့ကို ကိုင်တွယ်လုပ်ဆောင်ပါ။

WargamingAPI ဖြင့် လုပ်ဆောင်ခြင်း ဥပမာ

public Player FindPlayer(string searchNickname)
        {
            //https://api.worldoftanks.ru/wot/account/list/?application_id=y0ur_a@@_id_h3r3search=nickname
            urlRequest = resourceMan.GetString("url_find_player") + appID + "&search=" + searchNickname;
            Player player = null;
            string resultResponse = GetResponse(urlRequest);
            dynamic parsed = JsonConvert.DeserializeObject(resultResponse);

            string status = parsed.status;
            if (status == "ok")
            {
                int count = parsed.meta.count;
                if (count > 0)
                {
                    player = new Player
                    {
                        Nickname = parsed.data[0].nickname,
                        Id = parsed.data[0].account_id
                    };
                }
                else
                {
                    throw new PlayerNotFound("Игрок не найден");
                }
            }
            else
            {
                string error = parsed.error.message;
                if (error == "NOT_ENOUGH_SEARCH_LENGTH")
                {
                    throw new PlayerNotFound("Минимум три символа требуется");
                }
                else if (error == "INVALID_SEARCH")
                {
                    throw new PlayerNotFound("Неверный поиск");
                }
                else if (error == "SEARCH_NOT_SPECIFIED")
                {
                    throw new PlayerNotFound("Пустой никнейм");
                }
                else
                {
                    throw new Exception("Something went wrong.");
                }
            }

            return player;
        }

သတိထား! တိုကင်များနှင့် အပလီကေးရှင်း ID အားလုံးကို ရှင်းရှင်းလင်းလင်း စာသားဖြင့် သိမ်းဆည်းရန် တင်းတင်းကျပ်ကျပ် မထောက်ခံပါ။ အနည်းဆုံးအားဖြင့်၊ Discord သည် ကမ္ဘာတစ်ဝှမ်းရှိ ကွန်ရက်အတွင်းသို့ ဝင်ရောက်သည့်အခါ ယင်းတိုကင်များကို ပိတ်ပင်မည်ဖြစ်ပြီး အမြင့်ဆုံးအချိန်တွင် တိုက်ခိုက်သူများမှ bot ကို စတင်အသုံးပြုနိုင်ပါသည်။

VPS - ဆာဗာသို့ ဖြန့်ကျက်ပါ။

သင် bot နှင့် ပြီးသည်နှင့်၊ ၎င်းကို 24/7 အဆက်မပြတ်လည်ပတ်နေသော ဆာဗာပေါ်တွင် လက်ခံထားရန် လိုအပ်ပါသည်။ ၎င်းမှာ သင်၏ အက်ပ်လီကေးရှင်းကို လည်ပတ်နေချိန်တွင် bot သည်လည်း အလုပ်လုပ်နေသောကြောင့် ဖြစ်သည်။ အပလီကေးရှင်းကို ပိတ်လိုက်သည်နှင့် သင့် bot သည် အိပ်ပျော်သွားပါသည်။

VPS ဆာဗာများစွာသည် ဤကမ္ဘာပေါ်တွင် Windows နှင့် Linux တွင်ရှိသော်လည်း၊ ကိစ္စအများစုတွင် Linux တွင် host ပြုလုပ်ရန် များစွာစျေးသက်သာပါသည်။

Discord ဆာဗာတွင် ကျွန်ုပ်ကို vscale.io မှ အကြံပြုထားပြီး Ubuntu တွင် virtual server တစ်ခုကို ချက်ချင်းဖန်တီးပြီး bot ကို အပ်လုဒ်လုပ်ပါသည်။ ဤဆိုက် မည်သို့အလုပ်လုပ်သည်ကို ကျွန်ုပ်ဖော်ပြမည်မဟုတ်သော်လည်း ဘော့တ်ဆက်တင်များသို့ တိုက်ရိုက်သွားပါမည်။

ပထမဦးစွာ၊ သင်သည် .NET Core တွင်ရေးသားထားသော ကျွန်ုပ်တို့၏ bot ကိုလည်ပတ်စေမည့်လိုအပ်သောဆော့ဖ်ဝဲကိုထည့်သွင်းရန်လိုအပ်သည်။ ပြုလုပ်နည်းကို ဤနေရာတွင် ဖော်ပြထားပါသည်။.

ထို့နောက်၊ သင်သည် GitHub ကဲ့သို့သော Git ဝန်ဆောင်မှုတစ်ခုသို့ အပ်လုဒ်လုပ်ရန် လိုအပ်ပြီး ၎င်းကို VPS ဆာဗာသို့ ပုံတူကူးရန် သို့မဟုတ် သင်၏ bot ကို အခြားနည်းလမ်းဖြင့် ဒေါင်းလုဒ်လုပ်ရန် လိုအပ်သည်။ သင့်တွင် ကွန်ဆိုးလ်တစ်ခုသာရှိမည်ဖြစ်ပြီး GUI မရှိပါ။ လုံးဝ

သင့် bot ကို ဒေါင်းလုဒ်လုပ်ပြီးပါက ၎င်းကို run ရန် လိုအပ်ပါသည်။ ဤအတွက်၊ သင်လိုအပ်သည်-

• မှီခိုမှုအားလုံးကို ပြန်လည်ရယူပါ- dotnet ပြန်လည်ရယူပါ။
• အပလီကေးရှင်းတည်ဆောက်ခြင်း- dotnet build name_project.sln -c ကို ဖြန့်ချိသည်။
• တည်ဆောက်ထားသော DLL သို့သွားပါ။
• dotnet name_of_file.dll

ဂုဏ်ယူပါသည်။ သင့် bot သည် အလုပ်လုပ်နေပါသည်။ သို့သော်၊ bot သည် ကံမကောင်းစွာဖြင့်၊ console ကိုသိမ်းပိုက်ထားပြီး VPS ဆာဗာမှထွက်ရန်မလွယ်ကူပါ။ ထို့အပြင်၊ ဆာဗာတစ်ခုပြန်လည်စတင်သောအခါတွင်၊ သင်သည် bot ကိုနည်းလမ်းအသစ်ဖြင့်စတင်ရမည်ဖြစ်ပါသည်။ အခြေအနေကနေ ရုန်းထွက်ဖို့ နည်းလမ်း နှစ်သွယ်ရှိပါတယ်။ ၎င်းတို့အားလုံးသည် server startup တွင် launch နှင့်ဆက်စပ်သည်-

• run script ကို /etc/init.d သို့ ထည့်ပါ။
• စတင်ချိန်တွင် လုပ်ဆောင်မည့် ဝန်ဆောင်မှုကို ဖန်တီးပါ။

၎င်းတို့အပေါ်တွင် ကိန်းအောင်းနေသည့်အချက်ကို ကျွန်ုပ်မမြင်ပါ၊ အရာအားလုံးကို အင်တာနက်ပေါ်တွင် လုံလောက်သောအသေးစိတ်ဖြင့် ဖော်ပြထားပါသည်။

တွေ့ရှိချက်များ

ဒီတာဝန်ကို ထမ်းဆောင်ရတာ ဝမ်းသာပါတယ်။ ဤသည်မှာ ကျွန်ုပ်၏ ပထမဆုံး bot development အတွေ့အကြုံဖြစ်ပြီး၊ C# တွင် အသိပညာအသစ်များရခဲ့ပြီး Linux နှင့် လုပ်ဆောင်ရသည့်အတွက် ဝမ်းသာပါသည်။

Discord ဆာဗာသို့ လင့်ခ်ချိတ်ပါ။ Wargaming ဂိမ်းဆော့သူများအတွက်။
Discord bot တည်ရှိရာ သိုလှောင်ရာသို့ လင့်ခ်ချိတ်ပါ။
DSharpPlus repository သို့ လင့်ခ်ချိတ်ပါ။
Спасибозавнимание!

source: www.habr.com