scripting
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revision | Next revisionBoth sides next revision | ||
scripting [2020/07/10 09:33] – tondose | scripting [2020/07/10 10:09] – tondose | ||
---|---|---|---|
Line 5: | Line 5: | ||
To meet user-specified tasks, mAirList is offering a powerful scripting engine which provides extended control functions. With it, users may write their own programmes and expand mAirList’s functionalities significantly. | To meet user-specified tasks, mAirList is offering a powerful scripting engine which provides extended control functions. With it, users may write their own programmes and expand mAirList’s functionalities significantly. | ||
- | The code resembles a subset of the // | + | The code resembles a subset of the // |
**Note:** The full set of functions and procedures is featured only in the latest version of mAirList. Therefore, unaltered scripts originating from well-aged portions of the [[https:// | **Note:** The full set of functions and procedures is featured only in the latest version of mAirList. Therefore, unaltered scripts originating from well-aged portions of the [[https:// | ||
Line 64: | Line 64: | ||
**Comments** may be typed into '' | **Comments** may be typed into '' | ||
- | It is highly recommended to structure the code by indenting the statements with two whitespaces at a time. [[https:// | + | It is highly recommended to structure the code by indenting the statements with two whitespaces at a time. [[https:// |
+ | ==== Background Scripts ==== | ||
+ | |||
+ | As mAirlist is calling // | ||
+ | |||
+ | <code delphi> | ||
+ | begin | ||
+ | end. | ||
+ | </ | ||
+ | |||
+ | ('' | ||
+ | |||
+ | === Parameters === | ||
+ | |||
+ | Certain background script procedures are passing parameters. These can be used as variables within the procedure’s code as such: | ||
+ | |||
+ | <code delphi> | ||
+ | // This code writes the item’s title into the System Log whenever a player is started | ||
+ | |||
+ | procedure OnPlayerStart(PlaylistIndex: | ||
+ | begin | ||
+ | SystemLog(Item.GetTitle); | ||
+ | end; | ||
+ | |||
+ | </ | ||
+ | |||
+ | === Registering Background Scripts === | ||
+ | |||
+ | For making the code actually work with mAirList, the file has to be registered in the mAirList Control Panel: | ||
+ | |||
+ | --> SCREENSHOT <-- | ||
+ | |||
+ | While loading, the syntax of the code is checked. In case of errors a message is written into the system log, containig (somewhat obscure) the cause of the error and its location as '' | ||