VoiceChange novinky Obsah dokumentace Uživatelská dokumentace Administrátorská dokumentace Rejstřík pojmů Technická podpora Hledání on-line
Úvod do programování VoiceChange

Pokud nestačí základní funkčnost VoiceChange jako telefonního záznamníku, je třeba přistoupit k úpravě skriptů nebo napsání nových. Tento dokument je zde, aby Vás provedl programováním VoiceChange skriptů.

Obsah

Odlišnosti VoiceChange VBS skriptingu

Velká část VoiceChange knihoven je napsána ve Visual Basic Scriptu (dále VBS), ve formě skriptletů (soubory .WSC). Ty jsou zaregistrovány jako standardní COM objekty, které pak využívá uživatelský skript. Ten je díky COM velmi jednoduchý.

Knihovny se k uživatelskému kódu připojují tímto kódem
  
Dim VXScript : Set VXScript = CreateObject("VXScripting.VXScript") : Execute VXScript.InitCode
 

Tento řádek musí být ve vašem kódu VŽDY - může být kdekoliv MIMO uživatelské funkce. Standardně je umístěn na konci skriptu.

zpět na začátek

Základní struktura VoiceChange skriptu

Uživatelský skript musí implementovat čtyři základní funkce:

Uživatelská funkce OnInit

Funkce OnInit je volána při inicializaci systému. Je určena např. pro nainicializování databázového spojení či podobné akce.

Funkce OnInit nemusí implementovat žádnou činnost -- veškerá inicializace VoiceChange již proběhla před jejím zavoláním.

Uživatelská funkce OnRing

Funkce OnRing je volána při příchozím volání. Při jejím zavolání je telefon ještě zavěšený; úkolem této funkce je buď telefon zvednout a obsloužit volání, nebo vykonat jinou činnost - např. vyvoláním služeb TAPI hovor přesměrovat.

Pokud se funkce OnRing vrátí bez obsloužení volání, bude při dalším zazvonění vyvolána znovu.

Uživatelská funkce OnIddle

Funkce OnIddle Funkce OnIddle je volána tehdy, když se neprovádí žádná jiná činnost (tj. nepřichází žádný hovor a nejsou ani jiné úkoly). Nemusí vykonat žádnou činnost; může však provést například odchozí volání.

Uživatelská funkce OnShutdown

Funkce OnShutdown je volána při ukončení činnosti skriptu. Je určena např. pro uzavření databázových spojení. Nemusí vykonat žádnou činnost.

zpět na začátek

Nástroje, které jsou k dispozici

Uživatelský skript má k dispozici mnoho funkcí a tříd VoiceChange VBS knihoven. Jejich kompletní dokumentaci můžete nalézt zde.

Z uživatelského skriptu je též možnost volat přímo funkce jádra VoiceChange pomocí VoiceChange COM objektů. Toto je ale nedoporučované a není zaručena funkčnost v příštích verzích VoiceChange. Dokumentaci k COM objektům najdete zde.

zpět na začátek

Adresářová struktura

Adresářová struktura VoiceChange z hlediska skriptingu je následující:

zpět na začátek

Podpora pro více jazyků

VoiceChange byla navržena pro snadné použití ve vícejazyčném prostředí. Všechny WAV soubory by měly být v adresářích určených svým jazykem:

common/wav/cze/ - české
common/wav/eng/ - anglické

a tak dále. Při přehrávání WAVů ve skriptu pak VoiceChange vybírá správný WAV podle nastavení property VXScript.Locale. Pokud není WAV v požadovaném jazyce k dispozici, použije se z adresáře defaultního jazyka (zadaného při instalaci, uloženo v souboru common.ini.

Jazykově závislé činnosti (přehrání datumu, počtu zpráv) byly odseparovány do jazykových modulů v adresáři VoiceChange/_vbs_language/. Při implementaci nového jazyka je potřeba pro něj tyto funkce dopsat.

zpět na začátek