설명
id, 이름 또는 태그가 일치하는 모든 씬 엔티티에 메시지를 보냅니다. 그 스크립트는 onMessage로 받습니다.
정의
구문 · 1
EntitySend(entity string, message string) → integer구문 · 2
EntitySend(entity string, message string, dataJson string) → integer매개변수
| 이름 | 타입 | 해당 형식 | 의미 |
|---|---|---|---|
| entity | string | 전체 | 수신자의 id, 이름 또는 태그입니다. 일치하는 모든 엔티티가 메시지를 받습니다. |
| message | string | 전체 | 메시지 이름입니다. |
| dataJson | string | 2 | 메시지와 함께 보내는 선택적 데이터이며 JSON 텍스트입니다. 올바른 JSON이 아닌 텍스트는 일반 문자열로 보냅니다. |
반환값
integer
메시지를 받은 엔티티의 수입니다. 일치하는 것이 없으면 0입니다.
예제
이 예제는 시그니처를 바탕으로 생성되었습니다. 실행하기 전에 아래의 참고 사항과 필요한 리소스를 확인하세요.
형식 1: 짧은 형식
result = EntitySend("value", "hello")DO Print(result) Sync()LOOP형식 2: 모든 인수 포함
result = EntitySend("value", "hello", "{}")DO Print(result) Sync()LOOPEntitySend을(를) 시그니처가 요구하는 타입의 값으로 호출합니다. DO … LOOP는 장식이 아닙니다. 클래식 BASIC 프로그램은 줄이 끝나면 곧바로 종료되며, Sync()가 프레임을 그립니다.
참고 사항
- 일치하는 것이 없으면 이름마다 한 번씩 콘솔에 경고를 씁니다.