시험 제어 명령

!01: 스크립트 그룹 수행

Aurora Script Editor로 생성한 스크립트 그룹을 순서대로 수행합니다.

Aurora Script Editor로 생성한 스크립트 그룹을 수행하기 위한 명령입니다. 입력된 정보 순서대로, 생성된 스크립트 그룹이 순차적으로 수행됩니다.

요청 (클라이언트 → 서버)

형식
!01:Group1Value,Group2Value,...\0
CommandData
!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가 서브 키워드 변수에 등록되어 있지 않음(응답의 값은 소문자로 바뀌어 표시됨). 에러 코드 참고.

관련 명령