Home

bitcontrol® Digital TV Link

1. 20 A 19 JScript Snippet request for Read Log Message core function r 21 A 20 Example code All log messages with verbose level 3 22 A 21 Selected verbose level iss ee deed ee ek Ee ee ee de dd ee de ke ER Se Add ee ee ER ee ee Ad ee ee Re ee ee Ad ek ee ee ee 22 A 22 Example code All log messages with timestamp greater than 11 40 28 A 23 All log messages with timestamp greater than 1140 23 A 24 Example code Find out all log messages for source JScript iese se ee ee ee ke Re ee ee 24 A 25 All log messages from the source JScript eek ER Ee ee ee AA ER Ee ee ee nemen 24 A 26 JScript Snippet request for Get Instance ld ee se ee RR Ee de AA ER Ee ee ee ee de ke RR ee 25 A 27 JScript Snippet server response for Get Instance Id core function 25 A 28 JScript Snippet request for Get DataFolder nrsnnnenuneenenannanananannanenana 25 A 29 JScript Snippet server response for Get DataFolder core function 26 bitcontrol Digital TV Link bitcontrol Digital TV Link Software Development Kit SDK Eitctrl A 30 The disk space of the bitcontrol Digital TV Link ss ee ee ke RE EA ee AA ER e 26 A 31 JScript Snippet request for Get LicenseRegnum core function ee see ee RR ee RE 27 A 32 JScript Snippet server response for Get Licen
2. bitcontrol Digital TV Link Software Development Kit SDK Version 2 1 Copyright 2014 BitCtrl Systems GmbH bitcontrol Digital TV Link Software Development Kit SDK BitCtri bitcontrol Digital TV Link Software Development Kit SDK Version 2 1 Copyright 2014 BitCtr Systems GmbH bitcontrol Digital TV Link bitcontrol Digital TV Link Software Development Kit SDK CH BitCtri Table of Contents 21170714 information AA EE EO SA ix Ee O ix 2 N deli EE EE OE RE N N ix Release levels 34111 TR ARE NR TE HE dE EE e e E egene EE Se AR X 1 IA OAUGUON AE EE EE e Eeer ege RA EENS Eege Eeer Ae 1 2 Usage E Ee EE 2 2 1 DTVLink parameterization 3 2 2 oar EE EE EE EE EE MA 4 2 2 1 Access to aplugin ee ee ee ene ee ee ee nnns 4 2 2 1 1 Load and unload a polug in ee teeeeeee esse aaa teeeeeeeeeaeaaed 4 2 2 1 2 Start and stop a plug in rivenenennnnananenaananeaa emen 5 2 2 2 Access to specific methods of a plug in interface esses 5 2 2 2 1 Plug in Recorder imrnnnnenennannenaaneeeenaaneeeenaananeenaananeenn annae 6 2 2 2 2 Pl g in DBOX2 41 54 cies KERE ss gee EE AR SE n de oe eee el crea es 6 2 2 2 3 Plug in DreamBox diwerra etter EENE e eene ener nnns 7 2 2 2 4 Plug in ReelBOX ii EE EE RE ette cmd e cta sagre Line etu pda e bud een 7 2 2 2 5 Plug in RTSP Receiver iis eke ee e
3. Script 2 Expression true Figure A 93 Example JScript Snippet request for Create Plugin Instance core function Example modification Plug in class BDA Plug in name Test Device Plug in state started 2 Rest default The next lines show the example modifications in the code 56 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e Eitctrl Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNum15 gt lt CDATA Create Plugin Context object var plugin DTVLink CreatePlugin Setup Class plugin Class BDA Alternative Bitcontrol DTVLink Plugin ReceiverFile or AA6CEC10 2408 4E69 845F 28F30755B00C Add context to Digital TV Link plugins list DTVLink Plugins Test Device plugin Alternative plugin Name My Plugin DTVLink Plugins Add plugin Load Plugin plugin State 2 Set plugin params plugin Plugin Mode 2 Start plugin plugin State 2 11 Script Figure A 94 Example JScript Snippet request for Create Plugin Instance with modifications core function Picture Figure A 95 JScript Snippit Create Plugin Instance code with modifications in request window 57 shows the code example again The modifications are marked red Data m Send Reques
4. 000128 02 Oxlef4 0x199c 2014 07 10 14 59 769 ms 27760 678sec server C1 Timeout P 000129 08 Oxlef4 Oxlfdc 2014 07 10 14 58 17 850 ms 27778 758sec Server Threadpool connections Thread shutdown Id 8156 0xifdc Count 0 4 D 4 Figure A 77 Example of a bitcontrol amp Digital TV Link log file 000102 03 Oxlef4 0x199c 000103 08 Oxlef4 Oxbc8 000104 08 Oxlef4 Oxbc8 000105 03 Oxlef4 Oxbc8 000106 08 Oxlef4 Oxbc8 000107 03 Oxlef4 Oxbc8 000108 08 Oxlef4 Oxbc8 000109 03 Oxlef4 Oxbc8 000110 08 Oxlef4 Oxbc8 000111 03 Oxlef4 Oxbc8 000112 08 Oxlef4 Oxbc8 000113 03 Oxlef4 Oxbc8 000114 08 Oxlef4 Oxbc8 000115 03 Oxlef4 Oxbc8 000116 08 Oxlef4 Oxbc8 000117 03 Oxlef4 Oxbc8 000118 08 Oxlef4 Oxbc8 000119 08 Oxlef4 Oxbc8 000120 08 Oxlef4 Oxbc8 000121 08 Oxief4 Oxbc8 000122 08 Oxlef4 Oxbc8 000123 03 Oxlef4 Oxbc8 000124 03 Oxlef4 Oxbc8 r A 2 25 Get OptionsDialogVisible Get ShowConsole Get SystrayVisible Get OptionsDialog Visible Returns the state of the bitcontrol Digital TV Link Options dialogues Get ShowConsole Returns the state of the console Get ShowConsole Returns the state of the systray icon in the footline of the desktop If the bitcontrol amp Digital TV Link Options dialogues console systray icon are open or visible the result will be true Elsewise the result will be false lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id
5. Figure A 4 Sourceld first attribute and Streamld second attribute in Channel tag 14 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e BitCtri SetActiveChannelOnAir SourceId 1234567890123456 amp StreamId 12345678 amp value false Figure A 5 JScript Snippet request for Set Channel OnAir flag original source code with place holders The place holders for Sourceld 1234567890123456 and Streamld 12345678 must be replaced with the Sourceld and the Streamld that was determinated with the Get Active Channels script The default value for the OnAir flag is true That means the OnAir state of the Channel is on If the state should be changed to offby script the value part of the code must be set false see Figure A 6 JScript Snippet request for Set Channel OnAir flag place holders replaced with the Sourceld and Streamld of the selected Channel 15 SetActiveChannelOnAir SourceId 151496720 amp StreamId 2 amp value false Figure A 6 JScript Snippet request for Set Channel OnAir flag place holders replaced with the Sourceld and Streamld of the selected Channel The server response will be OK line 2 lt xml version 1 0 encoding utf 8 gt lt Result gt Ok lt Result gt Figure A 7 JScript Snippet response for Set Channel OnAir flag After execution the respective OnAir entry in bitcontrol Digital TV Link Channels window slider Active will be set off see
6. ReguestNum15 gt lt CDATA DTVLink OptionsDialogVisible gt lt Script gt Figure A 78 Example JScript Snippet request for Get OptionsDialogVisible core function The response is a boolean value that means the option is enabled true or disabled false In this case itis true that means the bitcontrol Digital TV Link Options dialogues were open 44 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri lt xml version 1 0 encoding utf 8 gt Result Id RequestNum15 gt true lt Result gt Figure A 79 Example JScript Snippet server response for Get OptionsDialog Visible core function A 2 26 Show OptionsDialog Show Console Show Systraylcon e Show OptionsDialog Opens or closes the bitcontrol Digital TV Link Options dialogues Show Console Opens or closes the console Show Systraylcon Opens or closes the sysray icon For this the value true open or true close can be set lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum15 gt lt CDATA DTVLink OptionsDialogVisible true 11 Script Figure A 80 Example JScript Snippet request for Show OptionsDialog core function The example request above opens the bitcontrol amp Digital TV Link Options dialogues that were not open before Note The option for setting the systray icon visible invisible c
7. core function 37 A 59 Example JScript Snippet server response for Get MediaLanguageLANGID core function OO 37 A 60 Preffered media language field in bitcontrol Digital TV Link Options preferences dialogue cc 0 EE N EE 37 A 61 Example JScript Snippet request for Get VideoDecoderList core function 38 A 62 Example JScript Snippet server response for Get VideoDecoderList core function 38 A 63 Video decoder list in bitcontrol Digital TV Link Options preferences dialogue 39 A 64 Video decoder list in bitcontrol8 Digital TV Link Options decoder dialogue 39 A 65 Example JScript Snippet request for Get Storage core function ee ee AE 40 A 66 Example JScript Snippet request for Get StorageFilename core function 40 A 67 Example JScript Snippet server response for Get Storage core function 40 A 68 Example JScript Snippet request for Get StorageXMLElement core function 41 A 69 Server response for the example Red marked is the DTVLink tag me 41 A 70 Example JScript Snippet request for Get Scenario core function seek se ee RR ee ee 42 A 71 JScript Snippet server response for Get Scenario core function ie ee RA EE 42 Vi bitcontrol Digital TV Lin
8. mediasessions Thread started Id 4208 0x1070 Count 4 27699 467sec Server MA Activating 27699 467sec Server Threadpool mediasessions Thread started Id 292 0x124 Count 5 27699 467sec Server M5 Activating 27699 467sec Server Threadpool mediasessions Thread started Id 5064 0x13c8 Count 6 27699 467sec Server M6 Activating 27699 467sec Server Threadpool Mediasessions Thread started Id 6996 0x1b54 Count 7 27699 467sec Server M7 Activating 27699 468sec Server Threadpool Wediasessions Thread started Id 6636 0xi9ec Count 8 27699 468sec Server MB Activating 27699 468sec Server Threadpool Mediasessions Thread started Id 8164 0x1fe4 Count 9 27699 476sec Server Threadpool Listeners Thread started Id 5812 0x16b4 Count 1 27699 477sec Server Threadpool Listeners e Thread Started eege Count 2 27699 477sec Server Threadpool Listeners Thread started Id 6372 0x18e4 Count 3 27699 477sec Server Threadpool Listeners Thread started Id 6836 0x1ab4 Count 4 27701 432sec DTviink Starting plugin File 27703 376sec DTVLink E plugin AXIS 000125 03 Oxlef4 Oxbc8 27703 376sec AXIS E Starting 000126 03 Oxlef4 Oxbc8 07 27703 376sec AXTS Started 000127 08 Oxlef4 0x16b4 2014 07 1 846 ms 27712 758sec server Threadpool connections Thread started Id 8156 Oxifdc Count 1
9. 14 JScript Snippet server response for Get version core function The result is the same as the output of the Get version GET request see Section A 1 JScript Snippets for bitcontrol amp Digital TV Link GET requests 12 So the difference is not the result but the way of server request A 2 2 Write Log Message Writes a log message that is displayed in Console output lt Script Language JScript GlobalContext true Expression false Response XMLResponse Id ReguestNum1 gt lt CDATA DTVLink LogMessage 3 JScript Hello World 0 0 11 gt lt Script gt Figure A 15 JScript Snippet reguest for Write Log Message core function GlobalContext is true line 1 so the global variable for the LogMessage must be addressed explicit Note At the moment there is only one global variable available DTVLink The values inside the brackets line 4 mean Verbose level This verbose level must be set minimum to see the log message in the Console JScript Content of the log message Background color Text color The example code contains the string Hello World line 4 This string is displayed as log message in Console see Figure A 16 Log message output in bitcontrol Digital TV Link Console window 20 from verbose level 3 not colored bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri bitcontrol DigitalTV Link Console
10. 17 Get MediaLanguageLANGID Returns the Id of the currently set Preffered media language 36 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNum5 gt lt CDATA DTVLink MediaLanguageLANGID gt lt Script gt Figure A 58 Example JScript Snippet request for MediaLanguageLANGID core function The response is the Windows system number that represents the id of currently set Preffered media language In the example case it is 1033 for English lt xml version 1 0 encoding utf 8 gt Result Id RequestNum5 gt 1033 lt Result gt Figure A 59 Example JScript Snippet server response for Get MediaLanguageLANGID core function The next picture shows preferences area of the bitcontrol Digital TV Link Options dialogues Red marked see Figure A 60 Preffered media language field in bitcontrol Digital TV Link Options preferences dialogue 37 is the fields that are read out by the JScript Snippit r ema bitcontrol Digital TV Link Options ccs iA Ex About 7 Preferences V Enable Video Output Pin Channels Y Video Codec Mapping Video Decoder bitcontrol Video Decoder mi Audio Codec M gel Audio Codec Mapping Video Format MPAV 1408x960 NTSC Decoders Encoders V Enable
11. 2 1 Plug in Recorder DTVLink Plugins DTVLink Plugins DTVLink Plugins Recorder Recorder DTVLink Plugins Recorder Recorder Plugin LimitVolume 20 Plugin LimitDuration 15 Plugin AutoDelete true Plugin AutoDeleteTime 1440 Figure 2 9 Different code examples Access to specific methods of the plug in Recorder The following methods or variables are usable Name Description Read Write LimitDuration Access to the time limits of recording files yes yes min LimitVolume Access to the size limits of recording files yes yes MByte AutoDelete Enable Disable automatic deletion of files yes yes AutoDeleteTime The time min after that recorded files will be yes yes deleted if AutoDelete is true Table 2 3 Recorder plug in functions and variables 2 2 2 2 Plug in DBox2 DTVLink Plugins DBox2 Plugin Address 192 168 2 108 DTVLink Plugins DBox2 Plugin ChannelsRefreshInterval 1440 Figure 2 10 Different code examples Access to specific methods of the plug in DBox2 The following methods and variables are usable Name Description Read Write Address Access to the configured STB network yes yes address ChannelsRefreshinterval Access to the update interval yes yes RefreshChannelList Refreshing the channel list Table 2 4 DBox2 plug in functions and variables bitcontrol Digital TV Link Softwar
12. Audio Output Pin Transcoders 9 Statistics Audio Format 48000 Hz 5 1 M al Systray E Ee Plugins Renderer buffering time ViAuto 400 msec S AXIS Preferred media language Englisch English D zB File 8 8 Server Adjust Time Jitter J Restore last channel 7 Show Console E Prefer AC 3 Audio V Set OnAir by default E Save Log Browse FourCC Map Table Export Settings cm jJ wen L LLL LLL LLL 4 Figure 4 60 Preffered media language field in bitcontrol Digital TV Link Options preferences dialogue 37 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri A 2 18 Get VideoDecoderList Get AudioDecoderList Returns a list of all available Video Decoder Audio Decoder lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNum2 gt lt CDATA DTVLink VideoDecodersList 11 gt lt Script gt Figure 4 61 Example JScript Snippet reguest for Get VideoDecoderList core function The response lists the registry number and the corresponding name of all available video decoder audio decoder lt xml version 1 0 encoding utf 8 gt lt Result Id ReguestNum2 gt 04FE9017 F873 410E 871E AB91661A4EF7 ffdshow Video Decoder FEB50740 7BEF 11CE 9BD9 0000E202599C MPEG Video Decoder EE30215D 164F 4A92 AA4EB 9D4C13390F9Fj LAV Video Decoder 4A69B442 28BE 4991 969C B500ADF5D8A8 Mpeg4s De
13. Figure A 8 bitcontrol Digital TV Link Channels window slider Active OnAir off 16 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK i BitCtrl r bitcontrol Digital TV Link Options About 77 Preferences eats Active Actions BDA Tuner Video Codec Mapping J Audio Codec Mapping Id Channel Source Primary OnAir Recorder Publisher VideoTracks AudioTra Provider EPG Decoders 0x2 arte BDA Tuner no off 2 ARD Brasiliens K sten 5 5 Encoders Ux3 PHOENIX BDA Tuner no on I Z ARD Thema WM Land Brasilien Transcoders 0x5 Einsfestival BDA Tuner no on 1 1 ARD Wir sind nicht arm wir haben nur kein Geld ES Statistics 0x60 DasErste BDA Tuner yes on 1 2 ARD Rote Rosen 1747 LL systray HE Plugins I m re BDA Tuner H Capture Switch OnA Publish Record G a DBox2 i DreamBox Id FourCC Type Language Primary OnAir Description Bitrate KBit sec AP NetPublisher Di Recorder Hil Server m D Cx Figure A 8 bitcontrol amp Digital TV Link Channels window slider Active OnAir off Changing the JScript Snippet code value to true set the OnAir table entry on A 1 5 Set Channel Record flag Set the Record flag of the selected Channel true or false The JScript Snippet Set Channel Record flag works in the same way as the Set Channel OnAir flag JScript Snippet The dif
14. RequestNum0 gt lt CDATA for var i in DTVLink Plugins var plugin DTVLink Plugins i if plugin Plugin null amp amp plugin Plugin Channels var receiver plugin Plugin var channels receiver Channels undefined var xmlreceiver XMLResponse ownerDocume nt createElement Receiver XMLResponse appendChild x mlreceiver xmlreceiver setAttribute Name plugin Name xmlreceiver setAttribute Channels channels Coun for var i in channels var channel channels i var xml XMLResponse ownerDocument crea xmlreceiver appendChild xml xml setAttribute Id channel Id xml setAttribute Name channel Name xml setAttribute Provider channel Provider t teElement Channel 46 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e Eitctrl xml setAttribute Type channel Type xml setAttribute Network channel Network xml setAttribute Bouquets channel Bouquets xml setAttribute URL channel URL xml setAttribute SID channel SID xml setAttribute PMT PID channel PMT PID xml setAttribute PCR PID channel PCR PID xml setAttribute Video PID channel Video PID xml setAttribute Audio PID channel Audio PID xml setAttribute FreeCA channel FreeCA xml setAttribute LNB channel LNB xml setAttribute Kanal chann
15. ee oiaren aaa aiaa 42 A 2 24 Get LogFilename iese ss cece ee eee GR EA Ad ee ee enne nennen ER ee Ad ee a ee 43 A 2 25 Get OptionsDialogVisible Get ShowConsole Get SystrayVisible 44 A 2 26 Show OptionsDialog Show Console Show Systraylcon 45 A227 Get All Ep beleen sede ER ee GEE kski lakei ER ee AA ER dee Eege ee es eed 46 A 2 28 SIaliSlICS er geet Re sav ra ees ee sad TN ie ke oe Dae EG aada evivad Loe 48 A 2 29 Digital TV Link collections ee ee se ee AR ER ee AAR ER ee ee ke RA ee ee ee ee 50 A 2 29 1 Enumerate Satelittes Enumertate Cables Enumerate Terrestrials 50 A 2 29 2 Enumerate Satelittes Extra Enumertate Cables Extra Enumerate Terrestrials Extra toites EE N EE OO EE EG 51 A 2 30 el e EE 53 A 2 30 1 Enumerate Plugins nerenin aE 53 A 2 30 2 Create Plugin Instance emieunenennnnanenennnnenenannanannnnea 55 bitcontrol Digital TV Link bitcontrol Digital TV Link Software Development Kit SDK CH BitCtri List of Figures 2 1 Code example Server program communication normal form 2 2 2 Code example Server program communication expression form i e ER ee ke 2 2 3 Code example Server program communication answer of the server issie ee ee RR ee ee 3 2 4 Code example DTVLink parameterization sess 3 2 5 Code example Access Ioaplug in ce cececeee ee eeeeeeeeeee
16. ke nnns 32 A 46 Example JScript Snippet request for Get VideoDecoderld core function 32 A 47 Example JScript Snippet server response for Get VideoDeocederld core function 32 A 48 Video Decoder field in bitcontrol Digital TV Link Options preferences dialogue 33 A 49 Example JScript Snippet request for Get VideoFormatDescription core function 33 A 50 Example JScript Snippet server response for Get VideoFormatDescription core function ER EE OE MEE AS NE EE DE EN RE OR AE 33 A 51 Video Decoder field in bitcontrol Digital TV Link Options preferences dialogue 34 A 52 Example JScript Snippet request for Get BufferingTime core function 34 A 53 Example JScript Snippet server response for Get BufferingTime core function 35 A 54 Renderer buffering time option and selection field in bitcontrol Digital TV Link Options of Tee OO EE EE RO ge ce cta RE EE EL 35 A 55 Example JScript Snippet request for Get FOURCCMap core function iese see ee see 35 A 56 Example JScript Snippet server response for Get FOURCCMap core function 36 A 57 FOURCC Map Table button in bitcontrol Digital TV Link Options preferences dialogue and FOURCC map Window ii eek ee Ee ee eee ER Ee eae ER ER aitia ee ss sse entr nn ee ee ek ee de 36 A 58 Example JScript Snippet request for MediaLanguageLANGID
17. utf 8 gt Result Id RequestNum4 gt h263 H263 h264 H264 x264 H264 X264 H264 mp4v MP 4V fmp4 MP4V FMP 4 MP4V smp4 MP4V SMP4 MP4V 3iv2 MP4V 31V2 MP4V lt Result gt Figure A 56 Example JScript Snippet server response for Get FOURCCMap core function The next picture shows preferences area of the bitcontrol Digital TV Link Options dialogues Red marked see Figure A 57 FOURCC Map Table button in bitcontrol Digital TV Link Options preferences dialogue and FOURCC map window 136 is the button to open the FOURCC table window that is read out by the JScript Snippit bitcontrol Digital TV Link Options About 47 Preferences V Enable Video Output Pin Channels Video Codec Mapping Video Decoder bitcontrol Video Decoder e di Audio Codec Mapping Decoders Video Format MP4V 1408x960 NTSC Encoders V Enable Audio Output Pin EF Statistics Audio Format 48000 Ha uL Systray ij Plugins Renderer buffering time TargetFOURCC Source FOURCCs De AXIS Preferred media language H263 h263 E E Fie H264 h264 x264 X264 H S Server 7 Adjust Time Jitter MP4V mp4v fmp4 FMP4 smp4 SMP4 3iv2 31V2 7 Show Console V Set OnAir by default Save Log FourCC Map Table Figure A 57 FOURCC Map Table button in bitcontrol amp Digital TV Link Options preferences dialogue and FOURCC map window A 2
18. 0 A 86 Example JScript Snippet server response for Get Enumerate Terrestrials core function 51 A 87 Transponder in BDA plug in preferences window 51 A 88 Example JScript Snippet request for Get Enumerate Terrestrials core function 52 A 89 Part of the server response window for JScript Snippit Get Enumerate Terrestrials Extra 53 A 90 Transponder channels in BDA plug in preferences window rnrenene 53 A 91 Example JScript Snippet request for Enumerate Plugins core function 54 A 92 Example JScript Snippet server response for Enumerate Plugins core function 55 A 93 Example JScript Snippet request for Create Plugin Instance core function 56 A 94 Example JScript Snippet request for Create Plugin Instance with modifications core einer AE OR ON RR ER RE EER 57 A 95 JScript Snippit Create Plugin Instance code with modifications in request window 57 A 96 Added BDA plug in in plug in list ee ek ER EE ee AA nen 58 vii bitcontrol Digital TV Link bitcontrol Digital TV Link Software Development Kit SDK CH BitCtri List of Tables 2 1 bitcontrol Digital TV Link functions and variables 3 2 2 Common plugin functions and variables iese ss ee de ke ER EA ee de ee ee eee 5 2 3 Recorder plug in functions and variables iese ss ee ee ee ee ER AA ee dd ee ee ER E
19. 1 gt lt Channel Id 2 Name FIFASPOT LVB 3gmp4 352x288 mp4 Provider Type 1 Network Bouquets URL H Nvideo samplesMMPEG 4 3GP FIFASPOT_LVB_3gmp4_352x288 mp4 gt Receiver lt Result gt Figure 4 82 JScript Snippet server response for Show All Channels core function A 2 28 Statistics Returns statistical values of the channel the is currently in use 48 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum3 gt lt CDATA var stat DTVLink Statistics var xmlstat XMLResponse ownerDocument createElement Statistics var xmlstatvideo XMLResponse ownerDocument createElement Video var xmlstataudio XMLResponse ownerDocument createElement Audio XMLResponse appendChild xmlstat xmlstat appendChild xmlstatvideo xmlstat appendChild xmlstataudio xmlstatvideo setAttribute FCC stat VideoFCC xmlstatvideo setAttribute ReceivedBytes stat VideoReceivedBytes xmlstatvideo setAttribute ReceivedPackets stat VideoReceivedPackets xmlstatvideo setAttribute BufferFillBytes stat VideoBufferFillBytes xmlstatvideo setAttribute BufferFill
20. 140710 DTVLink log txt Browse Fourcc Map Table Export Settings eers 7 _ bitcontrol Digital TV Link Options E kl About 7 V Enable Video Output Pin 4 Figure 4 76 bitcontrol Digital TV Link log option and log preferences 43 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e Eitctrl Picture Figure A 77 Example of a bitcontrol Digital TV Link log file 44 shows an example of a bitcontrolB Digital TV Link log file F SES Datei Bearbeiten Format Ansicht 2 000098 15 Oxlef4 Oxbc8 2014 07 10 14 56 47 869 ms 27688 782sec DTVLink Saving configuration to storage 000099 15 Oxlef4 Oxbc8 2014 07 10 14 27688 815sec DTVLink Save ELE E d to Storage complete 000100 03 Oxlef4 Oxbc8 2014 07 10 14 27699 446sec DTVLink starting p gin Server 000101 03 Oxlef4 Oxbc8 2014 07 10 14 5 27699 466sec Server Mi activating 2014 07 10 14 6 ES 554 ms 27699 466sec Server Started Ki 27699 466sec Server Threadpool Mediasessions Thread started Id 4604 0xllfc Count 1 27699 466sec Server Threadpool Mediasessions Thread started id 4060 0xfdc Count 2 27699 466sec Server M2 Activating 27699 467sec Server Threadpool Mediasessions Thread started Id 6580 0x19b4 Count 3 27699 467sec Server M3 Activating 27699 467sec Server Threadpool
21. 3 8 Plugins H A AXIS Gre BDA Tuner ZDF ZDFmobil C22 yes j Einstellungen 515 3sat ZDFmobil C22 yes J Statistics 516 ZDFinfo ZDFmobil c22 yes neo KIKA ZDFmobil C22 yes Terrestrials 2 arte ARD C24 yes 3 PHOENIX ARD C24 yes 5 Einsfestival ARD C24 yes 96 Das Erste ARD C24 yes SID Name Provider Channel Free Em Figure A 87 Transponder in BDA plug in preferences window A 2 29 2 Enumerate Satelittes Extra Enumertate Cables Extra Enumerate Terrestrials Extra Returns the available transponders and their channels 51 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum15 gt lt CDATA XMLResponse setAttribute Terrestrials DTVLink Terrestrials Count for var i in DTVLink Terrestrials var terrestrial DTVLink Terrestrials i var xmlterrestrial XMLResponse ownerDocument createElement Terrestrial XMLResponse appendChild xmlterrestrial xmlterrestrial setAttribute Transponders terrestrial Transponders Count xmlterrestrial setAttribute Id terrestrial Id xmlterrestrial setAttribute Name terrestrial Name Enum Transponders for var t in terrestrial Transponders var transponder terrestrial Transponders t var xmltransponder XMLRespons
22. 30 Plug ins A 2 30 1 Enumerate Plugins Returns the state of the plug ins 53 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNum15 gt lt CDATA XMLResponse setAttribute Plugins DTVLink Plugins Count for var i in DTVLink Plugins var plugin DTVLink Plugins i var xmlplugin XMLResponse ownerDocument createElement Plugin XMLResponse appendChild xmlplugin xmlplugin setAttribute Name plugin Name xmlplugin setAttribute State plugin State xmlplugin setAttribute Class plugin Class xmlplugin setAttribute Priority plugin Priority xmlplugin setAttribute StartupType plugin StartupType 117 lt Script gt EER RR Figure A 91 Example JScript Snippet reguest for Enumerate Plugins core function The following properties and their states will be read ou by the JScript Snippit Name Name of the plug in needn t to be the type pf the plug in State State of the plug in 0 not loaded 1 loaded but not started 2 started Class Type ofthe plug in Priority Execution priority of the plug in high number means high priority and prefered execution decreasing number means decreasing priority of execution StartupType Type of plug in start 0 Disabled 1 Auto 2 Manual The re
23. AA ee ER ee AA RA GR ee Ad Ad ee ee RR ee ee ed ee ee 26 A 2 8 Get LicenseName iii Es RES RE EE Id kulud GE N RE Ed De GE dk Ee Ed da GE RSA EE sd eg kaka 28 A2 9 Get URL RE RE EE EE RE IN 28 A 2 10 Get EnablePlugins Get AutoloadPlugins Get AutostartPlugins 29 A 2 11 Get RestoreLastChannel Get Autoditter Get PreferAC3 Get SetDefaultOnAir Get ShowConsole 30 A 2 12 Get EnableVideoOutPin Get EnableAudioOutPin mrmnua 31 A 2 13 Get VideoDecld Get AudioDecld mane 32 A 2 14 Get VideoFormatDescription Get AudioFormatDescription 33 A 2 18 Get Buiferind TIME iss cie RE ER ed De RE eie lha dekaan deed Ee 34 A 2 16 Get FOUPRCCMap ec cece cece cece cece eninin aneian snis trien aa iia ea 35 bitcontrol Digital TV Link bitcontrol Digital TV Link Software Development Kit SDK e Eitctrl A 2 17 Get MediaLanguageLANGID ee ee RR EA AA ee AA ER emen nnne enne 36 A 2 18 Get VideoDecoderList Get Audiotiecoder jet 38 A 2 19 Get Storage deed GE Ee GR oiv OR GE Se ei re Re es 39 A 2 20 Get StorageFilename ies ee AR EE AA ee AR ER ee ee ee ee ee ee ee ee ke ke ee ee ee 40 A 2 21 Get StorageXMLDocument Get StorageXMLElement Get StorageXMLElementProperties rrrsrenenenenererennaneneneenenenannanaanenat 40 SPECIES m AR EE AK EE N ER 41 A 2 23 Get EnableLogFile 2 0 00 ccc eeceeeee cece eee cece
24. Description 352 x 288 lt Description gt lt Profile gt Advanced Simple lt Profile gt lt Level gt 4 lt Level gt lt Substream gt lt Substream SubstreamId 2 Type Audio FCC AAC OnAir true lt Description gt 1 Channels 32000 Hz 16 bits lt Description gt lt Profile gt AAC LC lt Profile gt lt Substream gt lt Channel gt lt Channels gt Figure A 3 JScript Snippet output for Get All Channels The example shows the Channel of the plug in File that is active at the moment The Channel tag contains additional information for example that the video file consists of two substreams video and audio The response of an active BDA plug in would show all available Channels of the selected bouguet and additional information source name stream name provider EPG data etc of each Channel A 1 4 Set Channel OnAir flag Set the OnAir flag of the selected Channel true or false Note Before using the JScript Snippet the Sourceld and the Streamld must be known The necessary information can be found with help of the Get Active Channels script After executing the script the Sourceld and the Streamld are displayed as attributes in the Channel tag see Figure A 4 Sourceld first attribute and Streamld second attribute in Channel tag 14 Channel SourceId 151496720 StreamId 2 UpTimeSec 667 7 OnAir true Record 0 Publish 0 Substreams 3 VideoSubstreams 1 AudioSubstreams 2 gt
25. Figure 2 7 Code example Unload a plug in 2 2 1 2 Start and stop a plug in The functions Start and Stop are used to start or to stop a plug in The condition reguest takes place via the variable State and the numbers 0 and 2 DTVLink Plugins Capture State 2 Figure 2 8 Code example Start a plug in The following functions or variables are available for all bitcontrol Digitial TV Link plug ins Name Description Read Write State Starts Loads and unloads a plug in 0 no yes disabled 1 auto 2 manual Name The choosen plug in name yes yes Class The Class of the plug in yes no StartupType The StartupType for this plug in 0 yes yes disabled 1 auto 2 manual Priority The priority of this plug in on startup Lower yes yes value means higher priority Hidden Indicating if the plug in is shown in the yes yes bitcontrol Digital TV Link options menu You need the boolean values true and false InfoURL An URL where you can find some more yes no information about this plug in Table 2 2 Common plugin functions and variables 2 2 2 Access to specific methods of a plug in interface The following chapter lists only the methods that are provided by the plug in Furthermore the methods will be explained with help of a short code example bitcontrol Digital TV Link Software Development Kit SDK Chapter 2 Usage of JScript interface BitCtri 2 2
26. JScript Snippets Software Development Kit SDK BitCtri The next code is used to find out all log messages for the source JScript The default code was modified with JavaScript in line 6 lt Script Language JScript GlobalContext true Expression fals Response XMLResponse Id ReguestNum4 gt lt CDATA var entry DTVLink LogLastEntry while entry null if entry Source JScript var xmlentry XMLResponse ownerDocument createElement Entry XMLResponse appendChild xmlentry xmlentry setAttribute Number entry Number xmlentry setAttribute Level entry Level xmlentry setAttribute ProcessId entry ProcessId xmlentry setAttribute ThreadId entry ThreadId xmlentry setAttribute Date new Date entry Date toLocaleString xmlentry setAttribute Source entry Source xmlentry text entry Message entry DTVLink FindLogEntryByNunber entry Number 1 11 Script Figure A 24 Example code Find out all log messages for source JScript Figure A 25 All log messages from the source JScript 24 shows the result in the response area Response Status 200 Data Format XML Figure A 25 All log messages from the source JScript 24 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e BitCtri A 2 5 Get Instanceld Returns the id of the active b
27. Link log option and log preferences 43 shows the Save Log option in the preferences area of the bitcontrol Digital TV Link Options dialogues red marked A 2 24 Get LogFilename Returns the path to the log file lt Script Language JScript GlobalContext true Response XMLResponse Id ReguestNum15 gt lt CDATA DTVLink LogFilename gt lt Script gt Expression true Figure A 74 JScript Snippet request for Get LogFilename core function The response is the path to the log file lt xml version 1 0 encoding utf 8 gt Result Id RequestNum15 gt C DTVLink_Logs 20140710_DTVLink_log txt lt Result gt Figure A 75 JScript Snippet server response for Get LogFilename core function The next picture shows the log file path in the preferences area of the bitcontrol Digital TV Link Options dialogues red marked Channels Video Codec Mapping Ai Audio Codec Mapping Decoders Encoders Transcoders Video Decoder bitcontrol Video Decoder Video Format V Enable Audio Output Pin Show Console V Set OnAir by default MP4V 1408x960 NTSC Prefer AC 3 Audio 8g Statistics Audio Format 48000 Hz 5 1 X ul Systray Hie JD Video Decoder Renderer buffering time Auto 400 msec S Plugins Preferred media language Englisch lish M H A AXIS Engisch Engish J db Fie Adjust Time Jitter F Restore last channel GM Server V Save Log C DTVLink Logs20
28. Systray Ee Plugins Renderer buffering time V Auto 400 msec i Ze AXIS Preferred media language System Default ed File J a ig Server V Adjust Time Jitter J Restore last channel Show Console Prefer AC 3 Audio d V Set OnAir by default i Save Log Browse FourCC Map Table L Export Settings ni as Figure A 42 Functions in bitcontrol Digital TV Link Options preferences area that are read out by the JScript Snippits A 2 12 Get EnableVideoOutPin Get EnableAudioOutPin Returns the state of the Video Output Pin Audio Output Pin option Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNum15 gt lt CDATA DTVLink EnableVideoOutPin 11 gt lt Script gt Figure A 43 Example JScript Snippet request for Get Enable VideoOutPin core function The response is a boolean value that means the option is enabled true or disabled false lt xml version 1 0 encoding utf 8 gt lt Result Id RequestNum15 gt true lt Result gt Figure A 44 Example JScript Snippet server response for Get EnableVideoOutPin core function The next picture shows preferences area of the bitcontrol Digital TV Link Options dialogues Red marked see Figure A 45 Video Output Pin Audio Output Pin options in bitcontrol Digital TV Link Options preferences dialogue 32 are the functions that are
29. TimeSec stat VideoBufferFillTimeSec xmlstatvideo setAttribute StreamTimestampSec stat VideoStreamTimestampSec xmlstataudio setAttribute FCC stat AudioFCC xmlstataudio setAttribute ReceivedBytes stat AudioReceivedBytes xmlstataudio setAttribute ReceivedPackets stat AudioReceivedPackets xmlstataudio setAttribute BufferFillBytes stat AudioBufferFillBytes xmlstataudio setAttribute BufferFillTimeSec stat AudioBufferFillTimeSec xmlstataudio setAttribute StreamTimestampSec stat AudioStreamTimestampSec xmlstat setAttribute Substreams stat SubstreamsCount for i20 i stat SubstreamsCount i var xmlstatsubstream XMLResponse ownerDocument createElement Substream xmlstat appendChild xmlstatsubstream xmlstatsubstream setAttribute Type stat GetSubstreamType i xmlstatsubstream setAttribute FCC stat GetSubstreamFCC i xmlstatsubstream setAttribute Id stat GetSubstreamId i xmlstatsubstream setAttribute Description stat GetSubstreamDescription i xmlstatsubstream setAttribute ReceivedBytes stat GetSubstreamReceivedBytes i xmlstatsubstream setAttribute ReceivedSamples stat GetSubstreamReceivedSamples i xmlstatsubstream setAttribute PacketizedSamples stat GetSubstreamPacketizedSamples i xmlstatsubstream setAttribute LastOriginalTimestampSec tat GetSubstreamLastOriginalTimestampSec i xmlstatsubstream setAttribute LastOriginalDTSSec stat GetSubstreamLastOrigi
30. ag 14 A 5 JScript Snippet reguest for Set Channel OnAir flag original source code with place holders EE I UE 15 A 6 JScript Snippet request for Set Channel OnAir flag place holders replaced with the Sourceld and Streamld of the selected Channel 15 A 7 JScript Snippet response for Set Channel OnAir flag sss 15 A 8 bitcontrol amp Digital TV Link Channels window slider Active OnAir off sse 16 A 9 JScript Snippet request for Set Channel Record flag 16 A 10 bitcontrol Digital TV Link Channels window slider Active Recorder Active 17 A 11 JScript Snippet request for Set Channel Plublish flag 17 A 12 bitcontrol Digital TV Link Channels window slider Active Publisher Active 18 A 13 JScript Snippet request for Get version core function iese se se see ee ee ee ee ke ER Ge ee ee ee ee ee ke 18 A 14 JScript Snippet server response for Get version core function iese se see ee dee ee ek ee ee ee 19 A 15 JScript Snippet request for Write Log Message core function seek ss ee ee AA ee ee ee 19 A 16 Log message output in bitcontrol amp Digital TV Link Console window 20 A 17 JScript Snippet request for Write Log Message local context core function 20 A 18 Colored log message output in bitcontrol Digital TV Link Console window
31. age is used with default settings the snippit response will be the same as Get StorageFilename If Storage is defined as object the snippit return will be the object content as string 39 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e Eitctrl Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNum0 gt lt CDATA DTVLink Storage 11 gt lt Script gt Figure A 65 Example JScript Snippet reguest for Get Storage core function A 2 20 Get StorageFilename Returns the name of the Storage file If the default settings are used the name of the Storage file will be DTVLink xml bitcontrol Digital TV Link configuration file lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum0 gt lt CDATA DTVLink StorageFilename 11 Script Figure A 66 Example JScript Snippet request for Get StorageFilename core function The response is a path that ends with the name of the Storage file DTVLink xml lt xml version 1 0 encoding utf 8 gt Result Id RequestNum0 gt C ProgramData BitCtrl DTVLink DTVLink xml lt Result gt Figure A 67 Example JScript Snippet server response for Get Storage core function A 2 21 Get StorageXMLDocument Get StorageXMLElement Get StorageXMLElementProperties Returns the content of the bitcontrol amp D
32. al TV Link program data all plug in configurations and the website lt xml version 1 0 encoding utf 8 gt Result Id RequestNum1 gt C ProgramData BitCtr1l DTVLink lt Result gt Figure A 29 JScript Snippet server response for Get DataFolder core function The path url in Windows Explorer opens the bitcontrol Digital TV Link folder see Figure A 30 The disk space of the bitcontrol Digital TV Link 26 EE mee 0 es DTVLink durchsuche D mm mm Organisieren y InBibliothekaufnehmen v Freigebenf ry Brennen Neuer Ordner vr MA x alot Name Gr e 3 Dokumente M Plugins WE Desktop Sr www 8 Downloads bcMMS EULA en de rtf 42 KB BDA TunerChannelsxml 4KB BE Desktop Cablesxml KB 53 Bibliotheken DreamBoxChannels xml KB d JA JasminBaranowsky DTVLink xml KB j i Computer RestoreLastChannel xml 1KB L Lokaler Datentr ge Satellitesxmi 8 KB eS DVD RW Laufweri SystrayHistoryList xml 1KB G baranowsky Wser Terrestrialsxml 5KB Lo daten server201 Gi Netzwerk EB Systemsteuerung Papierkorb JM beDTVLink 380 xr k 11 Elemente Figure A 30 The disk space of the bitcontrol amp Digital TV Link A 2 7 Get LicenseRegnum Returns the license number of the used bitcontrol Digital TV Link 26 bitcontrol Digital TV Link Appendix A JScript Snippets A Software Development Kit SDK 0 BitCtri lt Script Language JScript Glob
33. alContext true Expression true Response XMLResponse Id RequestNum2 gt lt CDATA DTVLink LicenseRegnum gt lt Script gt Figure A 31 JScript Snippet request for Get LicenseRegnum core function The licence number of bitcontrol Digital TV Link is displayed as result in the response area Note To see a license number you must have a license key lt xml version 1 0 encoding utf 8 gt Result Id ReguestNum2 gt YGBTL UDJAE RLRBA MFHPD 5P7C4 lt Result gt Figure 4 32 JScript Snippet server response for Get LicenseRegnum core function e 47 Preferences m j Channels This copy is licensed to Mustermann Video Codec Mapping 2 Audio Codec Mapping License number Decoders YGBTL UDSAE RLRBA MFHPD 5P7C4 Encoders Transcoders 58 Statistics id systray Aen Video Decoder LES Plugins v3 8 0 0 Release Unicode X86 assembled on Apr 25 2014 2014 BitCtrl Systems GmbH All rights reserved bitcontrol and BitCtrl are registred trademarks of BitCtrl Systems GmbH www bitcontrol com Figure A 33 License key in About area via bitcontrol Digital TV Link Options menu 27 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e Eitctrl A 2 8 Get LicenseName Returns the name of the bitcontrol Digital TV Link licensee Script Language JScript GlobalContext true Expression true Response XMLRes
34. an be found in Systray window of the bitcontrol Digital TV Link Options dialogues see Figure A 81 Systray icon visible invisible option in Systray window of the bitcontrol amp Digital TV Link Options dialogues 46 45 bitcontrol Digital TV Link Software Development Kit SDK Appendix A JScript Snippets BitCtri S bitcontrol Digital TV Link Options About 77 Preferences d Channels Video Codec Mapping 2 Audio Codec Mapping 8 Decoders Encoders Transcoders il E Statistics E Show Other Services de JD Video Decoder V Show Filters Menu 7 E Plugins V Show Bouquets GE AXIS V Show Program History History Length 20 ges 5 4 File Preferences Sig Server V Show Icon in Taskbar Status Area Programs Menu Arrange by 9 Providers Alphabetically Frequency V Show TV Programs Show Radio Programs 7 Show Encrypted Programs ZE eers d 4 Figure 4 81 Systray icon visible invisible option in Systray window of the bitcontrol Digital TV Link Options dialogues A 2 27 Get All Channels Returns the channels of all started plug ins and their properties The next code shows the Jscript Snippit for Get All Channels Expressions that are marked with will not be returned lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id
35. bitcontrol Decoder 3 1 Access to bitcontrol Decoder The Multistream Server plug in allows the access to bitcontrol Decoder DTVLink VideoDecoder AlwaysDeinterlace true DTVLink VideoDecoder AspectRatiox 5 DTVLink VideoDecoder AspectRatioY 3 DTVLink VideoDecoder FrameSkipping true Figure 3 1 Different code examples Access to bitcontrol Decoder The following methods and variables are usable Name Description Read Write AlwaysDeinterlace Access to the option if deinterlacing always yes yes should be used This can be set on or off with true or false AspectRatiox The aspect ration in x direction This must be yes yes use in connection with AspectRatioY AspectRatioY The aspect ration in y direction This must be yes yes use in connection with AspectRatiox ColorCorrection Reads out if color correction is set yes yes Deinterlace Reads out deinterlace mode 0 auto 1 yes yes progrssive 2 weave 3 hardware bob 4 software bob 5 software bob double rate DXVA Set DXVA and read it out For example yes yes DXVATMPEG1 true set DXVA at MPEG1 or DXVAIMPEG2 false don t set DXVA at MPEG2 You can use MPEG1 MPEG2 MPEG4 H263 H264 WMV8 WMV9 and VC1 FrameSkipping Reads out if pictures can be skipped This yes yes can be set on or off with true or false FrameSkippingTolerance Reads out how many deficient pictures are yes yes allowed LicenseMode Reads out the license mode 0 normal 1 yes no demo 2 trial 3 expi
36. bitctrl de gt bitcontrol and BitCtrl Systems are registered trademarks of the company BitCtrl Systems GmbH Leipzig 2004 2013 All other names and trade marks are the property of their respective owners 2 Liability BitCtrl Systems GmbH referred to as BitCtrl in the following will not accept liability whether specifically or implicitly for the software and its components This includes any claims regarding usage and suitability of the software for a specific purpose BitCtrl will in no way accept liability for coincidental indirect or consequential damage resulting from misuse or correct usage of the software This also applies should BitCtrl be informed prior to this of such possible damage The general terms of business for BitCtrl Systems GmbH will apply Rights to change software and documentation accrued through technical advancements are reserved bitcontrol Digital TV Link Release levels Software Development Kit SDK e BitCtrl Release levels Date Version Description Author 30 11 2007 1 0 Documents creation Krosse 02 12 2008 1 1 Appendix A added H sel Babin 31 03 2009 1 2 Appendix B added H sel Babin 10 07 2014 2 1 Documentation renewal Baranowsky Winter valid for bitcontrol Digital TV Link V3 8 bitcontrol Digital TV Link Chapter 1 Introduction Software Development Kit SDK CH BitCtri Chapter 1 Introduction This documentation of the bitco
37. cess ld Threadld Windows thread ld Date timestamp Source For the next example the default code was modified with some JavaScript code line 6 to find out all log messages with verbose level 3 21 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri lt Script Language JScript GlobalContext true Expression false Response XMLResponse Id ReguestNum4 gt lt CDATA var entry DTVLink LogLastEntry while entry null if entry Level 3 var xmlentry XMLResponse ownerDocument createElement Entry XMLResponse appendChild xmlentry xmlentry setAttribute Number entry Number xmlentry setAttribute Level entry Level xmlentry setAttribute ProcessId entry ProcessId xmlentry setAttribute ThreadId entry ThreadId xmlentry setAttribute Date new Date entry Date toLocaleString xmlentry setAttribute Source entry Source xmlentry text cu ce entry DTVLink FindLogEntryByNumber entry Number 1 117 lt Script gt Figure A 20 Example code All log messages with verbose level 3 The next picture shows the result in the response area see Figure A 21 Selected verbose level 22 Note Use the XML button to format the output Response Status 200 Data mJ Format XML Figure A 21 Selected verbose level 22 bitc
38. ch of these JScript snippets return the state of a bitcontrol Digital TV Link preference option lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum14 gt lt CDATA DTVLink RestoreLastChannel 11 gt lt Script gt Figure 4 40 Example JScript Snippet request for Get RestoreLastChannel core function The response is a boolean value that means the option is enabled true or disabled false lt xml version 1 0 encoding utf 8 gt lt Result Id RequestNum14 gt true lt Result gt Figure A 41 Example JScript Snippet server response for Get RestoreLastChannel core function The next picture shows preferences area of the bitcontrol Digital TV Link Options dialogues Red marked area see Figure A 42 Functions in bitcontrol Digital TV Link Options preferences area that are read out by the JScript Snippits 31 contains the functions that are read out by the JScript Snippits 30 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e Eitctrl r aa AAI _ bitcontrol Digital TV Link Options e s s ta a About Z Preferences V Enable Video Output Pin Channels lii Video Codec Mapping Video Decoder lt Auto gt M di Audio Codec Mapping Video Format IPEG2 720x576 PAL X Decoders Encoders V Enable Audio Output Pin Transcoders IER statistics Audio Format 8000 X wal
39. coder DMO 4A69B442 28BE 4991 969C B500ADF5D8A8j WMVideo Decoder DMO 4A69B442 28BE 4991 969C B500ADF5D8A8 Mpeg43 Decoder DMO 4A69B442 28BE 4991 969C B500ADF5D8A8 Mpeg4 Decoder DMO B1B77C00 C3E4 11CF AF79 00AA00B67A42 DV Video Decoder A888DF60 1E90 11CF AC98 00AA004COFA9 AVI Draw 301056D0 6DFF 11D2 9EEB 006008039E37 MJPEG Decompressor BECD3686 53B3 4C9E 935F A69E06BFB44AjJ bitcontrol Video Decoder 212690FB 83E5 4526 8FD7 74478B7939CDj Microsoft DTV DVD Video Decoder Result Figure A 62 Example JScript Snippet server response for Get VideoDecoderList core function The next pictures show preferences area of the bitcontrol Digital TV Link Options dialogues Red marked see Figure A 63 Video decoder list in bitcontrol Digital TV Link Options preferences dialogue 89 and is the decoder list that are read out by the JScript Snippit 38 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK n RI _ pitcontrol Digital TV Link Options About 17 Preferences V Enable Video Output Pin Channels Video Codec Mapping Video Decoder bitcontrol Video D Ai Audio Codec Mapping Decoders EE AVI Draw Vi tos Viae eg Transcoders ffdshow Video Decoder PN Statistics Audio Format LAV Video Dec
40. e Development Kit SDK Chapter 2 Usage of JScript interface e BitCtri 2 2 2 3 Plug in DreamBox DTVLink DTVLink DreamBox DreamBox Plugins Plugins DreamBox Plugin Address 192 168 1 50 Plugin Model 5 Plugin StreamMethod 1 DTVLink Plugins DreamBox DTVLink Plugins Plugin ChannelsRefreshInterval 1440 Figure 2 11 Different code examples Access to specific methods of the plug in DreamBox The following methods or variables are usable Name Description Read Write Address Access to the configured STB network yes yes address ChannelsRefreshinterval Access to the update interval Min yes yes Model Access to the model type 1 DM500 2 yes yes DM600 3 DM800 4 DM7000 5 DM7020 6 DM7025 SireamMethode Access to the transmission method 1 yes yes PES 2 TS ModelFirmwareVersion The Firmware version of the used Dreambox yes yes RefreshChannelList Refreshing the channel list Table 2 5 2 2 2 4 Plug in ReelBox Dreambox plug in functions and variables DTVLink Plugins ReelBox Plugin Address 192 168 2 105 DTVLink Plugins ReelBox Plugin ChannelsRefreshInterval 1440 Figure 2 12 Different code examples Access to specific methods of the plug in ReelBox The following methods or variables are usable Name Description Read Write Address Access to the configured STB networ
41. e ee ee RR ee ed enne hene nenne 8 2 2 2 6 Plug in Multistream Server i s eek ER Ee ee dd ee AA ER Ee ee de ee ee kk ee ee ee ee ee 8 22 2 1 Plugin BDA TUNET iore ec tertie kaka lna kaja ita Dee ER 8 3 bitcontrol BI Tes le ORR ER EE RE EE NE EE KO AE ER RE 10 3 1 Access to bitcontrol Decoder ee ee AA ER ER AA ee AA ER ee ee ee ee ee ee de ee 10 Ac JSGript el TEE 12 A 1 JScript Snippets for bitcontrol Digital TV Link GET requests issie see se se ee dee 12 AA Pe UIE DEM ROTE EEUU 12 A 1 2 Get All Channels iii de ek ER EA AA AA RR ER AA ee AA GR ee ee Ad ee de Re ER ee ee de dd ee nn 12 A1 3 Get Active Channels ESE EE id see da indeed edhe Did via 13 A 1 4 Set Channel OnAir flag ee ek ER ee AA ER ee nemen ee ee ke Re ee ee ee ee 14 A 1 5 Set Channel Record flag iis ee ee ER SA AA AA ER EA AA ee eene 16 A 1 6 Set Channel Publish an 17 A 2 JScript Snippets for bitcontrol Digital TV Link core functions POST scripts 18 A 2 4 Get VerslOf sussies ee KAR decine nex pe Dro tes addere boda aded e Dr van rare ra DER eds 18 A2 2 Write Log Message si eon cede uere cx ot Ge EER Kukk ee cud PR e eL keeda daa 19 A 2 3 Write Log Message local context esse 20 A 2 4 Read Log Messages eiii Se ERK ek EX VT aa Rd da nai 21 A 2 5 Get Instanceld EE 25 A2 6 Get Data Folder tte Ee ENEE ER Re Aat aaa Dee as 25 A 2 7 Get LicenseRegnum ie ee se Ad
42. e ee ee ee ee de RA Re ee ee ed ee de 6 2 4 DBox2 plug in functions and variables iese ese see eed ee ee AA ER Ee de ee ee RA ER ee ee ee ee ed ee ke RR ee ee ee ee ee ee ke 6 2 5 Dreambox plug in functions and variables iese ss ed ee ke RR ER Ee ee AA ER ee ee ee de ee ee ER ee ee ee ee ee de 7 2 6 ReelBox plugin functions and variables iis ee RE ee AR ER ee ee ee RA ER ee ee ee ee ee de ke ee ee 7 2 7 RTSP Receiver plug in functions and variables siese ee ek se ee ee ee AA ER ee ee ee ee ee me 8 2 8 BDA Tuner plug in functions and variables esse ees see eek ee ee ee RR Ee ee ee Ee ee ee ee 9 3 1 bitcontrol Decoder functions and variables viii bitcontrol Digital TV Link BitCtrl information Software Development Kit SDK Eitctrl BitCtrl information 1 Copyright The software and its documentation are property of BitCtrl Systems GmbH and are when used subjected to the license agreement held between the end user customer and BitCtrl Systems GmbH Any form of copying lending or sale of the software and documentation from the end user to a third party is strictly forbidden The documentation reflects the present development stage of the software and its documentation If you should come across any errors or unclear passages in the documentation please contact BitCtrl Systems GmbH WeiBenfelser Str 67 04229 Leipzig Germany Tel 49 341 490670 Fax 49 341 4906715 E Mail lt info
43. e ownerDocument createElement Transponder xmlterrestrial appendChild xmltransponder xmltransponder setAttribute Id transponder Id xmltransponder setAttribute Name transponder Name xmltransponder setAttribute FrequencyKHz transponder FrequencyKHz xmltransponder setAttribute FEC transponder FEC xmltransponder setAttribute Modulation transponder Modulation xmltransponder setAttribute Bandwidth transponder Bandwidth xmltransponder setAttribute GuardInterval transponder GuardInterval xmltransponder setAttribute TransmissionMode transponder TransmissionMode 11 Script Figure 4 88 Example JScript Snippet request for Get Enumerate Terrestrials core function The next picture shows the server response window for JScript Snippit Get Enumerate Terrestrials Extra In this case there is one Transponder named Region available The transponder has 69 channels So 69 channel entries and their properties are visible too 52 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK BitCtri Response Status 200 Data E E 00 FEC 1 Modulation 1 Bandwidth 1 GuardInterval 1 Bandwidth 1 GuardInterval 1 Frequen Format XML Figure A 89 Part of the server response window for JScript Snippit Get Enumerate Terrestrials Extra Picture Figure A 90 Transponder channels in BDA plug in preferences window 53 shows the corresp
44. e tees aeeaeeeeeeeeeeeeaaaaeteeeeeeeeeaaaaeeneeseeeees 4 2 6 Code example Load a plug in mernnnnannnennnnnaaananannannannaaaaanannnannanannaaanane 4 2 7 Code example Unload a plug in sesessssssese eene nme nennen enne 5 2 8 Code example Start a plug in esses nehmen nnns ner ER Ee ee eren nena 5 2 9 Different code examples Access to specific methods of the plug in Recorder 6 2 10 Different code examples Access to specific methods of the plug in DBox2 6 2 11 Different code examples Access to specific methods of the plug in DreamBox 7 2 12 Different code examples Access to specific methods of the plug in ReelBox 7 2 13 Code example Access to specific methods of the plug in RTSP Receiver 8 2 14 Different code examples Access to specific methods of the plug in Multistream Server 8 2 15 Code example Access to specific methods of the plug in BDA Tuner 8 3 1 Different code examples Access to bitcontrol amp Decoder essere 10 A 1 JScript Snippet output of gt Get Version eek ER AE ee nemen nnne 12 A 2 JScript Snippet output for Get All Channels 13 A 3 JScript Snippet output for Get All Channels 14 AA Sourceld first attribute and Streamld second attribute in Channel t
45. ee are the fields that are read out by the JScript Snippit r _ bitcontrol Digital TV Link Options em About Z Preferences V Enable Video Output Pin Channels Video Codec Mapping Video Decoder bitcontrol Video Decoder m Audio Codec Mappini ie li Video Format MP4V 1408x960 NTSC Decoders Encoders V Enable Audio Output Pin Transcoders IS Statistics Audio Format 48000 Hz 5 1 ul Systray 5f Plugins Renderer buffering time dau 400 msec Ze AXIS Preferred media language System Default X B d File EE i i Server Adjust Time Jitter J Restore last channel Show Console Prefer AC 3 Audio V Set OnAir by default Save Log Browse FourCC Map Table Export Settings mais cti D LLL E 4 Figure A 54 Renderer buffering time option and selection field in bitcontrol Digital TV Link Options preferences dialogue A 2 16 Get FOURCCMap Returns the contents of the FOURCC mapping table lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum4 gt lt CDATA DTVLink FOURCCMap 11 Script Figure A 55 Example JScript Snippet request for Get FOURCCMap core function The response contains all entries of the FOURCC mapping table 35 bitcontrol Digital TV Link Appendix A JScript Snippets 4b Software Development Kit SDK BitCtri lt xml version 1 0 encoding
46. el Kanal xml setAttribute FrequencyKHz channel FrequencyKHz xml setAttribute SymbolRate channel SymbolRate xml setAttribute Polarity channel Polarity xml setAttribute FEC channel FEC xml setAttribute FECMethod channel FECMethod xml setAttribute Modulation channel Modulation xml setAttribute Bandwidth channel Bandwidth xml setAttribute GuardInterval channel GuardInterval xml setAttribute TransmissionMode channel TransmissionMode xml setAttribute SpectrallInversion channel Spectrallnversion xml setAttribute ModulationSystem channel ModulationSystem xml setAttribute RollOff channel RollOff xml setAttribute Pilot channel Pilot 11 Script The result shows that there are two plug ins started AXIS plug in line 3 and File plug in line 10 Each plug in has one active channel also line 3 and line 10 In addition to these information the available channel properties are displayed too 47 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri lt xml version 1 0 encoding utf 8 gt lt Result Id RequestNum0 gt lt Receiver Name AXIS Channels 1 gt lt Channel Id 0 Name AXIS M3011 00408C9492B7 Provider Type 1 Network unicast Bouguets URL rtsp 192 168 1 28 axis media media amp videocodec mpeg4 gt lt Receiver gt lt Receiver Name File Channels
47. es Time Source Message 14 57 57 JScript Hello World H r Verbosity Level 3 C Filter JScript M Copy Clipboard Topmost Last on Top V Auto Refresh Figure A 16 Log message output in bitcontrol Digital TV Link Console window A 2 3 Write Log Message local context Writes a log message that is displayed colored in Console output lt Script Language JScript GlobalContext false Expression false Response XMLResponse Id RequestNum2 gt lt CDATA LogMessage 3 JScript Hello World 0x0000ff Oxffff00 11 Script Figure A 17 JScript Snippet request for Write Log Message local context core function If GlobalContext is false line 1 the LogMessage script runs in DTVLink context It is not necessary to define a global variable The LogMessage properties in the brackets are the same as the example before This example code contains the string Hello World line 4 but also a background color first hex value and a text color second hex value Hello World is displayed as log message in Console in yellow on blue see Figure A 18 Colored log message output in bitcontrol amp Digital TV Link Console window 20 from verbose level 3 bitcontrol amp DigitalTV Link Console Source Message Hello World 14 57 57 JScript Hello World 4 Verbosity Level 3 L Filter Copy Clipboard V Topmost V Last on Top V Auto Refresh Figure A 18 Colored lo
48. ference is the default value for the flag In this case it is false The next code shows the input line SetActiveChannelRecord SourceId 151496720 amp StreamId 2 amp value true Figure A 9 JScript Snippet request for Set Channel Record flag The next picture shows the result in bitcontrol Digital TV Link Channels window slider Active 16 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK BitCtri r BR CCDIT INE About 4 Preferences Active Actions BDA Tuner Channels Video Codec Mapping di Audio Codec Mapping z ource A R Decoders 0x2 arte BDA Tuner no on Active 1 2 ARD Brasiliens K sten 5 5 Encoders Ox3 PHOENIX 84 Toner TE DIT t TARD Themar Vir Brasitier Transcoders Ox5 Einsfestival BDA Tuner no on 1 1 ARD Wir sind nicht arm wir haben nur kein Geld EN Statistics Ox60 DasErste BDA Tuner yes on il 2 ARD Sturm der Liebe 2007 ul systray CES Plugins f m J r ze BDA Tuner ze Capture swith ona Publish Record G a DBox2 H DreamBox Id FourCC Type Language Primary OnAir Description Bitrate KBit sec St NetPublisher 0x21 MP2v 0x5632504d Video yes on 720 x 576 25 00 Hz 4261 0 i d Recorder 0x22 MP2A 0x4132504d Audio det Deutsch Deutsch yes on 2channels 16 bits 48000 Hz 192000 bits sec 187 5 Gi Server 0x23 MP2A 0x4132504d Audio fra Franz sisch francais no on 2 channe
49. g message output in bitcontrol Digital TV Link Console window 20 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e BitCtri A 2 4 Read Log Messages Returns bitcontrol Digital TV Link Log Messages lt Script Language JScript GlobalContext true Expression false Response XMLResponse Id ReguestNum2 gt lt CDATA var entry DTVLink LogLastEntry while entry null var xmlentry XMLResponse ownerDocument createElement Entry XMLResponse appendChild xmlentry xmlentry setAttribute Number entry Number xmlentry setAttribute Level entry Level xmlentry setAttribute ProcessId entry ProcessId xmlentry setAttribute ThreadId entry ThreadId xmlentry setAttribute Date new Date entry Date toLocaleString xmlentry setAttribute Source entry Source xmlentry text entry Message entry DTVLink FindLogEntryByNunber entry Number 1 11 gt lt Script gt Figure A 19 JScript Snippet reguest for Read Log Message core function If the JScript Snippet is used without changing defaults all bitcontrol Digital TV Link log messages will be returned The xmlentry attributes can be used to specify the log message output Number index number of the log message last log message has the highest number e Level bitcontrol Digital TV Link verbose level Processld Windows pro
50. gital TV Link Appendix A JScript Snippets Software Development Kit SDK 9 Eitctrl Returns the path to the scenario file Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum0 gt lt CDATA DTVLink Scenario 11 gt lt Script gt Figure 4 70 Example JScript Snippet reguest for Get Scenario core function The response is the path to the scenario that was used to start bitcontrol Digital TV Link lt xml version 1 0 encoding utf 8 gt Result Id RequestNum0 gt C scenarios test_scenario dtv lt Result gt Figure A 71 JScript Snippet server response for Get Scenario core function A 2 23 Get EnableLogFile Returns the state of the Save Log option lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum15 gt lt CDATA DTVLink EnableLogFile 11 gt lt Script gt Figure 4 72 JScript Snippet request for Get EnableLogFile core function The response is a boolean value that means the option is enabled true or disabled false lt xml version 1 0 encoding utf 8 gt lt Result Id RequestNum15 gt true lt Result gt Figure A 73 JScript Snippet server response for Get EnableLogFile core function 42 bitcontrol Digital TV Link Software Development Kit SDK Appendix A JScript Snippets BitCtri Picture Figure A 76 bitcontrol Digital TV
51. gital TV Link Options preferences dialogue A 2 14 Get VideoFormatDescription Get AudioFormatDescription Returns some format values of the currently used Video Decoder Audio Decoder lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNum2 gt lt CDATA DTVLink VideoFormatDescription 11 gt lt Script gt Figure 4 49 Example JScript Snippet request for Get VideoFormatDescription core function The response contains the format the resolution and the transmission method of the currently used video decoder audio decoder lt xml version 1 0 encoding utf 8 gt lt Result Id RequestNum2 gt MPEG2 720x576 PAL lt Result gt Figure A 50 Example JScript Snippet server response for Get VideoFormatDescription core function 33 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e BitCtri The next picture shows preferences area of the bitcontrol Digital TV Link Options dialogues Red marked see Figure A 51 Video Decoder field in bitcontrol Digital TV Link Options preferences dialogue 34 are the fields that are read out by the JScript Snippits e SS _ bitcontrol Digital TV Link Options Pae aut men dal ES About Z Preferences V Enable Video Output Pin Channels Video Codec Mapping Video Decoder lt Auto gt x Audio Codec Mappini a Audo c
52. he information will be displayed inside the script attribute result The parser respectively interpreter that is included in the HTTP server stops the processing in case of error So it is advisable to write a try catch block around every task block Occurred errors can be intercepted via this way 2 1 DTVLink parameterization The constant DTVLink inside the script represents the filter and allows the readout and the setting of parameters lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNuml DTVLink EnableVideoOutPin true DTVLink EnableAudioOutPin true DTVLink LogMessage 3 JScript Log Message 0 0 Script Figure 2 4 Code example DTVLink parameterization The JavaScript part shows the usage of the variable DTVLink for the configuration and parameterization of bitcontrol Digital TV Link In you can find some more snippets The following functions or variables are usable Name Description Read Write AudioStreamBaseTimestampSec Access to the audio stream time stamp yes no AutoloadPlugins Access to the option for the automatic plug yes yes in start BufferingTime Access to the buffer time of input streams yes yes DataFolder Access to the program directory yes no EnabledAudioOutPin Access to the audio pin yes yes bitcontrol Digital TV Link Chapter 2 Usage Software Development Ki
53. ials var terrestrial DTVLink Terrestrials i var xmlterrestrial XMLResponse ownerDocument createElement Terrestrial XMLResponse appendChild xmlterrestrial xmlterrestrial setAttribute Transponders terrestrial Transponders Count xmlterrestrial setAttribute Id terrestrial Id xmlterrestrial setAttribute Name terrestrial Name 11 gt lt Script gt Figure 4 85 Example JScript Snippet request for Get Enumerate Terrestrials core function 50 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri The result shows that one transponder was found lt xml version 1 0 encoding utf 8 gt Result Id ReguestNuml Terrestrials 1 gt lt Terrestrial Transponders 57 Id 0 Name Europe gt lt Result gt Figure A 86 Example JScript Snippet server response for Get Enumerate Terrestrials core function The bitcontrol Digital TV Link Options dialogues contain a corresponding field for the example It can be found in the BDA plug in preferences window see red marked aera in Figure A 87 Transponder in BDA plug in preferences window 51 Z Preferences Channels Regon Europe M Video Codec Mapping Channel lt All Channels gt sl ViFree only A Audio Codec Mapping Scanning Status Decoders Progress Encoders 8 Transcoders 5g Statistics Quality 839 Video Decoder ent EE
54. igital TV Link configuration file DTVLink xml Get StorageXMLDocument Returns the whole content of the xml document Get StorageXMLElement Returns only the content of the DTVLink tag 40 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri Get Storage XMLEIlementProperties Returns the properties of the DT VLink tag lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum0 gt lt CDATA DTVLink StorageXMLElement xml 11 gt lt Script gt Figure 4 68 Example JScript Snippet request for Get StorageXMLElement core function Note The extention xm behind StorageXMLElement means that the output will be a xml file Without that extention there will be no result D The next picture shows a part of the JScript Snippit server response Red marked see Figure A 69 Server response for the example Red marked is the DTVLink tag 41 is the DTVLink tag Response Status 200 Data Format XML Figure A 69 Server response for the example Red marked is the DTVLink tag A 2 22 Get Scenario Note This snippit requires a saved bitcontrol Digital TV Link scenario More information about bitcontrol Digital TV Link scenarios can be found in bitcontrol Digital TV Link user manual Note bitcontrol Digital TV Link must be started with a saved scenario 41 bitcontrol Di
55. itcontrol Digital TV Link instance Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum0 gt lt CDATA DTVLink Instanceld 117 lt Script gt Figure A 26 JScript Snippet request for Get Instance Id The result contains the nstance ID that is the Windows process id pid and the Windows thread id tid The id will be built when bitcontrol Digital TV Link starts It is unique and identifies the current instance lt xml version 1 0 encoding utf 8 gt Result Id RequestNum0 gt DTVLink pid 2300 tid 4216 lt Result gt Figure A 27 JScript Snippet server response for Get Instance Id core function Note If there are several bitcontrol Digital TV Link instances active the result of the request will be a number of different Instance ld s Then it isn t possible to identify the corresponding id for a bitcontrol Digital TV Link instance A 2 6 Get Data Folder Returns the path of the used bitcontrol Digital TV Link lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNuml lt CDATA DTVLink DataFolder gt lt Script gt Figure A 28 JScript Snippet request for Get DataFolder 25 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK BitCtri The result is the path url of the folder that contains the bitcontrol Digit
56. k yes yes address ChannelsRefreshinterval Access to the update interval yes yes RefreshChannelList Refreshing the channel list Table 2 6 ReelBox plugin functions and variables bitcontrol Digital TV Link Chapter 2 Usage Software Development Kit SDK of JScript interface CH BitCtri 2 2 2 5 Plug in RTSP Receiver DTVLink Plugins RTSP Receiver Plugin Address rtsp 192 168 134 22 41001 1ive Figure 2 13 Code example Access to specific methods of the plug in RTSP Receiver The following methods or variables are usable Name Description Read Write Address Access to the source address of the network yes yes stream Table 2 7 RTSP Receiver plug in functions and variables 2 2 2 6 Plug in Multistream Server DTVLink Plugins Server Plugin Version Figure 2 14 Different code examples Access to specific methods of the plug in Multistream Server The plug in combines the formerly HTTP server and RTSP server and contains the Media Sessions at plug in statistic It is possible to change server properties for example user rights by editing the Server xml file that can be found here C 1ProgramData BitCtrlIDTVLinkiPlugins Note The Server xml file should only be edited by experienced users 2 2 2 7 Plug in BDA Tuner DTVLink Plugins BDA Tuner Plugin BDATuner Cinergy Hybrid T USB XS Digital Tuner DTVLink Plugins BDA Tuner Start DTVLink SwitchT
57. k bitcontrol Digital TV Link Software Development Kit SDK e Eitctrl A 72 JScript Snippet request for Get EnableLogFile core function mrna 42 A 73 JScript Snippet server response for Get EnableLogFile core function 42 A 74 JScript Snippet request for Get LogFilename core function ee RR RR ee 43 A 75 JScript Snippet server response for Get LogFilename core function se RE 43 A 76 bitcontrol Digital TV Link log option and log preferences is ee ER EE ee AR ee 43 A 77 Example of a bitcontrol Digital TV Link log file essem 44 A 78 Example JScript Snippet request for Get OptionsDialogVisible core function 44 A 79 Example JScript Snippet server response for Get OptionsDialogVisible core function 45 A 80 Example JScript Snippet request for Show OptionsDialog core function 45 A 81 Systray icon visible invisible option in Systray window of the bitcontrol Digital TV Link Options dialogues RR EE ie Be a ON 46 A 82 JScript Snippet server response for Show All Channels core function 48 A 83 JScript Snippet request for Statistics core function 49 A 84 JScript Snippet server response for Statistics core function esses 50 A 85 Example JScript Snippet request for Get Enumerate Terrestrials core function 5
58. ls 16 bits 48000 Hz 192000 bits sec 187 5 H m H Figure 4 10 bitcontrol Digital TV Link Channels window slider Active Recorder Active A 1 6 Set Channel Publish flag Set the Publish flag of the selected Channel true or false The JScript Snippet Set Channel Plublish flag works in the same way as the Set Channel OnAir flag JScript Snippet The difference is the default value for the flag In this case it is false The next code shows the input line SetActiveChannelPublish SourceId 151496720 amp StreamId 2 amp value true Figure A 11 JScript Snippet request for Set Channel Plublish flag The next picture shows the result in bitcontrol Digital TV Link Channels window slider Active 17 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK BitOtrl r FIT EE N About Z Preferences 1 TH Channels Active Actions BDA Tuner WE Video Codec Mapping 3 Audio Codec Mapping Channel Source Primary OnAir Recorder Publisher _VideoTracks AudioTra Provider EPG Decoders 0x2 arte BDA Tuner no on Active 1 2 ARD Brasiliens K sten 5 5 Encoders PHOENIX BDA Toner TE ur t 2 ARD Thema Ward Brasitier Transcoders 0x5 Einsfestival BDA Tuner no on 1 1 ARD Wir sind nicht arm wir haben nur kein Geld ES statistics 0x60 DasErste BDA Tuner yes on 1 2 ARD Sturm der Liebe 2007 LL systray CES Plugins T e G Sa BDA Tune
59. mation about the plug in states of a bitcontrol Digital TV Link instance that are configured by a third party application e g bitcontrol Video Streaming Server Note The use of the JScript snippets only makes sense when starting bitcontrol amp Digital TV Link Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNuml lt CDATA DTVLink EnablePlugins 11 gt lt Script gt Figure 4 38 Example JScript Snippet reguest for Get Enable Plugins The response is a boolean value that is valid for all bitcontrol Digital TV Link plug ins of the instance lt xml version 1 0 encoding utf 8 gt Result Id RequestNum1 gt true lt Result gt Figure A 39 Example JScript Snippet server response for Get Enable Plugins core function JScript Snippet Response Get EnablePlugins If the response is true all plug ins that are marked as enabled will be immediately available but must be probably started by hand Get AutoloadPlugins If the response is true all plug ins that are marked as Manual or Auto will loaded Get AutostartPlugins If the response is true all plug ins that are marked as Auto will started automatically 29 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e BitCtri A 2 11 Get RestoreLastChannel Get AutoJitter Get PreferAC3 Get SetDefaultOnAir Get ShowConsole Ea
60. me of the currently used video decoder audio decoder lt xml version 1 0 encoding utf 8 gt Result Id RequestNuml BECD3686 53B3 4C9E 935F A69EO06BFB44A bitcontrol Video Decoder Result Figure A 47 Example JScript Snippet server response for Get VideoDeocederld core function 32 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri The next picture shows preferences area of the bitcontrol Digital TV Link Options dialogues Red marked see Figure A 48 Video Decoder field in bitcontrol Digital TV Link Options preferences dialogue 33 is the field that is read out by the JScript Snippits r n _ bitcontrol Digital TV Link Options x About Fal V Enable Video Output Pin Channels Video Codec Mapping Video Decoder bitcontrol Video Decoder x Audio Codec Mappini kee DES Video Format MPEG2 720x576 PAL Decoders Encoders V Enable Audio Output Pin Transcoders IER Statistics Audio Format 48000 Hz 5 1 X ul Systray 3 3 Plugins Renderer buffering time V Auto 400 msec Te AXIS Preferred media language lt System Default gt D z B File 8 88 Server Adjust Time Jitter F Restore last channel Show Console Prefer AC 3 Audio V Set OnAir by default v Save Log Browse FourCC Map Table d U Export Settings d L d Figure 4 48 Video Decoder field in bitcontrol Di
61. n be used to read out information from bitcontrol Digital TV Link The source code examples show the output of the selected Get reguest A 1 1 Get Version Returns the version of the used bitcontrol Digital TV Link lt xml version 1 0 encoding utf 8 gt Result Id RequestNum3 gt v3 8 0 0 Release Unicode X86 assembled on May 27 2014 lt Result gt Figure A 1 JScript Snippet output of gt Get Version A 1 2 Get All Channels Returns all available Channels of started input plug ins bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e BitCtri lt xml version 1 0 encoding utf 8 gt lt Sources gt lt Source gt lt Name gt AXIS lt Name gt lt Channels gt lt Fields Count 4 gt lt Field Id Id gt Id lt Field gt lt Field Id Name gt Name lt Field gt lt Field Id Network gt Network lt Field gt lt Field Id URL gt URL lt Field gt lt Fields gt lt Channel Enable true Active false gt lt Id gt 0 lt Id gt lt Name gt AXIS M3011 00408C9492B7 lt Name gt lt Network gt unicast lt Network gt lt URL gt rtsp 192 168 1 28 axis media media amp videocodec mpeg4 lt URL gt lt Channel gt lt Channels gt lt Source gt lt Source gt lt Name gt File lt Name gt lt Channels gt lt Fields Count 4 gt lt Field Id Id gt Id lt Field gt lt Field Id Name gt Name lt Field gt lt Field Id URL gt URL lt Field gt l
62. nalDTSSec i xmlstatsubstream setAttribute LastOriginalPTSSec stat GetSubstreamLastOriginalPTSSec i xmlstatsubstream setAttribute TimestampAverageJitterSec stat GetSubstreamTimestampAverageJitterSec i 11 Script Figure A 83 JScript Snippet request for Statistics core function 49 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri The result is a screenshot of available statistical values of the channel the is currently in use lt xml version 1 0 encoding utf 8 gt Result Id RequestNum3 gt lt Statistics Substreams gt Video FCC MP4v ReceivedBytes 27963913 ReceivedPackets 31570 BufferFillBytes 1 84467440737095E 19 BufferFillTimeSec 0 StreamTimestampSec 5 92 Audio FCC AAC ReceivedBytes 237332 ReceivedPackets 39374 BufferFillBytes 0 BufferFillTimeSec 0 StreamTimestampSec 15994 1045403 gt lt Statistics gt lt Result gt Figure A 84 JScript Snippet server response for Statistics core function A 2 29 Digital TV Link collections A 2 29 1 Enumerate Satelittes Enumertate Cables Enumerate Terrestrials Returns the available transponders lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum15 gt lt CDATA XMLResponse setAttribute Terrestrials DTVLink Terrestrials Count for var i in DTVLink Terrestr
63. ntrol Digital TV Link Software Development Kit SDK should help to understand the functionalities of bitcontrol Digital TV Link on developers base Severals functions of the bitcontrol Digital TV Link and its interfaces will be described by means of some code examples So it is possible to bind external software applications to the bitcontrol Digital TV Link Note To understand the code examples advanced knowledge of the scripting language JScript is reguired because this documentation does not contain the elemental architectures of this language Furthermore itis necessary to understand the basics of XML Please use the internet to catch up on something about the mentioned topics bitcontrol Digital TV Link Chapter 2 Usage Software Development Kit SDK of JScript interface CH BitCtri Chapter 2 Usage of JScript interface The bitcontrol Digital TV Link provides a JScript interface that allows a remote control of the program This interface is realized through the Multistream Server plug in So the first constraint is that you have a started bitcontrol Digital TV Link with a running Multistream Server plug in There is a HTTP Media Session where you can add or remove different URL This parameterization can you change in the xml file This will be explain in Most of the parameters of bitcontrol Digital TV Link and its other plug ins can be changed by the usage of this interface So the readout of information is also
64. o M VideoFormat SEET SCH Decoders Encoders V Enable Audio Output Pin Transcoders IEN statistics Audio Format 8000 Y al Systray EME Plugins Renderer buffering time V Auto 200 msec ak AXIS Preferred media language System Default z Hd File ij Server V Adjust Time Jitter V Restore last channel 7 show Console Prefer AC 3 Audio Uu V Set OnAir by default E save Log Browse FourCC Map Table Export Settings e SSS Figure A 51 Video Decoder field in bitcontrol Digital TV Link Options preferences dialogue A 2 15 Get BufferingTime Returns the Renderer buffering time lt Script Language JScript GlobalContext true Response XMLResponse Id ReguestNum3 gt lt CDATA DTVLink BufferingTime 11 gt lt Script gt Expression true Figure A 52 Example JScript Snippet request for Get BufferingTime core function The response is the buffering time value in milliseconds Note If the response value is negative the Auto option is not active 34 bitcontrol Digital TV Link Software Development Kit SDK Appendix A JScript Snippets BitCtri lt xml version 1 0 encoding utf 8 gt lt Result Id RequestNum3 gt 400 lt Result gt Figure A 53 Example JScript Snippet server response for Get BufferingTime core function The next picture shows preferences area of the bitcontrol Digital TV Link Options dialogues Red marked s
65. oChannelByName BDA Tuner 3sat Figure 2 15 Code example Access to specific methods of the plug in BDA Tuner bitcontrol Digital TV Link Software Development Kit SDK Chapter 2 Usage of JScript interface Eitctrl The following methods or variables are usable Name Description Read Write BDATuner Defines a BDA tuner device name yes yes BDATunerld Defines a BDA tuner device unique hardware yes yes id BDADemodulator Defines a BDA demodulator device name yes yes When tuner has no demodulator set empty value BDADemodulatorld Defines a BDA demodulator device unique yes yes hardware id When tuner has no demodulator set empty value BDACapture Defines a BDA capture device name When yes yes tuner has no capture set empty value BDACaptureld Defines a BDA capture device unigue yes yes hardware id When tuner has no capture set empty value BDASystemType The BDA tuner DVB system type Thislyes yes parameter can be one ofthe following values 1 Unknown DVB system 1 DVB S satellite system 2 DVB C cable system 3 DVB T terrestrial system DiSEqCvialnputRange The BDA tuner initial DVB S DiSEqC yes yes TotalReceivedBytes The number of received bytes yes no Table 2 8 BDA Tuner plug in functions and variables bitcontrol Digital TV Link Software Development Kit SDK Chapter 3 bitcontrol Decoder BitCtrl Chapter 3
66. oder JL systray Microsoft DTV DVD Video Decoder E Plugins Renderer bufferjr MJPEG Decompressor Ed AXIS MPEG Video Decoder Preferred media li Mpeg4s Decoder DMO B A File 65 888 Server E Adjust Time Jitter J Restore last channel 7 Show Console E Prefer AC 3 Audio V Set OnAir by default El save Log FourCC Map Table Figure 4 63 Video decoder list in bitcontrol Digital TV Link Options preferences dialogue Troa OOOO OO About 77 Preferences Channels Name Type System Topology Propertie Video Codec Mapping AVI Draw Video yes 2 Audio Codec Mapping bitcontrol Video Decoder Video yes DV Video Decoder Video yes Fired ffdshow Video Decoder Video yes E Statistics LAV Video Decoder Video yes Microsoft DTV DVD Video Decoder Video yes LL systray x d E Plugins MJPEG Decompressor Video yes 5 SA AXIS MPEG Video Decoder Video yes E ri File Mpeg4 Decoder DMO Video yes EN Server Mpeg43 Decoder DMO Video yes Mpeg4s Decoder DMO Video yes WMVideo Decoder DMO Video _yes ACM Wrapper Audio yes E bitcontrol MPEG 2 Audio Decoder Audio yes Decrypt Tag Audio yes ffdshow Audio Decoder Audio yes LAV Audio Decoder Audio yes Microsoft DTV DVD Audio Decoder Audio yes d MD2Nernder MMA Adis vae SS Ls Figure A 64 Video decoder list in bitcontrol Digital TV Link Options decoder dialogue A 2 19 Get Storage If Get Stor
67. onding area in in BDA plug in preferences window bitcontrol Digital TV Link Options dialogues _ bitcontrol Digital TV Link Options About Z7 Preferences R egion Channels s Eupe Scan eegen SES DE Ai Audio Codec Mapping lt All Channels gt canning Status Decoders COS 177 500 KHz 7 MHz Encoders Progress i C06 184 500 KHz 7 MHz jj s d C07 191 500 KHz 7 MHz rondes C08 198 500 KHz 7 MHz j 9 Statistics Quality C09 205 500 KHz 7 MHz ul systray ida C10 212 500 KHz 7 MHz V Ji Video Decoder oed C11 219 500 KHz 7 MHz 8 Steen C12 226 500 KHz 7 MHz L SID Nah C21 474 000 KHz 8 MHz nel Ge AXIS C22 482 000 KHz 8 MHz E BDA Tuner 514 ZDF C23 490 000 KHz 8 MHz yes 3 Einstellungen 515 3sp C24 498 000 KHz 8 MHz yes C25 506 000 KHz 8 MHz HEES ske C26 514 000 KHz 8 MHz y Ly ae 517 NED C27 522 000 KHz 8 MHz yes Lj Terrestrials S arfeC28 530 000 KHz 8 MHz yes j EPG 3 pic C29 538 000 KHz 8 MHz ea GH File C30 546 000 KHz 8 MHz sch server H Ein C31 554 000 KHz 8 MHz yes EJ 96 Das C32 562 000 KHz 8 MHz yes C33 570 000 KHz 8 MHz C34 578 000 KHz 8 MHz C35 586 000 KHz 8 MHz C36 594 000 KHz 8 MHz OJ 037 602 000 KHz 8 MHz C38 610 000 KHz 8 MHz C39 618 000 KHz 8 MHz C40 626 000 KHz 8 MHz C41 634 000 KHz 8 MHz 4 Figure 4 90 Transponder channels in BDA plug in preferences window A 2
68. ontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK For the next example all log messages with timstamp greater than 11 40 should be issued For this the default code was modified with JavaScript in line 5 and line 7 lt Script Language JScript GlobalContext true Expression fals Response XMLResponse Id ReguestNum4 gt lt CDATA var entry DTVLink LogLastEntry var now new Date 2014 5 20 11 40 00 000 while entry null if entry Date gt now var xmlentry XMLResponse ownerDocument createElement MLResponse appendChild xmlentry lentry setAttribute Number entry Number lentry setAttribute Level entry Level lentry setAttribute ProcessId entry ProcessId lentry setAttribut aa entry ThreadId n n n 3 3 S 3 lentry setAttribut lentry setAttribute E entry Source lentry text EEN 3 XXX MK X X Se 3 3 entry DTVLink FindLogEntryByNumber entry Number 1 11 Script Date new Date entry Date toLocaleString Figure A 22 Example code All log messages with timestamp greater than 11 40 Figure A 23 All log messages with timestamp greater than 11 40 23 shows the result in the response area Response Status 200 Data Format XML Figure A 23 All log messages with timestamp greater than 11 40 23 bitcontrol Digital TV Link Appendix A
69. ponse Id ReguestNum0 gt lt CDATA DTVLink LicenseName 11 gt lt Script gt Figure 4 34 JScript Snippet reguest for Get LicenseRegnum core function The result is the name of the bitcontrol Digital TV Link licensee It s the same name as in the About area that can be opened via bitcontrol Digital TV Link Options menu see Figure A 33 License key in About area via bitcontrol Digital TV Link Options menu 27 lt xml version 1 0 encoding utf 8 gt lt Result Id RequestNum3 gt Mustermann lt Result gt Figure A 35 JScript server for Get LicenseName core function A 2 9 Get URL Returns the URL of the bitcontrol Digital TV Link server lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNum0 gt lt CDATA DTVLink URL 11 gt lt Script gt Figure 4 36 JScript Snippet reguest for Get URL core function The result server URL has no port number The default port is 80 The port can be changed by editing the Server xml file 28 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e BitCtri lt xml version 1 0 encoding utf 8 gt Result Id RequestNum0 gt dtvl localhost lt Result gt Figure A 37 JScript server response for Get URL core function A 2 10 Get EnablePlugins Get AutoloadPlugins Get AutostartPlugins These JScript snippets are used to get infor
70. possible In Appendix A JScript Snippets 12 you can find some JScript examples The communication between server and program can be separated in two different JScript versions expression form or normal form The expression form is mandatory The normal form can be used to set parameters The differencebetween the two forms is the attribute expression inside the script tag The normal form looks like this lt xml version 1 0 encoding UTF 8 gt lt DTV version 1 0 gt script language JScript gt lt CDATA gt lt script gt lt DTV gt Figure 2 1 Code example Server program communication normal form The expression form differs minimal lt xml version 1 0 encoding UTF 8 gt lt DTV version 1 0 gt lt script language JScript expression 1 gt lt CDATA 1 gt lt script gt lt DTV gt Figure 2 2 Code example Server program communication expression form The answer ofthe server follows also a defined scheme bitcontrol Digital TV Link Chapter 2 Usage Software Development Kit SDK of JScript interface e BitCtri lt xml version 1 0 encoding UTF 8 gt lt DTV gt script errno 0 resultz lt script gt lt DTV gt Figure 2 3 Code example Server program communication answer of the server The attribute errno has the value 0 in success case In case of error the value correlates the Windows error code During information readout t
71. r State 0 Class RTSPReceiver Priority 110 e 0 gt me Server State 2 Class MultistreamServer Priority 200 e 2 gt me TraficonVIPT State 0 Class TraficonVIPT Priority 110 StartupType 0 gt Figure 4 92 Example JScript Snippet server response for Enumerate Plugins core function A 2 30 2 Create Plugin Instance This JScript Snippit allows the creation of an own plug in For this the default code see Figure A 95 JScript Snippit Create Plugin Instance code with modifications in request window 37 can be modified The properties mentioned in Section A 2 30 1 Enumerate Plugins 53 can be changed for the new plug in 55 bitcontrol Digital TV Link Software Development Kit SDK Appendix A JScript Snippets BitCtri lt Script Language JScript GlobalContext true Response XMLResponse Id RequestNum15 gt lt CDATA Create Plugin Context object var plugin DTVLink CreatePlugin Setup Class plugin Class ReceiverFile Alternative Bitcontrol DTVLink Plugin ReceiverFile or AA6CEC10 2408 4E69 845F 28F30755B00C Add context to Digital TV Link plugins list DTVLink Plugins My Plugin plugin Alternative plugin Name My Plugin DIVLink Plugins Add plugin Load Plugin plugin State 1 Set plugin params plugin Plugin Mode 2 Start plugin plugin State 11
72. r ne Capture _ sp Lon JI aas TL esg D am DBox2 d DreamBox Id FourCC Type Language Primary OnAir Description Bitrate K it sed EI NetPublisher Ox21 MP2V 0x56325044 Video yes on 720x 576 25 00 Hz 4261 0 H E Recorder 0x22 MP2A 0x4132504d Audio det Deutsch Deutsch yes on 2channels 16 bits 48000 Hz 192000 bits sec 187 5 E Server 0x23 MP2A 0x4132504d Audio fra Franz sisch francais no on 2channels 16 bits 48000 Hz 192000 bits sec 187 5 4 M C Figure A 12 bitcontrol Digital TV Link Channels window slider Active Publisher Active A 2 JScript Snippets for bitcontrol Digital TV Link core functions POST scripts These JScript Snippets use the POST method to read out core function of bitcontrol Digital TV Link The example codes show the request and the result of core function POST script requests A 2 1 Get Version Returns the version of the used bitcontrol Digital TV Link Script Language JScript GlobalContext true Expression true Response XMLResponse Id ReguestNum0 gt lt CDATA DTVLink Version 11 Script Figure A 13 JScript Snippet request for Get version core function 18 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e BitCtri lt xml version 1 0 encoding utf 8 gt Result Id ReguestNum0 gt v3 8 0 0 Release Unicode X86 assembled on May 27 2014 lt Result gt Figure A
73. read out by the JScript Snippits 31 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e Eitctrl F K9 9 _ bitcontrol Digital TV Link Options e s e e a About Z Preferences V Enable Video Output Pin Channels lii Video Codec Mapping Video Decoder lt Auto gt zj Audio Codec M ee ee epp Video Format SSES m Decoders Encoders V Enable Audio Output Pin Transcoders Ed Statistics Audio Format 8000 M ik Systray M dy Plugins Renderer buffering time V Auto 400 msec ll a e AXIS Preferred media language lt System Default gt ei zB File IM 8 88 Server V Adjust Time Jitter F Restore last channel show Console Prefer AC 3 Audio V V Set OnAir by default d Save Log Browse FourCC Map Table e Export Settings as as Figure 4 45 Video Output Pin Audio Output Pin options in bitcontrol Digital TV Link Options preferences dialogue A 2 13 Get VideoDecld Get AudioDecld Returns the Id and the name of the currently used Video Decoder Audio Decoder lt Script Language JScript GlobalContext true Expression true Response XMLResponse Id RequestNuml lt CDATA DTVLink VideoDecoderId 11 Script Figure A 46 Example JScript Snippet request for Get VideoDecoderld core function The response is the registry number and the na
74. red LicenseName Reads out the license name yes no bitcontrol Digital TV Link Software Development Kit SDK Chapter 3 bitcontrol Decoder Eitctrl Name Description Read Write LicenseRegnum Reads out the license number yes no OutputConnectionAllowList Access to the list of filters which are allowed to use the decoder OutputConnectionDenyList Access to the list of filters which are allowed yes yes to use the decoder OutputTypesPriority Access to the priorities of output formats yes yes OutputTypesPriorityDXVA Access to the priorities of DirectX8 yes yes output formats This connection must be used with DXVA values for example OutputTypesPriorityDXVA1 MPEG or OutputTypesPriorityDXVA2 MPEG2 The different video types are the same like DXVA OutputTypesPriority HW Access to the priorities of the output formats yes yes in deinterlace mode RendererLateness Reads out the render delay yes no UseHadwareAcceleratedDeinterladecess to the option if hardware accelerated yes yes deinterlace should be used This can be set on or off with true or false Version Reads the decoder version yes no Table 3 1 bitcontrol amp Decoder functions and variables bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK CH BitCtri Appendix A JScript Snippets A 1 JScript Snippets for bitcontrol Digital TV Link GET reguests Get requests ca
75. seRegnum core function 27 A 33 License key in About area via bitcontrol amp Digital TV Link Options menu 27 A 34 JScript Snippet request for Get LicenseRegnum core function nrrrenne 28 A 35 JScript server for Get LicenseName core function ss ee ee ek ER ER ee AR Re ee ee 28 A 36 JScript Snippet request for Get URL core function se AR AA Ee AA ER ee ee nan 28 A 37 JScript server response for Get URL core function ee sse 29 A 38 Example JScript Snippet request for Get Enable Plugins 29 A 39 Example JScript Snippet server response for Get Enable Plugins core function 29 A 40 Example JScript Snippet request for Get RestoreLastChannel core function 30 A 41 Example JScript Snippet server response for Get RestoreLastChannel core function 30 A 42 Functions in bitcontrol Digital TV Link Options preferences area that are read out by the JScript SnhIppitS 2 2 EE EO md kit eeu casada 31 A 43 Example JScript Snippet request for Get EnableVideoOutPin core function 31 A 44 Example JScript Snippet server response for Get EnableVideoOutPin core function 31 A 45 Video Output Pin Audio Output Pin options in bitcontrol Digital TV Link Options preferences dialogue nnnnnnnnnnnaannanannanan ee nnns enter rnt AA ee neni Re nr ee Ad ee de
76. sult of the reguest see next code shows all available plug ins their properties and states 54 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK E BitCtri lt xml version 1 0 encoding utf 8 gt lt Result Id lt Plugin tartupT Plugin tartupT Plugin tartu Plugi tartupT Plugi tartu Plugi tartu Plugin Startup Plugin tartu Plugi tartu Plugi tartupT Plugi tartu Plugi tartupT Plugin D IO H d d tg H E Mig AK AK BZK Z A DA DA DA DA D OT df Hg ur 4 E IO kd Big ZK ZK ZK d A DA DA DA DA Di A lt Result gt Re Na y Z y H Z IO 9 OG oO w O w G w w G w O oO HMO YM O o O y Z w questNum0 Plugins 13 gt me AXIS State 1 Class AXIS Priority 110 e 2 gt me BDA Tuner State 1 Class BDA Priority 100 e 2 gt me BoschVIPX State 0 Class BoschVIPX Priority 110 e 0 gt me Capture State 0 Class Capture Priority 100 e 0 gt me DBox2 State 0 Class DBox2 Priority 100 e 0 gt me DreamBox State 0 Class DreamBox Priority 100 e 0 gt me File State 1 Class ReceiverFile Priority 110 pe 2 me NetPublisher State 0 Class NetPublisher Priority 100 e 0 gt me Recorder State 0 Class Recorder Priority 50 e 0 gt me ReelBox State 0 Class ReelBox Priority 100 e 0 gt me RTSP Receive
77. t Figure A 95 JScript Snippit Create Plugin Instance code with modifications in request window 57 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK The result of the reguest can be found in the plug in list bitcontrol Digital TV Link Options dialogues The added plug in is visible there red marked It has the state started by default r n bitcontrol Digital TV Link Options Ex About Z Preferences 4 Channels Name Status Priority Startup Type Video Codec Mapping A AXIS Loaded 110 Manual d Audio Codec Mapping BDA Tuner Started 100 Auto DUE glyBoschviex 110 Disabled is Sw Capture 100 Disabled I Statistics DBox2 100 Disabled LL systray gt DreamBox 100 Disabled amp CH Video Decoder Jie Loaded 110 Manual Sta NetPublisher 100 Disabled H A AXIS recorder 50 Disabled ze BDA Tuner ReelBox 100 Disabled H 4 File SP RTsp Receiver 110 Disabled LN Server Sa Server Started 200 Manual Ee Test Device TraficonVIPT 110 Disabled Fre Device Started 100 Disabled Figure A 96 Added BDA plug in in plug in list 58
78. t SDK of JScript interface e Eitctrl Name Description Read Write EnabledVideoOutPin Access to the video pin yes yes LicenseMode Readout of the license mode yes no LicenseName Access to the license name yes no LicenseRegnum Access to the license number yes no LogMessage int Access to the console text no yes loglevel Sourcename Message clrBackground clrForeground Plugins String plugin Access to the plug in list yes no ShowConsole true or false Access to the console or hide the console yes no URL Access to the URL yes yes Version Access to versions yes no VideoStreamBaseTimestampSec Access to the video stream base time stamp yes no VideoDecoder Access to the video decoder yes no Table 2 1 bitcontrol Digital TV Link functions and variables 2 2 Plug in 2 2 1 Access to a plug in The access to the plug ins takes place with help of the name and via the DTVLink attribute Plugins DTVLink Plugins Capture StartupType 1 Figure 2 5 Code example Access to a plug in 2 2 1 1 Load and unload a plug in The functions Load and Unload are used to load or to unload a plug in The condition reguest takes place via the variable State and the numbers 0 and 1 DTVLink Plugins Capture State 1 Figure 2 6 Code example Load a plug in bitcontrol Digital TV Link Chapter 2 Usage Software Development Kit SDK of JScript interface e BitCtri DTVLink Plugins Capture State 0
79. t Field Id Duration gt Duration lt Field gt lt Fields gt lt Channel Enable true Active false gt lt Id gt 2 lt Id gt lt Name gt FIFASPOT LVB 3gmp4 352x288 mp4 lt Name gt lt URL gt C Video video_samples MPEG 4 3GP FIFASPOT_LVB_3gmp4_352x288 mp4 lt URL gt lt Channel gt lt Channels gt lt Source gt lt Sources gt Figure A 2 JScript Snippet output for Get All Channels The source code example shows two active input plug ins Axis plug in and File plug in as video sources Both plug ins have one Channel that isn t active Inside the Channel tag are further information about the Channel available A 1 3 Get Active Channels Returns all Channels of a bouguet of the input plug in that is active 13 bitcontrol Digital TV Link Appendix A JScript Snippets Software Development Kit SDK e BitCtrl lt xml version 1 0 encoding utf 8 gt lt Channels gt Channel SourceId 76472624 StreamId 1 UpTimeSec 9 4 OnAir true Record 0 Publish 0 Substreams 2 VideoSubstreams 1 AudioSubstreams 1 gt lt SourceName gt File lt SourceName gt lt StreamName gt FIFASPOT_LVB_3gmp4_ 352x288 mp4 lt StreamName gt lt EPGName gt FIFASPOT_LVB_3gmp4_352x288 lt EPGName gt lt EPGDescription gt C Videon video_samples MPEG 4 3GP FIFASPOT LVB 3gmp4 352x288 mp4 EPGDescription Substream SubstreamId 1 Type Video FCC MP4V OnAir true

bitcontrol® Digital TV Link

Contents

Download Pdf Manuals

Related Search

Related Contents

bitcontrol&reg; Digital TV Link

Contents

Download Pdf Manuals

Related Search

Related Contents

bitcontrol® Digital TV Link