Triggers

트리거는 스트림 이벤트에 기반을 둔 애플리케이션 액션을 자동화할 수 있습니다. X가 발생하면 Y를 수행합니다. 코드를 작성하지 않아도 - 트리거를 디스패치 시트에서 액션을 구성할 수 있습니다.

트리거 작동 방식

트리거에는 세 가지 부분이 있습니다:

1. 이벤트 — 트리거가 firing 할 때 발생하는 일 (채팅 메시지, 팔로우, 서브, etc.)
2. 조건 — 선택적 필터가 true가 되면 트리거가 진행되도록 하는 필터
3. 액션 — 트리거가 firing 할 때 발생하는 일

예를 들어: 채팅에서 50명 이상의 시청자가 raid를 하면 - raid 사운드를 재생 - raid GIF를 표시 - 채팅에 감사 메시지를 전송합니다.

트리거 이벤트

채팅 이벤트

• 메시지 전송 (키워드 또는 명령어에 매칭)
• TTS 메시지가队列에 대기 중
• 특정 명령어를 사용하는 사용자

스트림 이벤트

• 새로운 팔로워
• 새로운 구독 -리스트
• bulk gift -raid 수신 -_donation / tip 수신
• Superchat (YouTube)
• gift (TikTok)

수동 / 일정

• 디스패치 버튼 클릭 (수동으로 트리거를 firing 시킵니다)
• 타이머 (N 분 간격 동안 스트림 중)

조건

조건은 트리거가 firing 할 때 필터를 설정합니다:

• amount threshold — 예를 들어, 50명 이상의 시청자, $5 이상의 기부
• 메시지 contains — 채팅 메시지에 텍스트 또는 reg ex 매칭
• username matches — 특정 사용자 또는 패턴을 표적
• platform — 특정 플랫폼에서만 firing
• time of day — 특정 시간에 제한

다중 조건을 AND / OR 로 로직으로 결합할 수 있습니다.

액션

트리거가 firing 할 때, 하나 이상의 액션을 수행할 수 있습니다:

액션	설명
Play media	사운드, 이미지 또는 비디오를 재생합니다.
Send chat message	채팅에 텍스트를 전송합니다. {username}, {amount}, {message} 플래트ホ尔더를 지원합니다.
Run TTS	TTS 메시지 (queue 또는 queue에 대기하는 것을 bypass합니다).
Fire alert	오버레이에 알림을 표시합니다.
Switch Compositor preset	오버레이 레이아웃을 변경합니다.
Toggle widget	특정 위젯을 표시 또는 숨깁니다.
HTTP request	웹hook URL (POST와 이벤트 데이터를 호출합니다).

트리거의 액션은 시quence로 실행됩니다. 액션 간의 지연을 추가할 수 있습니다 (예: 2초 후에 채팅 메시지를 전송합니다).

트리거 만들기

1. 디스패치 시트에서 트리거를 열어Sidebar에 표시합니다.
2. New Trigger을 클릭합니다.
3. 이름을 입력합니다.
4. Event 타입을 선택합니다.
5. 필요하면 Conditions을 추가합니다.
6. 하나 이상의 Actions을 추가합니다.
7. 저장합니다.

트리거는 즉시 활성화됩니다. Test 버튼을 클릭하여 트리거가 작동하는지 확인합니다.

트리거 순서

다중 트리거가 동일한 이벤트를 매치할 때, 모든 트리거가 firing합니다. 만약 순서가 중요하다 (예를 들어, 사운드가 먼저 재생되어야 하는 경우), 단일 트리거의 액션 체인 내에서 지연을 사용하여 separate 트리거를 사용합니다.