스크립트 실행 액션 설명서
이 문서는 스크립트 또는 사용자 정의 함수를 호출하는 데 사용되는 Execute Script 액션에 대해 설명합니다. 일반적으로 이 액션은 레거시 지원을 위해 사용되며, 현재 또는 새로운 프로젝트에서는 사용하지 않는 것이 좋습니다. 이 액션을 사용하기 위해서는 호출할 스크립트 자산이나 사용자 정의 함수 변수 이름을 제공하고, 필요한 인수(문자열, 정수, 리소스 인덱스 등)를 입력해야 합니다. 필요에 따라 '플러스' 아이콘을 클릭하여 추가 인수를 추가할 수 있습니다.
일부 스크립트와 사용자 정의 함수는 나중에 사용할 수 있도록 값을 반환할 수 있으며, 반환 값을 저장할 대상 변수를 지정할 수 있습니다. 이 대상 변수는 미리 생성된 것이거나 "Temp" 체크박스를 체크하면 새로운 임시 로컬 변수로 생성할 수 있습니다. 필요한 경우 대상 및 인수 필드는 비워둘 수 있습니다.
일반적으로는 사용자 정의 함수를 호출할 때 Function Call 액션을 사용하는 것이 더 낫고, 이 액션을 직접 사용하거나 스크립트 자산을 코드로 직접 호출할 필요는 없습니다.
액션 구문:
| 인수 | 설명 |
|---|---|
| Script | 호출할 스크립트 또는 사용자 정의 함수의 이름 |
| Argument0 | 스크립트 또는 함수에 전달될 첫 번째 인수 |
| Argument1 | 스크립트 또는 함수에 전달될 두 번째 인수 |
| Argument2 | 스크립트 또는 함수에 전달될 세 번째 인수 |
| Argument3 | 스크립트 또는 함수에 전달될 네 번째 인수 |
| Target | 반환된 값을 저장할 변수의 이름 |
예제
아래 액션 블록 코드는 사용자 정의 함수를 호출하고, 방 내의 무작위 위치에 대한 두 개의 인수를 전달합니다. 이 함수는 아무것도 반환하지 않습니다.
// 사용자 정의 함수 호출
Execute Script("randomPositionFunction", player.x, player.y);
추가 활용 및 응용 예제
1. 스크립트 호출과 반환 값 저장
아래 예제는 스크립트를 호출하고 반환된 값을 특정 변수에 저장합니다.
// 결과를 저장할 변수
var result;
// 사용자 정의 함수 호출 및 반환 값 저장
Execute Script("calculateScore", player.level, player.time, result);
2. 인수 없이 스크립트 호출
인수가 필요 없는 경우에도 스크립트를 호출할 수 있습니다.
// 초기화 스크립트 호출
Execute Script("initializeGame");
주의사항
- 이 액션보다
Function Call을 사용하는 것이 바람직합니다. - 스크립트 자산을 직접 호출하는 것은 권장되지 않습니다.
이 문서는 전반적인 Execute Script 액션 사용법을 간단히 설명했습니다. 실제 프로젝트에서는 이 액션이 필요한 경우를 신중하게 고려해야 합니다.