Português PT
Ver no GitHub

Estratégia de alerta sonoro de conexão e desconexão

Visão geral

A Estratégia de alerta sonoro Connect Disconnect monitora continuamente o status da conexão do conector estratégico e registra cada transição entre os estados online e offline. O especialista MQL5 original reproduziu arquivos de áudio quando o terminal MetaTrader foi conectado ou desconectado. Essa conversão C# mantém a lógica central – detectando alterações de conexão – e expõe ganchos que permitem que o tempo de execução do StockSharp registre eventos e durações. A estratégia pode ser usada como um cão de guarda leve que informa a operadora sobre problemas de conectividade sem fazer nenhum pedido.

Principais recursos

  • Pesquisa periodicamente o estado do conector usando um intervalo configurável.
  • Detecta eventos de conexão e desconexão e grava entradas de log detalhadas.
  • Registra quanto tempo o terminal permaneceu online ou offline (opcional).
  • Ignora os sons de notificação na primeira verificação para espelhar o comportamento MQL.

Parâmetros

Nome Padrão Descrição
CheckIntervalSeconds 1 Número de segundos entre verificações de status do conector. Deve ser maior que zero.
LogDurations true Quando habilitada, a estratégia registra o intervalo de tempo que a conexão permaneceu online ou offline após cada transição.

Todos os parâmetros são expostos por meio de StrategyParam<T> para que possam ser modificados na IU ou durante a otimização.

Como funciona

  1. Quando a estratégia é iniciada, ela armazena o estado atual do conector e, opcionalmente, registra o status inicial.
  2. Um System.Threading.Timer chama periodicamente um manipulador interno que compara o sinalizador de conexão atual com o valor anterior.
  3. Se o estado mudou, a estratégia registra a transição. A primeira notificação é marcada como "inicial" e não representa um alerta sonoro real (correspondendo à lógica original do Expert Advisor).
  4. Os registros de duração opcionais mostram quanto tempo durou o estado anterior, ajudando o operador a avaliar a estabilidade da conexão.
  5. O cronômetro é descartado automaticamente quando a estratégia é interrompida ou reiniciada.

Notas de uso

  • Anexe a estratégia a qualquer terminal StockSharp habilitado para conector. Ele não interage com dados de mercado nem faz pedidos.
  • Mantenha o intervalo de pesquisa padrão para monitoramento quase em tempo real. Aumente o valor se precisar apenas de atualizações grosseiras.
  • A estratégia usa o subsistema de registro StockSharp (LogInfo). Configure ouvintes de log ou painéis para ver as notificações.
  • Para adicionar alertas sonoros reais, conecte um serviço de notificação em seu aplicativo host e reproduza o áudio quando as mensagens de registro chegarem.

Considerações de segurança

  • A estratégia valida o intervalo de pesquisa e lança uma exceção se não for positivo.
  • Os retornos de chamada do temporizador usam a estratégia CurrentTime para garantir carimbos de data/hora consistentes mesmo quando a reprodução de dados históricos é usada.
  • Todos os recursos são liberados na parada/redefinição para evitar temporizadores de segundo plano após a estratégia ser desativada.
using System;

using Ecng.Common;

using StockSharp.Algo.Indicators;
using StockSharp.Algo.Strategies;
using StockSharp.BusinessEntities;
using StockSharp.Messages;

namespace StockSharp.Samples.Strategies;

/// <summary>
/// Connection alert strategy with SMA crossover trading.
/// Buys when fast SMA crosses above slow SMA, sells on cross below.
/// </summary>
public class ConnectDisconnectSoundAlertStrategy : Strategy
{
	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<int> _fastPeriod;
	private readonly StrategyParam<int> _slowPeriod;

	public DataType CandleType
	{
		get => _candleType.Value;
		set => _candleType.Value = value;
	}

	public int FastPeriod
	{
		get => _fastPeriod.Value;
		set => _fastPeriod.Value = value;
	}

	public int SlowPeriod
	{
		get => _slowPeriod.Value;
		set => _slowPeriod.Value = value;
	}

	public ConnectDisconnectSoundAlertStrategy()
	{
		_candleType = Param(nameof(CandleType), TimeSpan.FromMinutes(5).TimeFrame())
			.SetDisplay("Candle Type", "Candle timeframe", "General");

		_fastPeriod = Param(nameof(FastPeriod), 10)
			.SetGreaterThanZero()
			.SetDisplay("Fast SMA", "Fast SMA period", "Indicators");

		_slowPeriod = Param(nameof(SlowPeriod), 30)
			.SetGreaterThanZero()
			.SetDisplay("Slow SMA", "Slow SMA period", "Indicators");
	}

	/// <inheritdoc />
	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);

		var fast = new SimpleMovingAverage { Length = FastPeriod };
		var slow = new SimpleMovingAverage { Length = SlowPeriod };

		decimal? prevFast = null;
		decimal? prevSlow = null;

		var subscription = SubscribeCandles(CandleType);
		subscription
			.Bind(fast, slow, (candle, fastVal, slowVal) =>
			{
				if (candle.State != CandleStates.Finished)
					return;

				if (!IsFormedAndOnlineAndAllowTrading())
					return;

				if (prevFast.HasValue && prevSlow.HasValue)
				{
					var crossUp = prevFast.Value <= prevSlow.Value && fastVal > slowVal;
					var crossDown = prevFast.Value >= prevSlow.Value && fastVal < slowVal;

					if (crossUp && Position <= 0)
						BuyMarket();
					else if (crossDown && Position >= 0)
						SellMarket();
				}

				prevFast = fastVal;
				prevSlow = slowVal;
			})
			.Start();

		var area = CreateChartArea();
		if (area != null)
		{
			DrawCandles(area, subscription);
			DrawIndicator(area, fast);
			DrawIndicator(area, slow);
			DrawOwnTrades(area);
		}
	}
}