Skip to main content

XProtect Smart Client

Smart Client 스크립트 언어 및 제한

마지막 업데이트: 5분 동안 읽음
버전2026 R2
언어한국어

Smart Client 스크립트는 XML 내에서 제한된 C# 집합을 사용합니다. 시기 XProtect Smart Client 스크립트 파일을 로드하고 허용된 언어 기능 및 동작 목록과 비교하여 파일을 확인합니다. 스크립트의 일부가 유효하지 않은 경우, 스크립트 본문 및 이벤트 트리거가 실행되지 않지만, <Login> 차단이 여전히 적용됩니다.

파일 구조

파일을 다음과 함께 저장합니다. .scs 확장, UTF-8로 인코딩됩니다. BOM을 사용하지 않는 UTF-8을 권장합니다.

요소

필수

설명

<ScriptEngine>

예

루트 요소입니다.

<SchemaVersion>

아니요

파일 형식 버전입니다. 기본 및 현재 버전은 다음과 같습니다 1. 파일이 설치된 버전보다 최신 버전을 선언하는 경우 XProtect Smart Client 지원되지 않습니다.

<Login>

아니요

로그인 정보입니다. 스크립트로 로그인을 자동화합니다을(를) 참조하십시오.

<Script>

아니요

본문 스크립팅입니다. 로그인당 한 번 실행됩니다.

<OnEvent Name="…">

아니요

이벤트 트리거입니다. 파일에는 이벤트당 하나가 포함될 수 있습니다.

참고

다음과 같은 레거시 요소 <ScriptExtension> 및 모두 <ScriptLanguage> 스크립트 엔진에서 C# 이외의 항목을 거부했습니다.

특수 문자

XML 읽기 <, >, 및 & 마크업으로 선택합니다. 스크립트 코드를 래핑합니다. <![CDATA[ … ]]>를 사용하거나 각 문자를 해당 XML 엔터티로 대체합니다.

문자

엔터티

<

&lt;

>

&gt;

&

&amp;

지원되는 언어

변수

세부 정보

변수

var, 문자열, 정수 및 부울 값(둘 다)입니다 var 및 명시적 유형(예: int 지원)됩니다.

조건

if, else if, else

루프

for 및 foreach, 포함 break 및 continue. foreach 목록을 반환하는 동작에서만 작동합니다.

운영자

+,-,*,/,+=,-=, 비교 작업자,&&,\|\|, 및 접미사 i++

문자열

큰따옴표가 권장됩니다(큰따옴표는 엔진에서 허용되지만 경고가 생성되며 유효하지 않은 C#). 다음에서 문자열 조인 +.

주석

// 및 /* … */

동작

동작 유형

구문

메모

내장 동작

SCS.<Group>.<Action>(<arguments>);

에서 직접 메서드를 제공합니다. Smart Client 스크립트 엔진(예: SCS.Application.Minimize();). 대부분의 동작에는 인수를 사용합니다.

사용 가능한 그룹은 다음과 같습니다 Application, Views, Browse, Camera, Ptz, MultiWindow, General, 및 Keyboard.

뷰, 출력, 이벤트 및 PTZ 프리셋

SCS.Invoke("<name>");

이(가) 다음을 수행합니다 <name> 은(는) UI에 표시된 표시 이름이 아닙니다. 다음으로 시작합니다. Views.All., Outputs.All., Events.All.또는 Ptz.Presets.을 클릭한 다음 점으로 연결된 구성된 계층 이름이 나옵니다. 영숫자 문자 또는 숫자 이외의 모든 문자는 밑줄()로 변환됩니다._).

예: Views.All.Basic_User_Group.All_cameras_Group._10x10_All_cameras

이러한 이름은 모든 클라이언트 표시 언어에서 동일합니다. 동일 그룹에 있는 두 항목이 특수 문자(예: 캠 1, 캠-1)에 의해서만 다를 경우, 동일한 식별자가 생성되며 한 항목만 연결할 수 있습니다. 충돌을 해결하려면 항목 중 하나의 이름을 바꾸십시오.

이름으로 MIP 플러그인 동작

SCS.Invoke("<name>");

이(가) 다음을 수행합니다 <name> 클라이언트가 플러그 인의 그룹 및 동작에 대해 점으로 연결된 표시 이름으로 구성됩니다. 플러그인이 이러한 이름을 정의하고 현지화할 수 있기 때문에 이 양식은 현재 클라이언트 언어에 따라 다릅니다. 여러 동작이 동일한 이름을 공유하는 경우, 스크립트 엔진이 이 이름을 거부합니다. 대신 해당 ID로 동작을 호출합니다.

ID별 동작

SCS.Invoke("<action-id>");

언어와 독립적인 고유 식별자입니다. 구성 항목 포함을 선택하면 생성된 스크립트 참조 파일에 이름과 ID 모두 나열되므로 정확한 ID를 스크립트에 직접 복사할 수 있습니다.

시스템에서 사용 가능한 모든 동작을 보려면 스크립트 참조를 생성합니다.

내장 기능

기능

설명

Thread.Sleep(milliseconds)

동결 없이 스크립트를 일시 중지합니다 XProtect Smart Client. 0~30,000ms를 수락합니다.

MessageBox.Show(message), MessageBox.Show(message, caption)

