Skip to main content

XProtect Smart Client

Smart Client שפת סקריפט ומגבלות

עדכון אחרון: 5 דקות קריאה
גרסה2026 R2
שפהעברית

Smart Client סקריפטים משתמשים בקבוצה מוגבלת של C# בתוך XML. כאשר XProtect Smart Client טוען קובץ סקריפט, הוא בודק את הקובץ מול רשימה של תכונות שפה ופעולות מותרות. אם חלק כלשהו של הסקריפט אינו חוקי, גוף הסקריפט ומפעילי האירועים לא יפעלו; עם זאת, המאפיין <Login> החסימה עדיין מוחלת.

מבנה הקובץ

שמור את הקובץ עם .scs הרחבה, מקודדת כ- UTF-8. UTF-8 ללא BOM מומלץ.

רכיב

חובה

תיאור

<ScriptEngine>

כן

רכיב בסיס.

<SchemaVersion>

לא

גירסת תבנית קובץ. גרסת ברירת המחדל והגירסה הנוכחית הן 1. אם קובץ מצהיר על גרסה חדשה יותר מהגרסה המותקנת XProtect Smart Client תומך, הקובץ נדחה.

<Login>

לא

פרטי התחברות. ראה כניסה אוטומטית עם סקריפטים.

<Script>

לא

גוף ה־ Script. פועל פעם אחת לכל כניסה.

<OnEvent Name="…">

לא

גורם מפעיל של אירוע. קובץ יכול לכלול קובץ אחד לכל אירוע.

שים לב

אלמנטים מדור קודם כגון <ScriptExtension> וכל <ScriptLanguage> מנוע הסקריפט מסרב לאשר פעולות אחרות פרט ל־ C#.)

תווים מיוחדים

קריאות XML <, >,וגם & כסימון. גלישה של קוד סקריפט ב- <![CDATA[ … ]]>, מומלץ, או החלף כל תו ביישות ה-XML שלו:

תו

היישות

<

&lt;

>

&gt;

&

&amp;

שפה נתמכת

משתנים

פרטים

משתנים

var, מחרוזות, מספרים שלמים וערכים בוליאניים (שניהם var וסוגים מפורשים כגון int לא נתמך).

תנאים

if, else if, else

לולאות

for וגם foreach, עם break וגם continue. foreach פועל רק בפעולות המחזירות רשימה.

מפעילים

+,-,*,/,+=,-=, אופרטורים להשוואה,&&,\|\|, ו postfix i++

מחרוזות

