Skip to main content

XProtect Smart Client

Smart Client betik dili ve sınırları

Son güncelleme: 5 dakikalık okuma
Sürüm2026 R2
DilTürkçe

Smart Client betikler XML içinde sınırlı sayıda C# kullanırlar. Ne zaman XProtect Smart Client bir komut dosyası yükler, dosyayı izin verilen dil özellikleri ve eylemleri listesiyle karşılaştırır. Betiğin herhangi bir kısmı geçersizse, betik gövdesi ve olay tetikleyicileri çalışmaz; ancak, <Login> blok halen uygulanmaktadır.

Dosya yapısı

Dosyayı şununla kaydet: .scs uzantısı, UTF-8 olarak kodlandı. Ürün reçetesiz UTF-8 önerilir.

Öge

Gerekli

Açıklama

<ScriptEngine>

Evet

Kök öğe.

<SchemaVersion>

Hayır

Dosya biçimi sürümü. Varsayılan ve geçerli sürüm: 1. Bir dosya, yüklü olandan daha yeni bir sürüm bildirirse XProtect Smart Client destekliyor, dosya reddedildi.

<Login>

Hayır

Oturum açma bilgisi. Bkz. Oturum açmayı betiklerle otomatikleştirin.

<Script>

Hayır

Betik gövdesi. Oturum açma başına bir kez çalıştırılır.

<OnEvent Name="…">

Hayır

Olay tetikleyicisi. Bir dosyada olay başına bir tane olabilir.

Not