알림 영역에 알림을 표시합니다. 스크립트나 UI를 차단하지 않습니다.

DateTime.Now, DateTime.Today, DateTime.Parse(), new DateTime(…)

날짜 및 시간 값입니다. 다음을 읽을 수 있습니다. .Year, .Month, .Day, .Hour, .Minute 및 .Second.

Guid.Empty, Guid.Parse(), new Guid("<id as text>")

고유 식별자 작업입니다. new Guid("<id as text>") 정확히 하나의 문자열 인수가 필요합니다.

SCS.Application.WriteLog(level, message)

다음에 씁니다. MIPLog.txt. 수준은 다음과 같습니다. Info, Debug또는 Error.

SCS.Application.GetEventWindowId()

이벤트 트리거에서 이벤트가 발생한 창의 ID를 반환합니다. 기본 창, 스크립트 본문 및 다음에 대한 빈 텍스트를 반환합니다. ConfigurationReloadCompleted.

참고: 이 기능은 탭 내부의 뷰 영역과 같이 다음 사항이 없는 내장 창의 ID를 반환할 수 있습니다. SCS.MultiWindow 동작이 인식됩니다. 먼저 ID를 알려진 부동 창 ID와 비교하거나 인식되지 않는 창 ID를 무시합니다.

이벤트 트리거

정의 <OnEvent> 내부 블록 <ScriptEngine> 사용자 작업 및 작업 공간 변경에 대응할 수 있는 루트 요소입니다.

이벤트

실행

ConfigurationReloadCompleted

각각의 완료된 구성 다시 로드 후 뷰와 탭이 설정되면 재로드됩니다. 첫 번째 로그인 시 실행되지 않습니다.

SelectedViewChanged

다른 뷰를 선택한 후 아무 창에서나 볼 수 있습니다.

SelectedViewItemChanged

다른 뷰 항목을 선택한 후 아무 창에서나 볼 수 있습니다.

ShownWorkSpaceChanged

선택한 탭이 변경된 후 또는 창이 라이브 및 재생 사이에서 전환됩니다.

참고

다음과 같은 일부 작업 공간입니다. 알람 관리자 및 내보내기에는 자체 포함된 뷰 영역이 포함됩니다. 각 내장된 뷰 영역은 부동 창에 속하지 않는 ID를 사용하여 생성된 내용을 보고합니다. 따라서 이러한 탭 중 하나로 전환할 수 있습니다 ShownWorkSpaceChanged 여러 번(예: 알람 관리자에는 두 개의 포함된 뷰 영역이 있고 내보내기에는 하나의 영역이 있으므로 알람 관리자로 전환하면 트리거를 최대 3회까지 실행할 수 있음)할 수 있습니다. 스크립트는 인식되지 않는 창 ID를 무시해야 합니다.

  • 이벤트 트리거는 스크립트 본문과 함께 확인됩니다. 알 수 없는 이벤트 이름은 오류입니다.

  • 이벤트 트리거는 스크립트 본문이 실행되기 전에 활성화되며 로그아웃할 때까지 활성 상태로 유지됩니다.

  • 자체 동작으로 변경한 이벤트 트리거가 다시 실행되지 않습니다.

  • 이벤트 이름은 대소문자를 구분합니다.

  • 각 이벤트 유형은 스크립트에서 한 번에 선언할 수 있습니다.

  • 스크립트 본문()에 의해 시작된 뷰 또는 탭 변경 내용입니다<Script>)에서 이러한 이벤트도 트리거합니다.

제한

제한

값

실행당 문

100,000

실행당 실행 시간

30초

Thread.Sleep 호출당

30초

이벤트 트리거당 실행됩니다

분당 60개입니다. 해당 분 내의 추가 실행을 건너뜁니다.

루프당 반복

10,000

문자열 길이

65,536자

스크립트 본문 또는 이벤트 트리거의 각 실행에는 자체 제한이 있습니다. 실행이 제한에 도달하거나 동작이 실패하면 나머지 실행이 중지되고 이벤트가 로그인됩니다 MIPLog.txt, 하지만 XProtect Smart Client 다른 이벤트 트리거가 계속 실행됩니다. 로그아웃하거나 닫을 때 XProtect Smart Client, 실행 중인 모든 스크립트를 중지합니다.

지원되지 않음

지원되지 않음

대신 사용하십시오

while, do/while

for

switch

if / else if

try/catch, throw

스크립트를 배포하기 전에 스크립트를 확인하십시오.

조건 연산자(?:)

if / else

접두어 증가 (++i)

접미사 증가 (i++)

문자열 보간 ($"…")

+

쉼표 식, 다중 변수 선언 위치 for

별도의 문

배열, 컬렉션 리터럴 및 인덱싱

지원되지 않음

%, *=, /=, %=, 비트 연산자

지원되지 않음

메서드, 클래스, 인터페이스, 네임스페이스, dynamic

MIP 플러그인

ScriptExtension

내장 스크립트 동작 또는 MIP 플러그인을 사용합니다

타이머, Task, new Thread(), async, 대리인, 람다

Thread.Sleep 또는 이벤트 트리거

파일, 레지스트리, 네트워크 및 프로세스 액세스, 반사

MIP 플러그인