如何在 cTrader Algo 中引用第三方库

第三方库使用户能够扩展和改进其 cBot、指标和插件的功能。由于 cTrader Algo 是使用 .NET 6.0 开发的，用户可以在其算法项目中添加和使用使用 .NET 6.0 构建的第三方库。

在本文及其对应的视频中，您将学习如何在 cTrader Algo API 中引用第三方库。使用 Discord.Net 库，我们将演示如何向 Discord 频道发送消息。

通过安装 NuGet 包添加引用

在我们的第一个示例中，我们计划通过从 NuGet 库安装包来在我们的 cBot 项目中添加引用。 NuGet 是 .NET 平台的官方包管理器，用于创建、使用和分发包或库。

注意

如果您在 Visual Studio 中开发算法，请使用下面描述的添加引用的方法。否则，请导航到本文的 下一部分。

在 cTrader Algo 中，创建一个 cBot。点击新建按钮，输入名称如 "Discord 消息示例"，然后点击创建按钮。

接下来，转到 NuGet 网站，在文本字段中输入 Discord 并从结果中选择 Discord.Net 库。

点击 包管理器 选项卡，然后复制那里的命令。

返回 cTrader 并点击 在 Visual Studio 中编辑。

您的 cBot 项目应在您计算机上的 Visual Studio 应用程序中打开。

在 Visual Studio 中，打开工具菜单，选择 NuGet 包管理器，然后选择 包管理器控制台。

粘贴您之前从 NuGet 网站复制的命令并运行它。

1	`NuGet\Install-Package Discord.Net -Version 3.16.0`

安装所需的包后，我们可以继续开发我们的 cBot 示例。

首先声明重要参数，如 Discord 机器人令牌和频道 ID。

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

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

然后声明一个 Discord 客户端对象和一个消息频道对象。

DiscordSocketClient _discordSocketClient;
IMessageChannel _channel;

在我们的 OnStart() 方法中，编写一个简单的代码，以便在 cBot 启动时向我们的频道发送消息。

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");
}

您可以复制以下完整代码：

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
        }
    }
}