Условия оповещения

Функция аннотации alertcondition позволяет создавать пользовательские условия оповещения в Pine индикаторах. Один индикатор может содержать более одного оповещения alertcondition. Хотя наличие вызовов alertcondition в скрипте стратегии Pine не вызовет ошибки компиляции, на их основе нельзя создавать оповещения.

Функция alertcondition имеет следующий формат записи:

alertcondition(condition, title, message)

condition

представляет собой последовательность логических значений (true или false), используемых для запуска предупреждения. true означает, что условие предупреждения выполнено, и предупреждение должно сработать. false означает, что условие предупреждения не выполняется и предупреждение не должно срабатывать. Это обязательный аргумент.

title

— необязательный аргумент, который задает имя условия предупреждения, которое будет отображаться в диалоговом окне создания предупреждения TradingView.

message

— является необязательным аргументом, который задает текстовое сообщение, которое будет отображаться при срабатывании сигнализации. Текст отображается в поле Message диалогового окна Create Alert (Создать оповещение), а затем может быть изменен перед созданием оповещения.

Вот пример кода, создающего условие предупреждения:

//@version=4
study("Example of alertcondition")
src = input(close)
ma_1 = sma(src, 20)
ma_2 = sma(src, 10)
c = cross(ma_1, ma_2)
alertcondition(c, title='Red crosses blue', message='Red and blue have crossed!')
plot(ma_1, color=color.red)
plot(ma_2, color=color.blue)

Функция alertcondition делает оповещение доступным в диалоговом окне Create Alert (Создать оповещение). Обратите внимание, что функция не запускает оповещения программно, а только дает возможность создать оповещение из него в диалоговом окне Create Alert. Предупреждения всегда должны создаваться вручную. Предупреждение, созданное из условия alertcondition в коде скрипта, не отображает ничего на графике, кроме сообщения при срабатывании.

Чтобы создать предупреждение на основе alertcondition, необходимо применить индикатор Pine, содержащий хотя бы один alertcondition вызов, в текущем графике открыть диалоговое окно Create Alert, а затем выбрать одно из конкретных условий оповещения, определенных в коде индикатора.

При срабатывании оповещения вы увидите следующее сообщение:

Изменение оповещения

При создании оповещения TradingView сохраняет в оповещении следующую информацию, чтобы оно могло работать независимо в облаке:

• Код индикатора
• Текущие настройки / входы индикатора (включая изменения, внесенные пользователем)
• Основной тикер и таймфрейм графика.

Если вы хотите, чтобы какие-либо изменения этой информации отражались в поведении существующего оповещения, вам нужно будет либо удалить оповещение и создать новое в новом контексте, либо использовать следующие шаги для изменения оповещения.

Если вы обновили код индикатотра или его настройки / входные данные, вы можете:

• Кликнуть на строку оповещения в списке Управление оповещениями, чтобы вызвать график и таймфрейм, на который настроено оповещение.
• Использовать шестеренку на строке предупреждения в списке Управления оповещениями, чтобы вывести на экран диалоговое окно Редактировать оповещения.
• В раскрывающемся меню «Условие» выберите новую версию индикатора, которую вы хотите использовать. Это будет самый нижний вариант индикатора в меню. Обратите внимание, что если вы изменили настройки / входные данные индикатора, вы увидите эти новые значения рядом с новой версией индикатора в раскрывающемся меню.
• Нажмите ОК.

Если вы хотите изменить тикер или таймфрейм, на котором работает оповещение, вы можете:

• Установить на графике новый символ и / или таймфрейм, который вы хотите применить к оповещению.
• Использовать шестеренку на строке предупреждения в списке «Управление оповещениями», чтобы открыть диалоговое окно « Изменить оповещение».
• В раскрывающемся меню «Условие» выберите тикер и таймфрейм, для которых нужно настроить оповещение, которые должны соответствовать графику, на котором вы сейчас находитесь.
• Сделайте новый выбор в раскрывающемся меню «Условие», на этот раз это будет индикатор, содержащий условия оповещения, при котором оно должно выполняться.
• Нажмите ОК.