Cách tham chiếu thư viện của bên thứ ba trong cTrader Algo

Thư viện của bên thứ ba cho phép người dùng mở rộng và cải thiện chức năng của cBot, chỉ báo và plugin của họ. Vì cTrader Algo được phát triển với .NET 6.0, người dùng có thể thêm và sử dụng các thư viện của bên thứ ba được xây dựng với .NET 6.0 trong các dự án thuật toán của họ.

Trong bài viết này và video tương ứng, bạn sẽ học cách tham chiếu thư viện của bên thứ ba trong API cTrader Algo. Sử dụng thư viện Discord.Net, chúng tôi sẽ trình bày cách gửi tin nhắn đến một kênh Discord.

Thêm tham chiếu bằng cách cài đặt gói NuGet

Trong ví dụ đầu tiên của chúng ta, chúng ta dự định thêm một tham chiếu trong dự án cBot của mình bằng cách cài đặt một gói từ thư viện NuGet. NuGet là trình quản lý gói chính thức cho nền tảng .NET được sử dụng để tạo, tiêu thụ và phân phối các gói hoặc thư viện.

Trong cTrader Algo, tạo một cBot. Nhấp vào nút New, nhập tên như "Discord Message Example", sau đó nhấp vào nút Create.

Tiếp theo, truy cập trang web NuGet, nhập Discord vào trường văn bản và chọn thư viện Discord.Net từ kết quả.

Nhấp vào tab Package manager và sau đó sao chép lệnh ở đó.

Quay lại cTrader và nhấp vào Edit in Visual Studio.

Dự án cBot của bạn sẽ mở trong ứng dụng Visual Studio trên máy tính của bạn.

Trong Visual Studio, mở menu Tools, chọn NuGet package manager, sau đó chọn Package manager console.

Dán lệnh bạn đã sao chép trước đó từ trang web NuGet và chạy nó.

1

NuGet\Install-Package Discord.Net -Version 3.16.0

Sau khi đã cài đặt gói cần thiết, chúng ta có thể tiếp tục phát triển ví dụ cBot của mình.

Bắt đầu bằng cách khai báo các tham số quan trọng, chẳng hạn như mã thông báo bot Discord và ID kênh.

1
2
3
4
5

[Parameter("Discord Bot Token")]
public string BotToken { get; set; }

[Parameter("Discord Channel ID")]
public string ChannelID { get; set; }

Sau đó khai báo một đối tượng Discord client và một đối tượng kênh tin nhắn.

1
2

DiscordSocketClient _discordSocketClient;
IMessageChannel _channel;

Trong phương thức OnStart() của chúng ta, viết một đoạn mã đơn giản để gửi tin nhắn đến kênh của chúng ta khi cBot bắt đầu.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

protected override void OnStart()
{
    _discordSocketClient = new DiscordSocketClient();
    _discordSocketClient.LoginAsync(TokenType.Bot, BotToken);
    _discordSocketClient.StartAsync();

    var channelID = Convert.ToUInt64(ChannelID);
    _channel = _discordSocketClient.GetChannelAsync(channelID).Result as IMessageChannel;
    _channel.SendMessageAsync("Example cBot Started");
}

Bạn có thể sao chép toàn bộ mã bên dưới:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

using System;
using cAlgo.API;
using cAlgo.API.Collections;
using cAlgo.API.Indicators;
using cAlgo.API.Internals;
using Discord.WebSocket;
using Discord;

namespace cAlgo.Robots
{
    [Robot(AccessRights = AccessRights.None, AddIndicators = true)]
    public class DiscordMessageExample : Robot
    {
        [Parameter("Discord Bot Token")]
        public string BotToken { get; set; }

        [Parameter("Discord Channel ID")]
        public string ChannelID { get; set; }

        DiscordSocketClient _discordSocketClient;
        IMessageChannel _channel;

        protected override void OnStart()
        {
            _discordSocketClient = new DiscordSocketClient();
            _discordSocketClient.LoginAsync(TokenType.Bot, BotToken);
            _discordSocketClient.StartAsync();

            var channelID = Convert.ToUInt64(ChannelID);
            _channel = _discordSocketClient.GetChannelAsync(channelID).Result as IMessageChannel;
            _channel.SendMessageAsync("Example cBot Started");
        }

        protected override void OnTick()
        {
            // Handle price updates here
        }

        protected override void OnStop()
        {
            // Handle cBot stop here
        }
    }
}

Bây giờ, xây dựng cBot.

Quay lại cTrader. Nhấp vào Add instance, chỉ định các tham số ưa thích của bạn trong cửa sổ và sau đó nhấp vào nút Add instance.

Nhập mã thông báo bot Discord và ID kênh của bạn.

Khởi chạy phiên bản cBot. Khi cửa sổ Access request xuất hiện, nhấp vào Allow để tiếp tục.

cBot sẽ bắt đầu chạy và bạn sẽ thấy một tin nhắn đến trong kênh Discord.

Thêm tham chiếu thông qua giao diện người dùng cTrader

Một số thư viện không có sẵn dưới dạng gói NuGet. Nếu bạn định sử dụng các thư viện như vậy trong dự án cBot của mình, bạn phải thêm các tệp DLL của chúng trực tiếp làm tham chiếu.

Ở đây, chúng tôi sẽ trình bày cách bạn có thể tham chiếu cùng thư viện Discord.Net bằng cách thêm các tệp DLL của nó.

Quay lại Visual Studio và gỡ cài đặt thư viện Discord.Net mà chúng ta đã cài đặt trong phần trước. Mở NuGet Package Manager Console như bạn đã làm trước đó và chạy lệnh sau:

1

NuGet\Uninstall-Package Discord.Net -Version 3.16.0

Các gói Discord sẽ bị xóa khỏi tham chiếu trong cBot Discord Message Example của chúng ta. Nếu cBot được xây dựng lại bây giờ, quá trình xây dựng sẽ kết thúc với một số thông báo lỗi do thiếu thư viện.

Quay lại cTrader và thêm các thư viện cần thiết bằng chức năng Manage references ở trên cùng.

Khi cửa sổ Reference manager xuất hiện, điều hướng đến Browse sau đó nhấp vào nút Browse. Chọn tệp DLL và sau đó thực hiện cùng một hành động cho tất cả các tệp DLL bạn muốn tham chiếu.

Nhấp vào Apply và xây dựng lại cBot.

Bây giờ, khi bạn chạy một phiên bản cBot, quá trình xây dựng sẽ được hoàn thành mà không có lỗi và bạn sẽ thấy tin nhắn đến trong kênh Discord.

Bài viết này đã trình bày cách tham chiếu thư viện của bên thứ ba trong cTrader Algo bằng hai phương pháp khác nhau.