!01: 스크립트 그룹 수행
Aurora Script Editor로 생성한 스크립트 그룹을 순서대로 수행합니다.
Aurora Script Editor로 생성한 스크립트 그룹을 수행하기 위한 명령입니다. 입력된 정보 순서대로, 생성된 스크립트 그룹이 순차적으로 수행됩니다.
요청 (클라이언트 → 서버)
형식
!01:Group1Value,Group2Value,...\0| Command | Data |
|---|---|
!01: | ScriptGroup1Value, ScriptGroup2Value, … (콤마 구분) |
동작 규칙:
- 전달된 값은 순서대로 각 스크립트 그룹 변수(예:
mInfoSSGroupA,mInfoSSGroupB)에 저장됩니다. - 생성된 스크립트 그룹보다 많은 항목이 전달되면, 대응 스크립트가 없는 값은 무시됩니다.
- 생성된 스크립트 그룹보다 적은 항목이 전달되면, 입력된 항목 수만큼만 수행됩니다.
- 데이터의 대/소문자는 구별하지 않습니다.
- 값 안에 쉼표가 필요하면
\,로 씁니다.\,는 그룹 구분이 아니라 그 그룹 값의 일부가 되어, 그룹 변수에는2.4G,5G처럼 들어가고 그룹이 실행될 때 인수 구분(mArg1=2.4G,mArg2=5G)으로 쓰입니다. 인수 하나 안에 쉼표 문자를 넣으려면\\,로 씁니다. 그 밖의 역슬래시(경로 등)는 그대로 전달됩니다.
Player에서는 이 명령을 수신하면 Standby 슬롯 → 전달된 Protocol 항목들 → Ready 슬롯 순서로 스크립트 그룹이 실행됩니다. 항목 순서와 데이터 인덱스의 매핑은 문서 작성 (.playing)을 참고하세요.
응답 (서버 → 클라이언트)
응답
!99:1데이터 수신 및 처리 결과. 0 실패 · 1 성공 · <0 에러.수행이 완료되면 서버가 별도로 !91:을 보내 계측 시작을 알립니다.
예제
예제
→ !01:0,2.4G,11b,HT20,TX,long,
← !99:1
← !91:1 (스크립트 그룹 수행 완료 — 계측 시작)
그룹 값 안의 쉼표
→ !01:0,2.4G\,5G,11b
2번째 그룹 변수에 2.4G,5G가 저장되고, 그 그룹에서는 [mArg1] = 2.4G, [mArg2] = 5G, [mArgCount] = 2입니다.
잘못된 값이 포함되면 !99:-4 와 함께 인덱스, 값 이 반환됩니다. 예: !99:-4 2,5.2g → 2번째 값 5.2G가 서브 키워드 변수에 등록되어 있지 않음(응답의 값은 소문자로 바뀌어 표시됨). 에러 코드 참고.
관련 명령