Eski ögeler, örneğin <ScriptExtension> ve herhangi biri <ScriptLanguage> (C# hariç, betik motoru tarafından reddedilir.)

Özel karakterler

XML okumaları <, >, ve & işaretleme olarak. Betik kodunu şuraya kaydır <![CDATA[ … ]]>, önerilir veya her karakteri XML varlığı ile değiştirin:

Karakter

Varlık

<

&lt;

>

&gt;

&

&amp;

Desteklenen dil

Değişkenler

Ayrıntılar

Değişkenler

var, dizeler, tamsayılar ve Boole değerleri (her ikisi de var ve aşağıdakiler gibi açık tipler int desteklenmektedir).

Koşullar

if, else if, else

Döngüler

for ve foreach, ile break ve continue. foreach yalnızca bir liste döndüren eylemlerde çalışır.

Operatörler

+,-,*,/,+=,-=, karşılaştırma operatörleri,&&,\|\|, ve sonek i++

Dizeler

Çift tırnaklar önerilir (tek tırnaklar motor tarafından kabul edilir, ancak bir uyarı oluşturur ve geçerli C# değildir). Dizeleri şununla birleştir +.

Yorumlar

// ve /* … */

Eylemler

Faaliyet Tipi

Söz dizimi

Notlar

Tümleşik eylemler

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

Direkt metotlar Smart Client betik motoru (örneğin, SCS.Application.Minimize();). Çoğu eylem argüman alır.

Mevcut gruplar şunlardır Application, Views, Browse, Camera, Ptz, MultiWindow, General, ve Keyboard.

Görünümler, çıkışlar, olaylar ve PTZ ön ayarları

SCS.Invoke("<name>");

Her <name> Kullanıcı arabiriminde gösterilen görünen ad değil. Şununla başlar Views.All., Outputs.All., Events.All.,veya Ptz.Presets.ardından noktalarla birleştirilen yapılandırılmış hiyerarşi adları gelir. Alfasayısal harf veya rakam dışındaki herhangi bir karakter alt çizgiye dönüştürülür (_).

Örnek: Views.All.Basic_User_Group.All_cameras_Group._10x10_All_cameras

Bu adlar, tüm istemci ekran dillerinde aynıdır. Aynı gruptaki iki öğe yalnızca özel karakterlere (Kam 1 ve Kam-1 gibi) göre farklılık gösteriyorsa, aynı tanımlayıcıyı oluştururlar ve yalnızca birine ulaşılabilir; çarpışmayı çözmek için öğelerden birini yeniden adlandırın.

Eklenti eylemlerini, ada göre MIP

SCS.Invoke("<name>");

Her <name> istemcinin eklentinin grupları ve eylemi için gösterdiği ve noktalarla birleştirilen ekran adlarından oluşur. Eklenti bu adları tanımladığından ve yerelleştirebildiğinden, bu form mevcut istemci diline bağlıdır. Birden fazla eylem aynı adı paylaşırsa, komut dizisi adı reddeder; bunun yerine eylemi kimliğiyle çağırın.

Kimliğe göre eylemler

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

Dilden bağımsız benzersiz tanımlayıcı. Yapılandırma öğelerini dahil et seçildiğinde, hem adlar hem de kimlikler oluşturulan komut dosyası referans dosyasında listelenir, böylece tam kimliği doğrudan komut dosyanıza kopyalayabilirsiniz.

Sisteminizde mevcut olan tüm eylemleri görmek için, bir betik referansı oluşturun.

Tümleşik işlevler

İşlev

Açıklama

Thread.Sleep(milliseconds)

Betiği donmadan duraklatır XProtect Smart Client. 0-30.000 ms kabul eder.

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

Bildirim alanında bir bildirim gösterir. Betik veya kullanıcı arayüzünü engellemez.

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

Tarih ve saat değerleri. Okuyabilirsiniz .Year, .Month, .Day, .Hour, .Minute ve .Second.

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

Benzersiz tanımlayıcı işlemleri. new Guid("<id as text>") tam olarak bir dize argümanı gerektirir.

SCS.Application.WriteLog(level, message)

Buraya yazıyor MIPLog.txt. Seviye: Info, Debug,veya Error.

SCS.Application.GetEventWindowId()

Bir olay tetikleyicisinde, olayın gerçekleştiği pencerenin kimliğini döndürür. Ana pencerenin, betik gövdesinin ve içinde boş metnini döndürür ConfigurationReloadCompleted.

Not: Bu işlev, katıştırılmış bir pencerenin kimliğini (bir sekmenin içindeki bir görüntü alanı gibi) geri getirebilir, ancak SCS.MultiWindow eylem tanır. Önce kimliği bilinen bağımsız pencere kimlikleriyle karşılaştırın veya tanınmayan pencere kimliklerini yok sayın.

Olay tetikleyicileri

Tanımla <OnEvent> bloklar içinde <ScriptEngine> kullanıcı eylemlerine ve çalışma alanı değişikliklerine tepki veren kök öğe.

Olay

Çalıştırmalar

ConfigurationReloadCompleted

Her tamamlanan yapılandırma yeniden yüklendikten sonra, görünümler ve sekmeler yerleştikten sonra. İlk oturum açmada çalışmaz.

SelectedViewChanged

Herhangi bir pencerede farklı bir görünüm seçildikten sonra.

SelectedViewItemChanged

Herhangi bir pencerede farklı bir görüntü öğesi seçildikten sonra.

ShownWorkSpaceChanged

Seçilen sekme değiştikten sonra veya bir pencere Canlı ve Oynatma arasında geçiş yapar.

Not

Alarm Yöneticisi ve Dışa Aktarmalar gibi bazı çalışma alanları kendi katıştırılmış görünüm alanlarını içerir. Her katıştırılmış görünüm alanı, bağımsız pencereye ait olmayan bir kimlik kullanarak oluşturulduğunu bildirir. Bu nedenle, bu sekmelerden birine geçme çalıştırılabilir ShownWorkSpaceChanged birden çok kez (örneğin, Alarm Yöneticisi iki katıştırılmış görünüm alanına sahiptir ve Dışa Aktarımlar bir taneye sahiptir, bu nedenle Alarm Yöneticisi'ne geçmek tetikleyiciyi üç defaya kadar çalıştırabilir). Betiğinizin tanınmayan pencere kimliklerini yoksayması gerekir.

  • Olay tetikleyicileri, komut dizisi gövdesiyle birlikte kontrol edilir. Bilinmeyen bir olay adı bir hatadır.

  • Olay tetikleyicileri betik gövdesi çalışmadan önce aktif hale gelir ve oturum kapatılana kadar aktif kalır.

  • Bir olay tetikleyicisi, kendi eylemleri tarafından yapılan bir değişiklikten dolayı tekrar çalışmaz.

  • Olay adları büyük/küçük harflere duyarlıdır.

  • Her olay türü en fazla bir defa betik içinde bildirilebilir.

  • Betik gövdesi tarafından başlatılan sekme değişikliklerini görüntüleyin veya (<Script>) ayrıca bu olayları tetikler.

Sınırlar

Limit

Değer

Çalıştırma başına ekstre sayısı

100,000

Çalıştırma başına çalıştırma süresi

30 saniye

Thread.Sleep çağrı başına

30 saniye

Olay tetikleyicisi başına çalıştırmalar

Dakikada 60. O dakikada daha fazla tur atlanıyor.

Döngü başına yinelemeler

10,000

Dize uzunluğu

65.536 karakter

Komut dizisi gövdesinin veya olay tetikleyicisinin her çalıştırmasının kendi sınırları vardır. Bir çalıştırma bir sınıra ulaşırsa veya bir eylem başarısız olursa, bu çalıştırmanın geri kalanı durur ve olay oturum açılır MIPLog.txt, ama XProtect Smart Client ve diğer olay tetikleyicileri çalışmaya devam eder. Oturumu kapattığınızda veya kapattığınızda XProtect Smart Client, çalışan tüm betikleri durdurur.

Desteklenmiyor

Desteklenmiyor

Onun yerine kullan

while, do/while

for

switch

if / else if

try/catch, throw

Betiği doğrula... betiği dağıtmadan önce

Koşullu operatör (?:)

if / else

Önek artışı (++i)

Sonek artışı (i++)

Dize enterpolasyonu ($"…")

+

Virgül ifadeleri, çok sayıda değişken bildirimler for

Ayrı ifadeler

Diziler, koleksiyon değişmezleri ve dizin oluşturma

Desteklenmiyor

%, *=, /=, %=, bitsel operatörler

Desteklenmiyor

Yöntemler, sınıflar, arayüzler, ad alanları, dynamic

MIP eklentisi

ScriptExtension

Tümleşik komut dosyası eylemlerini veya MIP bir eklenti kullanın

Zamanlayıcılar, Task, new Thread(), asyncdelegeler, lambdalar

Thread.Sleep veya olay tetikleyicileri

Dosya, kayıt, ağ ve işlem erişimi, yansıtma

MIP eklentisi