Smart Client 스크립트 언어 및 제한
Smart Client 스크립트는 XML 내에서 제한된 C# 집합을 사용합니다. 시기 XProtect Smart Client 스크립트 파일을 로드하고 허용된 언어 기능 및 동작 목록과 비교하여 파일을 확인합니다. 스크립트의 일부가 유효하지 않은 경우, 스크립트 본문 및 이벤트 트리거가 실행되지 않지만, <Login> 차단이 여전히 적용됩니다.
파일 구조
파일을 다음과 함께 저장합니다. .scs 확장, UTF-8로 인코딩됩니다. BOM을 사용하지 않는 UTF-8을 권장합니다.
요소 | 필수 | 설명 |
|---|---|---|
| 예 | 루트 요소입니다. |
| 아니요 | 파일 형식 버전입니다. 기본 및 현재 버전은 다음과 같습니다 |
| 아니요 | 로그인 정보입니다. 스크립트로 로그인을 자동화합니다을(를) 참조하십시오. |
| 아니요 | 본문 스크립팅입니다. 로그인당 한 번 실행됩니다. |
| 아니요 | 이벤트 트리거입니다. 파일에는 이벤트당 하나가 포함될 수 있습니다. |
참고
다음과 같은 레거시 요소 <ScriptExtension> 및 모두 <ScriptLanguage> 스크립트 엔진에서 C# 이외의 항목을 거부했습니다.
특수 문자
XML 읽기 <, >, 및 & 마크업으로 선택합니다. 스크립트 코드를 래핑합니다. <![CDATA[ … ]]>를 사용하거나 각 문자를 해당 XML 엔터티로 대체합니다.
문자 | 엔터티 |
|---|---|
|
|
|
|
|
|
지원되는 언어
변수 | 세부 정보 |
|---|---|
변수 |
|
조건 |
|
루프 |
|
운영자 |
|
문자열 | 큰따옴표가 권장됩니다(큰따옴표는 엔진에서 허용되지만 경고가 생성되며 유효하지 않은 C#). 다음에서 문자열 조인 |
주석 |
|
동작
동작 유형 | 구문 | 메모 |
|---|---|---|
내장 동작 |
| 에서 직접 메서드를 제공합니다. Smart Client 스크립트 엔진(예: 사용 가능한 그룹은 다음과 같습니다 |
뷰, 출력, 이벤트 및 PTZ 프리셋 |
| 이(가) 다음을 수행합니다 예: 이러한 이름은 모든 클라이언트 표시 언어에서 동일합니다. 동일 그룹에 있는 두 항목이 특수 문자(예: 캠 1, 캠-1)에 의해서만 다를 경우, 동일한 식별자가 생성되며 한 항목만 연결할 수 있습니다. 충돌을 해결하려면 항목 중 하나의 이름을 바꾸십시오. |
이름으로 MIP 플러그인 동작 |
| 이(가) 다음을 수행합니다 |
ID별 동작 |
| 언어와 독립적인 고유 식별자입니다. 구성 항목 포함을 선택하면 생성된 스크립트 참조 파일에 이름과 ID 모두 나열되므로 정확한 ID를 스크립트에 직접 복사할 수 있습니다. |
시스템에서 사용 가능한 모든 동작을 보려면 스크립트 참조를 생성합니다.
내장 기능
기능 | 설명 |
|---|---|
| 동결 없이 스크립트를 일시 중지합니다 XProtect Smart Client. 0~30,000ms를 수락합니다. |
| 알림 영역에 알림을 표시합니다. 스크립트나 UI를 차단하지 않습니다. |
| 날짜 및 시간 값입니다. 다음을 읽을 수 있습니다. |
| 고유 식별자 작업입니다. |
| 다음에 씁니다. |
| 이벤트 트리거에서 이벤트가 발생한 창의 ID를 반환합니다. 기본 창, 스크립트 본문 및 다음에 대한 빈 텍스트를 반환합니다. 참고: 이 기능은 탭 내부의 뷰 영역과 같이 다음 사항이 없는 내장 창의 ID를 반환할 수 있습니다. |
이벤트 트리거
정의 <OnEvent> 내부 블록 <ScriptEngine> 사용자 작업 및 작업 공간 변경에 대응할 수 있는 루트 요소입니다.
이벤트 | 실행 |
|---|---|
| 각각의 완료된 구성 다시 로드 후 뷰와 탭이 설정되면 재로드됩니다. 첫 번째 로그인 시 실행되지 않습니다. |
| 다른 뷰를 선택한 후 아무 창에서나 볼 수 있습니다. |
| 다른 뷰 항목을 선택한 후 아무 창에서나 볼 수 있습니다. |
| 선택한 탭이 변경된 후 또는 창이 라이브 및 재생 사이에서 전환됩니다. 참고다음과 같은 일부 작업 공간입니다. 알람 관리자 및 내보내기에는 자체 포함된 뷰 영역이 포함됩니다. 각 내장된 뷰 영역은 부동 창에 속하지 않는 ID를 사용하여 생성된 내용을 보고합니다. 따라서 이러한 탭 중 하나로 전환할 수 있습니다 ShownWorkSpaceChanged 여러 번(예: 알람 관리자에는 두 개의 포함된 뷰 영역이 있고 내보내기에는 하나의 영역이 있으므로 알람 관리자로 전환하면 트리거를 최대 3회까지 실행할 수 있음)할 수 있습니다. 스크립트는 인식되지 않는 창 ID를 무시해야 합니다. |
이벤트 트리거는 스크립트 본문과 함께 확인됩니다. 알 수 없는 이벤트 이름은 오류입니다.
이벤트 트리거는 스크립트 본문이 실행되기 전에 활성화되며 로그아웃할 때까지 활성 상태로 유지됩니다.
자체 동작으로 변경한 이벤트 트리거가 다시 실행되지 않습니다.
이벤트 이름은 대소문자를 구분합니다.
각 이벤트 유형은 스크립트에서 한 번에 선언할 수 있습니다.
스크립트 본문()에 의해 시작된 뷰 또는 탭 변경 내용입니다
<Script>)에서 이러한 이벤트도 트리거합니다.
제한
제한 | 값 |
|---|---|
실행당 문 | 100,000 |
실행당 실행 시간 | 30초 |
| 30초 |
이벤트 트리거당 실행됩니다 | 분당 60개입니다. 해당 분 내의 추가 실행을 건너뜁니다. |
루프당 반복 | 10,000 |
문자열 길이 | 65,536자 |
스크립트 본문 또는 이벤트 트리거의 각 실행에는 자체 제한이 있습니다. 실행이 제한에 도달하거나 동작이 실패하면 나머지 실행이 중지되고 이벤트가 로그인됩니다 MIPLog.txt, 하지만 XProtect Smart Client 다른 이벤트 트리거가 계속 실행됩니다. 로그아웃하거나 닫을 때 XProtect Smart Client, 실행 중인 모든 스크립트를 중지합니다.
지원되지 않음 | 대신 사용하십시오 |
|---|---|
|
|
|
|
| 스크립트를 배포하기 전에 스크립트를 확인하십시오. |
조건 연산자( |
|
접두어 증가 | 접미사 증가 |
문자열 보간 |
|
쉼표 식, 다중 변수 선언 위치 | 별도의 문 |
배열, 컬렉션 리터럴 및 인덱싱 | 지원되지 않음 |
| 지원되지 않음 |
메서드, 클래스, 인터페이스, 네임스페이스, | MIP 플러그인 |
| 내장 스크립트 동작 또는 MIP 플러그인을 사용합니다 |
타이머, |
|
파일, 레지스트리, 네트워크 및 프로세스 액세스, 반사 | MIP 플러그인 |