Smart Client betik dili ve sınırları
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 |
|---|---|---|
| Evet | Kök öğe. |
| Hayır | Dosya biçimi sürümü. Varsayılan ve geçerli sürüm: |
| Hayır | Oturum açma bilgisi. Bkz. Oturum açmayı betiklerle otomatikleştirin. |
| Hayır | Betik gövdesi. Oturum açma başına bir kez çalıştırılır. |
| 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 |
|---|---|
|
|
|
|
|
|
Desteklenen dil
Değişkenler | Ayrıntılar |
|---|---|
Değişkenler |
|
Koşullar |
|
Döngüler |
|
Operatörler |
|
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 |
|
Eylemler
Faaliyet Tipi | Söz dizimi | Notlar |
|---|---|---|
Tümleşik eylemler |
| Direkt metotlar Smart Client betik motoru (örneğin, Mevcut gruplar şunlardır |
Görünümler, çıkışlar, olaylar ve PTZ ön ayarları |
| Her Örnek: 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 |
| Her |
Kimliğe göre eylemler |
| 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 |
|---|---|
| Betiği donmadan duraklatır XProtect Smart Client. 0-30.000 ms kabul eder. |
| Bildirim alanında bir bildirim gösterir. Betik veya kullanıcı arayüzünü engellemez. |
| Tarih ve saat değerleri. Okuyabilirsiniz |
| Benzersiz tanımlayıcı işlemleri. |
| Buraya yazıyor |
| 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 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 |
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 |
|---|---|
| Her tamamlanan yapılandırma yeniden yüklendikten sonra, görünümler ve sekmeler yerleştikten sonra. İlk oturum açmada çalışmaz. |
| Herhangi bir pencerede farklı bir görünüm seçildikten sonra. |
| Herhangi bir pencerede farklı bir görüntü öğesi seçildikten sonra. |
| Seçilen sekme değiştikten sonra veya bir pencere Canlı ve Oynatma arasında geçiş yapar. NotAlarm 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 |
| 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 | Onun yerine kullan |
|---|---|
|
|
|
|
| Betiği doğrula... betiği dağıtmadan önce |
Koşullu operatör ( |
|
Önek artışı | Sonek artışı |
Dize enterpolasyonu |
|
Virgül ifadeleri, çok sayıda değişken bildirimler | Ayrı ifadeler |
Diziler, koleksiyon değişmezleri ve dizin oluşturma | Desteklenmiyor |
| Desteklenmiyor |
Yöntemler, sınıflar, arayüzler, ad alanları, | MIP eklentisi |
| Tümleşik komut dosyası eylemlerini veya MIP bir eklenti kullanın |
Zamanlayıcılar, |
|
Dosya, kayıt, ağ ve işlem erişimi, yansıtma | MIP eklentisi |