Discord ბოტის შექმნა .NET Core-ზე VPS სერვერზე განლაგებით

გამარჯობა ხაბროველებო!

დღეს ნახავთ სტატიას, რომელიც გაჩვენებთ, თუ როგორ უნდა შექმნათ ბოტი C#-ის გამოყენებით .NET Core-ზე და როგორ გაუშვათ იგი დისტანციურ სერვერზე.

სტატია შედგება ფონის, მოსამზადებელი ეტაპისგან, ლოგიკის ჩაწერისა და ბოტის დისტანციურ სერვერზე გადატანისგან.

იმედი მაქვს, რომ ეს სტატია ბევრ დამწყებს დაეხმარება.

წინაისტორია

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

პროგრამისტი (ბოტის დეველოპერი)
მოთხოვნები:

• პროგრამირების ენების ცოდნა;
• თვითსწავლის უნარი.

Пожелания:

• სხვა ადამიანების კოდის გაგების უნარი;
• DISCORD-ის ფუნქციონირების ცოდნა.

მიზნები:

• ბოტის განვითარება;
• ბოტის მხარდაჭერა და შენარჩუნება.

თქვენი სარგებელი:

• შესაძლებლობა მხარი დაუჭიროთ და გავლენა მოახდინოთ პროექტზე, რომელიც მოგწონთ;
• გუნდში მუშაობის გამოცდილების მიღება;
• არსებული უნარების დემონსტრირებისა და გაუმჯობესების შესაძლებლობა.

ამან მაშინვე დამაინტერესა. დიახ, მათ არ გადაიხადეს ეს სამუშაო, მაგრამ მათ არ მოსთხოვეს რაიმე ვალდებულება თქვენგან და ეს არ იქნება ზედმეტი პორტფოლიოში. ამიტომ მივწერე სერვერის ადმინს და მთხოვა დამეწერა ბოტი, რომელიც აჩვენებს მოთამაშის სტატისტიკას World of Tanks-ში.

მოსამზადებელი ეტაპი

დისკოდი
სანამ დავიწყებთ ჩვენი ბოტის წერას, ის უნდა შევქმნათ Discord-ისთვის. Შენ გჭირდება:

1. შედით Discord ანგარიშზე по ссылке
2. "აპლიკაციების" ჩანართში დააჭირეთ ღილაკს "ახალი აპლიკაცია" და დაასახელეთ ბოტი
3. მიიღეთ ბოტის ჟეტონი თქვენს ბოტში შესვლით და „პარამეტრების“ სიაში „ბოტის“ ჩანართის პოვნის გზით.
4. შეინახეთ ჟეტონი სადმე

Wargaming

ასევე, თქვენ უნდა შექმნათ აპლიკაცია Wargaming-ში, რომ მიიღოთ წვდომა Wargaming API-ზე. აქაც ყველაფერი მარტივია:

1. შედით თქვენს Wargaming ანგარიშზე ამ ბმულით
2. ჩვენ მივდივართ "ჩემი აპლიკაციები" და ვაჭერთ ღილაკს "ახალი აპლიკაციის დამატება", ვაძლევთ აპლიკაციის სახელს და ვირჩევთ მის ტიპს.
3. აპლიკაციის ID-ის შენახვა

პროგრამული უზრუნველყოფა

არჩევანის თავისუფლება უკვე არსებობს. ვიღაც იყენებს Visual Studio-ს, ვიღაც Rider-ს, ვიღაც ზოგადად ძლიერია და წერს კოდს Vim-ში (ბოლოს და ბოლოს, რეალური პროგრამისტები მხოლოდ კლავიატურას იყენებენ, არა?). ამასთან, იმისათვის, რომ არ განახორციელოთ Discord API, შეგიძლიათ გამოიყენოთ არაოფიციალური C# ბიბლიოთეკა "DSharpPlus". თქვენ შეგიძლიათ დააინსტალიროთ იგი ან NuGet-დან, ან თავად შექმენით წყაროები საცავიდან.

მათთვის, ვინც არ იცის ან დაავიწყდა როგორ დააინსტალიროთ აპლიკაციები NuGet-დან.ინსტრუქციები Visual Studio-სთვის

1. გადადით ჩანართზე Project - Manage NuGet Packages;
2. დააწკაპუნეთ მიმოხილვაზე და საძიებო ველში შეიყვანეთ „DSharpPlus“;
3. აირჩიეთ და დააინსტალირეთ ჩარჩო;
4. მოგება!

მოსამზადებელი ეტაპი დასრულდა, შეგიძლიათ გააგრძელოთ ბოტის დაწერა.

წერის ლოგიკა