מומלץ להשתמש בגרשיים כפולים (גרשיים בודדים מתקבלים על ידי המנוע אך יוצרים אזהרה ואינם תקפים C#). צרף מחרוזות עם +.

הערות

// וגם /* … */

פעולות

סוג פעולה

תחביר

פתקים

פעולות מובנות

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

שיטות ישירות שמספקת Smart Client script engine (לדוגמה, SCS.Application.Minimize();). רוב הפעולות דורשות טיעונים.

הקבוצות הזמינות הן Application, Views, Browse, Camera, Ptz, MultiWindow, General,וגם Keyboard.

תצוגות, יציאות, אירועים ו-PTZ קבועים מראש

SCS.Invoke("<name>");

ה <name> אינו שם התצוגה המוצג בממשק המשתמש. זה מתחיל עם Views.All., Outputs.All., Events.All.,לחלופין Ptz.Presets., ואחריו שמות ההירארכיה המוגדרים, המצורפים לנקודות. כל תו שאינו אות או ספרה אלפאנומריים מומר למקף תחתון (_).

דוגמה: Views.All.Basic_User_Group.All_cameras_Group._10x10_All_cameras

שמות אלה זהים בכל שפות התצוגה של הלקוח. אם שני פריטים באותה קבוצה נבדלים זה מזה רק בתווים מיוחדים (כגון Cam 1 ו- Cam-1), הם יוצרים את אותו מזהה, וניתן להגיע רק לאחד מהם; שנה את השם של אחד הפריטים כדי לפתור את ההתנגשות.

MIP פעולות תוסף, לפי שם

SCS.Invoke("<name>");

ה <name> מורכב משמות התצוגה שהלקוח מציג לקבוצות ולפעולה של התוסף, אליהם מצטרפות נקודות. מכיוון שהתוסף מגדיר ויכול לתרגם שמות אלה, טופס זה תלוי בשפת הלקוח הנוכחית. אם מספר פעולות חולקות את אותו שם, מנוע הסקריפט מסרב לקבל את השם; במקום זאת, קרא לפעולה לפי המזהה שלה.

פעולות לפי מזהה

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

מזהה ייחודי שאינו תלוי בשפה. שני השמות והמזהים מפורטים בקובץ ההפניה של הסקריפט שנוצר בשעת סימון האפשרות 'כלול פריטי תצורה׳, המאפשרת להעתיק את המזהה המדויק ישירות לסקריפט.

כדי לראות את כל הפעולות הזמינות במערכת, צור הפניה לסקריפט.

פונקציות מובנות

פונקציה

תיאור

Thread.Sleep(milliseconds)

השהיית הסקריפט ללא קיפאון XProtect Smart Client. מקבל 0-30,000 מילישניות.

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

הצגת הודעה באזור ההודעות. הוא לא חוסם את הסקריפט או את ממשק המשתמש.

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()

בגורם מפעיל של אירוע, החזרת מזהה החלון שבו התרחש האירוע. מחזיר טקסט ריק עבור החלון הראשי, בגוף הסקריפט וב ConfigurationReloadCompleted.

הערה: פונקציה זו יכולה להחזיר את הזיהוי של חלון מוטבע (כגון אזור תצוגה בתוך כרטיסיה) אשר לא SCS.MultiWindow הפעולה מזוהה. השווה תחילה את המזהה למזהים ידועים של חלונות צפים, או התעלם ממזהים לא מזוהים של חלונות.

גורמי אירוע

הגדר <OnEvent> בלוקים בתוך <ScriptEngine> רכיב בסיס ל- react לפעולות משתמש ולשינויים בסביבת העבודה.

אירוע

ריצות

ConfigurationReloadCompleted

לאחר כל טעינה מחדש של התצורה שהושלמה, לאחר שהתצוגות והלשוניות יסתדרו. לא מופעל בכניסה הראשונה.

SelectedViewChanged

לאחר בחירת תצוגה אחרת, בכל חלון.

SelectedViewItemChanged

לאחר בחירת פריט תצוגה אחר, בכל חלון.

ShownWorkSpaceChanged

לאחר שהלשונית שנבחרה משתנה, או חלון עובר בין שידור חי להצגת הקלטות.

שים לב

סביבות עבודה מסוימות, כגון מנהל ההתראות ו- פעולות יצוא, מכילות אזורי תצוגה מוטבעים משלהן. כל אזור תצוגה מוטבע מדווח על יצירתו באמצעות מזהה שאינו שייך לחלון צף. מעבר לאחת מהכרטיסיות האלה יכול אפוא לפעול ShownWorkSpaceChanged מספר פעמים (לדוגמה, מנהל ההתראות כולל שני אזורי תצוגה מוטבעים ו פעולות ייצוא יש אחד כזה, לכן מעבר אל מנהל ההתראות ניתן להפעיל את ההדק עד שלוש פעמים). על הסקריפט להתעלם מזהי חלונות לא מזוהים.

  • מפעילי אירועים נבדקים יחד עם גוף הסקריפט. שם אירוע לא ידוע הוא שגיאה.

  • מפעילי אירועים הופכים לפעילים לפני שגוף הסקריפט מופעל ונשארים פעילים עד היציאה מהמערכת.

  • גורם מפעיל של אירוע אינו פועל שוב עקב שינוי שבוצע על-ידי הפעולות שלו עצמו.

  • שמות אירועים הם תלויי רישיות.

  • ניתן להצהיר על כל סוג אירוע פעם אחת לכל היותר בסקריפט.

  • שינויים בתצוגה או בכרטיסייה שגוף הסקריפט יזם (<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)

תוספת Postfix (i++)

אינטרפולציה של מחרוזת ($"…")

+

ביטויי פסיק, הצהרות על משתנים מרובים ב- for

הצהרות נפרדות

מערכים, ליטרלי איסוף ויצירת אינדקס

לא נתמך

%, *=, /=, %=, אופרטורים לפי סיביות

לא נתמך

שיטות, סיווגים, ממשקים, מרחבי שמות, dynamic

תוסף MIP

ScriptExtension

השתמש בפעולות סקריפט מובנות או בתוסף MIP

קוצבי זמן, Task, new Thread(), async, נציגים, למבות

Thread.Sleep או גורמים מפעילים של אירועים

קובץ, רישום, גישה לרשת ולתהליך, השתקפות

תוסף MIP