====== 사용자 액션 그룹 (User Action Group) ======

사용자 액션 그룹은 사용자가 자주 사용하는 여러 개의 액션을 하나의 묶음으로 정의하여 관리하는 기능입니다. 

프로그래밍의 '사용자 정의 함수(User-Defined Function)'와 유사한 개념으로, 복잡한 동작을 체계적으로 구조화할 수 있습니다.

{{ :comfilestudio:user_action_group:addactionkor2.mp4?800x500 |사용자 액션 그룹 생성 과정}}

아래 예시에서는 **<변수초기화>**라는 이름의 그룹에 3개의 세부 액션을 포함하여 구성하였습니다. 

{{ :comfilestudio:user_action_group:act8.png?nolink |사용자 액션 그룹 구성 예시}}

====== 호출 및 실행 ======

사용자 액션 그룹은 독립적으로 실행되지 않으며, 특정 트리거에 의해 호출될 때 동작합니다. 

  * **호출 가능 위치**: <멀티액션 버튼>, <전역 이벤트>, <화면 이벤트>, <숫자 입력기> 등
  * **호출 방법**: 액션 목록에서 **<사용자 액션 그룹 실행>** 액션을 추가한 뒤, 미리 정의한 그룹을 선택합니다.

{{ :comfilestudio:user_action_group:act6.png?nolink |사용자 액션 그룹 실행 액션 설정}}

**주의사항**: **재귀 호출(Recursive Call)**은 지원하지 않습니다. (액션 그룹 내부에서 자기 자신을 다시 호출하는 설정 불가)

===== 고급 옵션 (반복 실행) =====

고급 옵션을 활성화하면 사용자 액션 그룹을 지정된 규칙에 따라 반복적으로 실행할 수 있습니다.

  * **반복 횟수**: 특정 횟수만큼 반복하거나 무한 반복하도록 설정 가능합니다.
  * **첫 실행까지의 대기 시간**: 액션이 호출된 시점부터 최초 실행 전까지의 지연 시간(ms)입니다.
  * **첫 실행 후 실행 간 대기 시간**: 반복 실행 시 각 액션 그룹 실행 사이의 간격(ms)입니다.

{{ :comfilestudio:user_action_group:act7.png?nolink |반복 및 대기 시간 설정 화면}}

===== 사용자 액션 그룹 반복 중지 =====

무한 반복 또는 장기 반복 중인 액션 그룹을 강제로 멈추려면 **<사용자 액션 그룹 반복 중지>** 액션을 사용해야 합니다.

  * 이 액션은 별도의 <이벤트>나 <멀티 액션 버튼> 등에 배치하여 사용자가 필요할 때 실행하도록 구성합니다.

{{ :comfilestudio:user_action_group:act4.png?nolink |반복 중지 액션 설정}}

===== 활용 예시 (반복 증감 등) =====

{{ :comfilestudio:user_action_group:numincvideo.mp4?1000x500 |사용자 액션 그룹을 활용한 수치 반복 증감 예시}}

----
키워드: 사용자 액션 그룹, 유저 함수, 액션 묶음, 반복 실행, 액션 루프, 반복 중지, Comfile Studio 액션

[[comfilestudio:index#액션|상위 페이지로 가기]]