ჩვენ არ განვიხილავთ აპლიკაციის მთელ ლოგიკას, მე მხოლოდ გაჩვენებთ, თუ როგორ ვიმუშაოთ ბოტის მიერ შეტყობინებების ჩარევით და როგორ ვიმუშაოთ Wargaming API-სთან.

Discord ბოტთან მუშაობა ხდება სტატიკური ასინქრონული Task MainTask(string[] args) მეშვეობით;
ამ ფუნქციის გამოსაძახებლად, Main-ში უნდა დარეგისტრირდეთ

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

შემდეგი, თქვენ უნდა მოაწყოთ თქვენი ბოტი:

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

სად ჟეტონი არის თქვენი ბოტის ნიშანი.
შემდეგ ლამბდას საშუალებით ვწერთ აუცილებელ ბრძანებებს, რომლებიც ბოტმა უნდა შეასრულოს:

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

სადაც e.Author.Username იღებს მომხმარებლის მეტსახელს.

ამ გზით, როდესაც გაგზავნით ნებისმიერ შეტყობინებას, რომელიც იწყება &-ით, ბოტი მოგესალმებათ.

ამ ფუნქციის დასასრულს თქვენ უნდა დაწეროთ await 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 კრძალავს ასეთ ტოკენებს, როდესაც ისინი შედიან მსოფლიო ქსელში, ხოლო მაქსიმუმ, ბოტის გამოყენებას იწყებს თავდამსხმელები.

განლაგება VPS - სერვერზე

მას შემდეგ რაც დაასრულებთ ბოტს, ის უნდა განთავსდეს სერვერზე, რომელიც მუდმივად მუშაობს 24/7. ეს გამოწვეულია იმით, რომ როდესაც თქვენი აპლიკაცია მუშაობს, ბოტიც მუშაობს. როგორც კი აპლიკაციას გამორთავთ, თქვენს ბოტსაც იძინებს.

ბევრი VPS სერვერი არსებობს ამ სამყაროში, როგორც Windows-ზე, ასევე Linux-ზე, თუმცა, უმეტეს შემთხვევაში, Linux-ზე ჰოსტინგი გაცილებით იაფია.

Discord სერვერზე მირჩიეს vscale.io და მაშინვე შევქმენი ვირტუალური სერვერი Ubuntu-ზე და ავტვირთე ბოტი. მე არ აღვწერ როგორ მუშაობს ეს საიტი, მაგრამ პირდაპირ ბოტის პარამეტრებზე გადავალ.

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

შემდეგი, თქვენ უნდა ატვირთოთ ბოტი Git სერვისში, როგორიცაა GitHub და მსგავსი, და კლონიროთ იგი VPS სერვერზე, ან ჩამოტვირთოთ თქვენი ბოტი სხვა გზით. გთხოვთ გაითვალისწინოთ, რომ თქვენ გექნებათ მხოლოდ კონსოლი, არა GUI. Საერთოდ.

ბოტის ჩამოტვირთვის შემდეგ, თქვენ უნდა გაუშვათ იგი. ამისთვის საჭიროა:

• ყველა დამოკიდებულების აღდგენა: dotnet აღდგენა
• აპლიკაციის აშენება: dotnet build name_project.sln -c გამოშვება
• გადადით ჩაშენებულ DLL-ზე;
• dotnet name_of_file.dll

გილოცავ! თქვენი ბოტი მუშაობს. თუმცა, ბოტი, სამწუხაროდ, იკავებს კონსოლს და VPS სერვერიდან გასვლა ადვილი არ არის. ასევე სერვერის გადატვირთვის შემთხვევაში ბოტის ახლებურად გაშვება მოგიწევთ. სიტუაციიდან გამოსვლის რამდენიმე გზა არსებობს. ყველა მათგანი დაკავშირებულია სერვერის გაშვების დროს გაშვებასთან:

• დაამატეთ გაშვებული სკრიპტი /etc/init.d
• შექმენით სერვისი, რომელიც გაშვებისთანავე იმუშავებს.

მე ვერ ვხედავ მათზე დაწვრილებით ფიქრს, ყველაფერი საკმარისად დეტალურად არის აღწერილი ინტერნეტში.

დასკვნები

მიხარია, რომ ეს დავალება ავიღე. ეს იყო ჩემი პირველი ბოტის განვითარების გამოცდილება და მიხარია, რომ ახალი ცოდნა მივიღე C #-ში და ლინუქსით მუშაობა.

ბმული Discord სერვერთან. მათთვის, ვინც თამაშობს Wargaming თამაშებს.
ბმული საცავთან, სადაც Discord ბოტი მდებარეობს.
ბმული DSharpPlus საცავთან.
დიდი მადლობა!

წყარო: www.habr.com