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>

لا

نص البرنامج النصي. يعمل مرة واحدة لكل تسجيل دخول.

<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> ليس هذا هو اسم العرض المعروض في واجهة المستخدم. يبدأ ب 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()

في مشغل الأحداث، ترجع الدالة VMS معرف النافذة التي وقع فيها الحدث. إرجاع نص فارغ للنافذة الرئيسية، في نص البرنامج النصي، وفي ConfigurationReloadCompleted.

ملاحظة: يمكن أن ترجع هذه الوظيفة معرف الإطار المضمن (مثل منطقة العرض داخل علامة تبويب) والذي يكون بلا SCS.MultiWindow الإجراء يتعرف. قارن المعرف بمعرفات النوافذ العائمة المعروفة أولا، أو تجاهل معرفات النوافذ غير المعروفة.

مشغلات الأحداث

تحديد <OnEvent> كتل داخل <ScriptEngine> عنصر جذر للرد على إجراءات المستخدم وتغييرات مساحة العمل.

الحدث

قيد التشغيل

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)

زيادة لاحقة (i++)

إدراج سلسلة ($"…")

+

تعبيرات الفاصلة، إقرارات المتغيرات المتعددة في for

بيانات منفصلة

المصفوفات، والمجموعات الحرفية، والفهرسة

غير مدعوم

%, *=, /=, %=، المشغلون النقطيون

غير مدعوم

الطرق، والفئات، والواجهات، ومساحات الأسماء، dynamic

مكون MIP الإضافي

ScriptExtension

استخدم إجراءات البرنامج النصي المدمج أو مكون MIP الإضافي

أجهزة ضبط الوقت، Task, new Thread(), async, مندوبين, لامدا

Thread.Sleep أو مشغلات الأحداث

الملف، والتسجيل، والشبكة، وعملية الوصول، والتفكير

مكون MIP الإضافي