1. Introduction
JavaScript Extension1.1 Using Method
1.1.1 Property
You can READ/WRITE it, except some read-only property.Ex: device.cpufreq
1.1.2 Function
You can call it with/without parameter (by function)Ex: stb.reboot()
1.1.3 Object Collection (JavaScript Array)
You can use array index to retrieve one object among this collectionEx: dvb.channels[] —- Object Collection
Ex: dvb.channels[0] —- One Object
2. API
API/Property Declaration and Definition.2.1 Hardware Environment
2.1.1 Get Serial Number
DescriptionGet Serial Number of STB
Property
device.sn
2.1.2 Get MAC Address
DescriptionGet MAC Address of STB Ethernet Card
Property
device.macaddr
2.1.3 Get DRAM size
DescriptionGet DRAM size of STB
Property
device.memsize
2.1.4 Get Flash memory size
DescriptionGet Flash memory size of STB
Property
device.memsize
2.1.5 Get Name and Model Number of STB’s CPU
DescriptionGet Name and Model Number of STB’s CPU.
Property
device.cpuname
2.1.6 Get CPU Frequency
DescriptionGet CPU Frequency of STB
Property
device.cpufreq
2.1.7 Get Model Number and Name of STB
DescriptionGet Model Number and Name of STB. E.g. AST1100-C0
Property
device.model
2.1.8 Get STB Internal HardDisk exist status
DescriptionGet Internal HardDisk Exist Status
Property
stb.hd_exist
Value
True | HD Exist |
false | HD not Exist or HardDisk Fail |
2.1.9 Get STB Internal HardDisk free size
DescriptionGet Internal HardDisk free size (unit: MB)
Property
stb.hd_freesize
Value
HD free size (in MB)
2.2 System Setting
2.2.1 Get/Set MENU TYPE
DescriptionThis setting is used to identify Function Scope
(ex: VOD/IPTV/DVB/PVR) for internal requirement.
We use this setting for IR-Controller Shortcut-Key(HOME/VOD/IPTV/DVB/PVR/INTERNET)
*You need to manually set this property by JavaScript when page is loaded
Property
stb.menutype
Value
0 | HOME |
1 | VOD |
2 | IPTV |
3 | DVB |
4 | PVR |
5 | INTERNET |
2.2.2 Get/Set IP Address of Time Server
DescriptionGet/Set Time Server of STB
Property
stb.timeServer
2.2.3 Get/Set TimeZone
DescriptionGet/Set Time Zone of STB
Property
stb.timeZone
Value
Value | TimeZone | Time |
1 | USA | -10 |
2 | USA | -9 |
3 | USA | -8 |
4 | USA | -7 |
5 | USA | -6 |
6 | USA | -5 |
7 | Faroe_Islands | 0 |
8 | Ireland | 0 |
9 | Portugal | 0 |
10 | UK | 0 |
11 | Austria | 1 |
12 | Belgium | 1 |
13 | Bosnia_Herzegovina | 1 |
14 | Croatia | 1 |
15 | Czech_Republic | 1 |
16 | Denmark | 1 |
17 | France | 1 |
18 | Germany | 1 |
19 | Hungary | 1 |
20 | Italy | 1 |
21 | Luxembourg | 1 |
22 | Macedonia | 1 |
23 | Malta | 1 |
24 | Namibia | 1 |
25 | Netherlands | 1 |
26 | Norway | 1 |
27 | Poland | 1 |
28 | Slovakia | 1 |
29 | Slovenia | 1 |
30 | Spain | 1 |
31 | Sweden | 1 |
32 | Switzerland | 1 |
33 | Belarus | 2 |
34 | Estonia | 2 |
35 | Finland | 2 |
36 | Greece | 2 |
37 | Israel | 2 |
38 | Latvia | 2 |
39 | Lithuania | 2 |
40 | Moldova | 2 |
41 | Romania | 2 |
42 | Russian_Federation | 2 |
43 | South_Africa | 2 |
44 | Turkey | 2 |
45 | Ethiopia | 3 |
46 | Russian_Federation | 3 |
47 | Iran | 3.5 |
48 | Azerbaijan | 4 |
49 | Mauritius | 4 |
50 | Russian_Federation | 4 |
51 | Pakistan | 5 |
52 | Russian_Federation | 5 |
53 | India | 5.5 |
54 | Sri_Lanka | 5.5 |
55 | Russian_Federation | 6 |
56 | Indonesia | 7 |
57 | Russian_Federation | 7 |
58 | Thailand | 7 |
59 | Vietnam | 7 |
60 | Australia | 8 |
61 | Brunei | 8 |
62 | China | 8 |
63 | Hong_Kong | 8 |
64 | Indonesia | 8 |
65 | Malaysia | 8 |
66 | Philippines | 8 |
67 | Russian_Federation | 8 |
68 | Singapore | 8 |
69 | Taiwan | 8 |
70 | Australia | 9 |
71 | Indonesia | 9 |
72 | Russian_Federation | 9 |
73 | South_Korea | 9 |
74 | Australia | 10 |
75 | Russian_Federation | 10 |
76 | Australia | 11 |
77 | Russian_Federation | 11 |
78 | New_Zealand | 12 |
79 | Russian_Federation | 12 |
2.2.4 Get/Set Password
DescriptionGet/Set Password of STB
Property
stb.adminPassword
2.2.5 Get/Set URL of Firmware Update
DescriptionGet/Set Firmware Update URL of STB
Property
stb.fwUpdateUrl
2.2.6 Get/Set Time Calibration Mode
DescriptionGet/Set Time Calibration Mode of STB
Property
stb.timeMethod
Value
0: Manual Set(No Calibration)
1: NTP Calibration
2: DVB Calibration
2.2.7 Get/Set Daylight Saving Time Option
DescriptionGet/Set Daylight Saving Time Option
Property
stb.daylight
Value
0: Disable Daylight Saving Time
1: Enable Daylight Saving Time
CAUTION: You should call NTP Update (stb.ntpUpdate) after setting this. Because the daylight saving time will apply to system time after time calibration.
2.2.8 Get/Set Device Name of STB
DescriptionGet/Set Device Name of STB
Property
stb.deviceName
2.2.9 Get/Set System Language
DescriptionGet/Set System Default Language of STB
Property
stb.language
Value
«en»: English
“tw”: Chinese Traditional
“zh”: Chinese Simplified
2.2.10 Get System Modal State
DescriptionGet System is modal state or not
Property
stb.ismodal
Value
0: Not Modal State
1: In Modal State (ex: Firmware Update)
PS: You must carefully set this property and manage its status.
2.2.11 Get/Set Display Mode
DescriptionGet/Set Display Mode
Property
stb.displaymode
Value
0 | NTSC |
1 | NTSC-JAPAN |
2 | PAL-M |
3 | PAL-N |
4 | PAL-NC |
5 | PAL-B |
6 | PAL-B1 |
7 | PAL-D |
8 | PAL-D1 |
9 | PAL |
10 | PAL-H |
11 | PAL-K |
12 | PAL-I |
13 | SECAM |
14 | 480P |
15 | 576P |
16 | 1080I |
17 | 1080I-50HZ |
18 | 1080P |
19 | 1080P-24HZ |
20 | 1080P-25HZ |
21 | 1080P-30HZ |
22 | 1250I-50HZ |
23 | 720P |
24 | 720P-50HZ |
25 | 720P-24HZ |
2.2.12 Get/Set System Aspect Ratio
DescriptionGet/Set Aspect Ratio of TV
Property
stb.aspect
Value
0: 4:3
1: 16:9
CAUTION: This setting is in order to indicate your TV Aspect Ratio. To set this value correct to real TV’s aspect ratio. You will get a correct output. This value will co-work with Content Mode.
2.2.13 Get/Set System Output Type
DescriptionGet/Set System ‘s output type
Property
stb.outputtype
Value
0: RGB(Component)
1: YPbPr(YcbCr)
2.2.14 Get/Set System Content Mode
DescriptionGet/Set System ‘s Content Mode
Property
stb.content
Value
0 | Zoom |
1 | Box |
2 | PanScan |
3 | Full |
4 | Full-NonLiner |
- It must be Full-Screen Mode (Player Window Size).
- It still depends on Aspect-Ratio Setting and video stream Aspect-Ratio. So you will see different result between video stream and different Aspect-Ratio Setting.
2.2.15 Get System Contrast Value
DescriptionGet System Contrast Value
Property
stb.contrast
Value
1~20
PS: get value only, set this value will be nothing happened.
2.2.16 Increase/Decrease System Contrast Value
DescriptionIncrease/Decrease System Contrast Value
Function
stb.contrast_add(var operation)
Parameter
[operation]
-1:Decrease
1:Increase
Return Value
true: Success
false: Fail
2.2.17 Get System Brightness Value
DescriptionGet System Brightness Value
Property
stb.brightness
Value
1~20
PS: get value only, set this value will be nothing happened.
2.2.18 Increase/Decrease System Brightness Value
DescriptionIncrease/Decrease System Brightness Value
Function
stb.brightness_add(var operation)
Parameter
[operation]
-1:Decrease
1:Increase
Return Value
true: Success
false: Fail
2.2.19 Get System Sharptness Value
DescriptionGet System Sharpness Value
Property
stb.sharpness
Value
1~20
PS: get value only, set this value will be nothing happened.
2.2.20 Increase/Decrease System Sharpness Value
DescriptionIncrease/Decrease System Sharpness Value
Function
stb.sharpness_add(var operation)
Parameter
[operation]
-1:Decrease
1:Increase
Return Value
true: Success
false: Fail
2.2.21 Get System Saturation Value
DescriptionGet System Saturation Value
Property
stb.saturation
Value
1~20
PS: get value only, set this value will be nothing happened.
2.2.22 Increase/Decrease System Saturation Value
DescriptionIncrease/Decrease System Saturation Value
Function
stb.saturation_add(var operation)
Parameter
[operation]
-1:Decrease
1:Increase
Return Value
true: Success
false: Fail
2.2.23 Get System Hue Value
DescriptionGet System Hue Value
Property
stb.hue
Value
1~20
PS: get value only, set this value will be nothing happened.
2.2.24 Increase/Decrease System Hue Value
DescriptionIncrease/Decrease System Hue Value
Function
stb.hue_add()
Parameter
-1:Decrease
1:Increase
Return Value
true: Success
false: Fail
2.2.25 Save Current Volume to Configuration
DescriptionSave Current Volume Value to Configuration
Function
stb.save_vol()
Parameter
Nothing
Return Value
true: Success
false: Fail
2.2.26 Save Current OSD Setting to Configuration
DescriptionSave Current OSD Value to Configuration
[DisplayMode/Outputtype/Aspect/ContentMode/Contrast/Brightness/Sharpness/Saturation/Hue and so on.]
Function
stb.save_osd()
Parameter
Nothing
Return Value
true: Success
false: Fail
CAUTION: You “MUST” call this function to save setting after you set up [DisplayMode/Outputtype/Aspect/ContentMode/Contrast/Brightness/Sharpness/Saturation/Hue/Volume]
2.2.27 Get/Set Internal Key Process Function Switch
DescriptionGet/Set Internal key process function switch
Property
stb.disableinternalkey
Value
True: Disable internal key process function
False: Enable internal key process function(Default)
2.2.28 Set STB event callback
DescriptionSet STB event callback(HDMI/Power)
Property
stb.onevent
Value
Function name(string)
For example:
function stbevt(eventtype)
{
switch(eventtype)
{
case 0://Standby
break;
case 1://Resume from Standby
break;
case 2://HDMI plugged
break;
case 3://HDMI unplugged
break;
}
}
stb.onevent=”stbevt”;
2.3 System Control
2.3.1 Reboot STB
DescriptionForce STB to reboot
Function
stb.reboot()
Parameter
Nothing
Return Value
true: Success
false: Fail
2.3.2 StandBy STB
DescriptionForce STB to enter Stand-By Mode
Function
stb.standby()
Parameter
Nothing
Return Value
true: Success
false: Fail
2.3.3 Restore Default Settings
DescriptionRestore the Default System Settings
Function
stb.restoreDefault()
Parameter
Nothing
Return Value
true: Success
false: Fail
2.3.4 NTP Update
DescriptionNTP Update
Function
stb.ntpUpdate()
2.3.5 Cancel NTP Update
DescriptionCancel NTP Update
Function
stb.cancelNTPUpdate()
2.3.6 Get NTP Update Status
DescriptionGet NTP Update Status
Property
stb.ntpUpdateStatus
Value
-1: NTP Update Fail
1: Connecting to NTP server
2: NTP Update Success
2.3.7 Set System Time
DescriptionSet System Time
Function
stb.setSystemTime(var Year, var Month, var Date, var Hour, var Minute, var Second)
2.3.8 Upgrade Firmware
DescriptionUpgrade Firmware
Function
stb.fwUpgrade(var Source)
Parameter
1 | Upgrade form Network |
2 | Upgrade from USB |
2.3.9 Cancel Upgrade Firmware
DescriptionCancel Upgrade Firmware
Function
stb.cancelFWUpgrade()
Note: For system protection, this function only works before writing firmware.
2.3.10 Get Firmware Upgrade Status
DescriptionGet Firmware Upgrade Status
Property
stb.fwUpgradeStatus
Value
0 | FWUP_UNKNOW_STATUS |
1 | FWUP_WAIT_STATUS |
2 | FWUP_BUSY_STATUS |
3 | FWUP_DOWNLOAD_START |
4 | FWUP_DOWNLOAD_FINISH |
5 | FWUP_INFO_DOWNLOAD_START |
6 | FWUP_INFO_DOWNLOAD_FINISH |
7 | FWUP_WRITE_START |
8 | FWUP_WRITE_FINISH |
9 | FWUP_DOWNLOAD_FAIL |
10 | FWUP_INFO_DOWNLOAD_FAIL |
11 | FWUP_WRITE_FAIL |
12 | FWUP_RAMDISK_FAIL |
13 | FWUP_USB_FAIL |
14 | FWUP_FIRM_FILE_FAIL |
15 | FWUP_URL_FILE_FAIL |
16 | FWUP_INFO_FILE_FAIL |
17 | FWUP_EXECMD_FAIL |
18 | FWUP_FIRM_MD5_FAIL |
19 | FWUP_USER_CANCEL |
2.3.11 Get Rate of Firmware Download Progress
DescriptionGet Rate of Firmware Download Progress
Property
stb.fwUpgradeDownloadPercent
Value
0 ~ 100
2.3.12 Upgrade Daylight Saving Configuration file
DescriptionUpgrade DST (Daylight Saving Time) configuration file
Function
stb.dstConfigUpdate(var URL)
Parameter
The full url of DST configuration file.
2.3.13 Control LED Status
DescriptionControl LED State
Function
stb.setled(var led_index ,var state_index)
Parameter
[led_index] (PS: Network LED can’t controlled)
0:Power LED
[state_index]
0:OFF
1:ON
Return Value
true:Success
false:Fail
2.3.14 Log Message to System Log
DescriptionWrite message to System Log File for analyze.
Function
stb.log(var txt_message)
Return Value
true:Success
false:Fail
2.3.15 Print Message to Console Port
DescriptionWrite message to Console Window.
(You must have console port connected)
Function
stb.print(var txt_message)
Return Value
true:Success
false:Fail
2.4 Software Environment
2.4.1 Get OS Version
DescriptionGet OS Version of STB
Property
software.osVersion
2.4.2 Get Browser Version
DescriptionGet Browser Version of STB
Property
software.browserVersion
2.4.3 Get Firmware Version
DescriptionGet Firmware Version of STB
Property
software.firmwareVersion
2.5 Networking
2.5.1 Get/Set Network Mode
DescriptionGet/Set Network Mode of STB (STATIC/DHCP)
Property
network.netmode
Value
0 | Static IP |
1 | DHCP |
2 | PPPoE |
2.5.2 Get IP Address
DescriptionGet IP Address of STB
Property
network.netip
2.5.3 Get Subnet Mask
DescriptionGet Subnet Mask of STB
Property
network.netmask
2.5.4 Get Gateway
DescriptionGet Gateway of STB
Property
network.netgateway
2.5.5 Get/Set DNS
DescriptionGet/Set DNS Server’s IP Address of STB
Property
network.netdns
network.netdns2
2.5.6 Set IP Address
DescriptionSet IP Address of STB
Function
network.netsetup(var ip, var netmask, var gateway, var dns)
network.netsetup(var ip, var netmask, var gateway, var dns, var dns2)
Parameter
[ip/netmask/gateway/dns/dns2]
Type:String ex: (192.168.1.254)
2.5.7 Get/Set Subscriber’s PPPoE User’s ID
DescriptionGet/Set Subscriber’s PPPoE User’s ID
Property
network.pppoeUserName
2.5.8 Get/Set Subscriber’s PPPoE Password
DescriptionGet/Set Subscriber’s PPPoE Password
Property
network.pppoePassword
2.5.9 Get/Set Network IGMP version
DescriptionGet/Set Network IGMP Version
Property
network.igmp
Value
1 | IGMP v1 |
2 | IGMP v2 |
3 | IGMP v3 |
2.5.10 Get/Set Network multicast Timeout Value
DescriptionGet/Set multicast timeout value
Property
network.iptvtimeout
Value
Number
0-use default value
2.6 Browser
2.6.1 Get/Set URL of Home Page
DescriptionGet/Set Home Page URL When Browser is Start-up
Property
webbrowser.homepage
2.6.2 Get/Set URL of Configuration Page
DescriptionGet/Set Configuration page URL of STB
Property
webbrowser.configpage
2.6.3 Get/Set URL of VOD Server
DescriptionGet/Set URL of VOD Server
Property
webbrowser.vodServer
Value
A string (ex:http://vod.testmedia.com/vod1/vod.htm)
2.6.4 Get/Set URL of IPTV Server
DescriptionGet/Set URL of IPTV Server
Property
webbrowser.iptvServer
Value
A string (ex: http://iptv.testmedia.net/iptv2/iptv.htm)
2.6.5 Get/Set URL of DVB Server
DescriptionGet/Set URL of DVB Server
Property
webbrowser.dvbServer
Value
A string (ex:file:///home/root/abc.htm)
2.6.6 Get/Set URL of PVR Server
DescriptionGet/Set URL of PVR Server
Property
webbrowser.pvrServer
Value
A string (ex:file:///home/root/abc.htm)
2.6.7 Get/Set URL of STB startup page
DescriptionGet/Set URL of startup page when STB boot up.
Property
webbrowser.mainpage
Value
A URL string (ex:file:///home/root/abc.htm)
2.6.8 Get/Set Configuration of HTTP Proxy
DescriptionGet/Set Configuration of HTTP Proxy
Property
webbrowser.enableProxy
Value
0: Disable
1: Enable
2.6.9 Get/Set Configuration of HTTPS Proxy
DescriptionGet/Set Configuration of HTTPS Proxy
Property
webbrowser.enableSecureProxy
Value
0: Disable
1: Enable
2.6.10 Get/Set URL of HTTP Proxy Server
DescriptionGet/Set URL of HTTP Proxy Server
Property
webbrowser.httpProxy
Value
URL:port
2.6.11 Get/Set HTTP Proxy Exception Address
DescriptionGet/Set HTTP Proxy Exception Address
Property
webbrowser.exceptionAddr
2.6.12 Get/Set URL of HTTPS Proxy Server
DescriptionGet/Set URL of HTTPS Proxy Server
Property
webbrowser.secureProxy
Value
URL:port
2.6.13 Get/Set HTTPS Proxy Exception Address
DescriptionGet/Set HTTP Proxy Exception Address
Property
webbrowser.httpsDirectAccess
2.6.14 Get/Set XMLHttpRequest Same Origin Policy
DescriptionSet XMLHttpRequest Same Origin Policy
CAUTION: This is a global setting. According security purpose, don’t change it to disabled (0). But in special case, maybe you will need to disable this policy temporarily.
Property
stb.xmlhttprequest
Value
0 | Ignore Same Origin |
1 | Limit Same Origin |
2.6.15 Set Browser Position
DescriptionSet browser window position and size.
Function
webbrowser. setposition (var x , var y , var width , var height)
Parameter
x: horizontal offset.
y: vertical offset.
width: window width.
height: window height.
Return Value
true | Success |
false | Fail |
2.7 Audio & Video Playback
2.7.1 Get Audio Volume
DescriptionGet Audio Volume Value
Property
stb.vol
Value
0~20
2.7.2 Set Audio Volume Up
DescriptionSet Audio Volume Up
Function
stb.volup()
Parameter
Nothing
Return Value
true: Success
false: Fail
2.7.3 Set Audio Volume Down
DescriptionSet Audio Volume Down
Function
stb.voldown()
Parameter
Nothing
Return Value
true: Success
false: Fail
2.7.4 Mute Audio
DescriptionMute Audio
Function
stb.mute()
Parameter
Nothing
Return Value
true: Success
false: Fail
2.8 DVB
2.8.1 Get DVB Module Type
DescriptionGet DVB Tuner Type
Property
dvb.dvb_type
Value
0 | DVB-T |
1 | DVB-C |
2 | DVB-S |
2.8.2 Play DVB Channel by Channel ID
DescriptionPlay DVB Channel By DVB Channel ID.
CAUTION: Channel Id is an internal unique identification number and this is not equal to “Channel Number”.
Function
dvb.play_channel(var ch_id)
Parameter
[ch_id]:DVB Channel ID.
Return Value
true: Success
false: Fail
2.8.3 DVB Channel Up
DescriptionDVB Channel Up (Switch DVB Channel to Next DVB Channel)
Function
dvb.channel_up()
Parameter
Nothing
Return Value
true: Success
false: Fail
PS: This function can only work when DVB Channel is playing, so you must play one channel already and call this function to switch DVB channel
2.8.4 DVB Channel Down
DescriptionDVB Channel Down (Switch DVB Channel to Previous DVB Channel)
Function
dvb.channel_down()
Parameter
Nothing
Return Value
true: Success
false: Fail
PS: This function can only work when DVB Channel is playing, so you must play one channel already and call this function to switch DVB channel
2.8.5 Get DVB Channel Object Collection
DescriptionGet DVB Channels Collection
Property
dvb.channels
2.8.6 Get DVB Channel Object of Channel Object Collection
DescriptionGet DVB Channel Object
Property
dvb.channels[var array_idx]
[array_idx]:Decimal No. (0 or positive)
Return Value
A DVB Channel Object
2.8.7 Get DVB Program Object Collection of Channel
DescriptionGet DVB Programs Collection of Channel
Property
dvb.channels[var array_idx].progs
[array_idx]:Decimal No. (0 or positive)
2.8.8 Get DVB Program Object of Channel’s Program Object Collection
DescriptionGet DVB Program Object
Property
dvb.channels[var array_idx].progs[var array_idx]
[array_idx]:Decimal No. (0 or positive)
Return Value
A DVB Program Object
2.8.9 A DVB Channel Object
DescriptionA DVB Channel Object
Property
[ch_no]:Positive Decimal No.
[ch_id]:An unique internal identification number.
[ch_name]:A Channel Name String(UTF8-Encoding)
[progs]:A DVB Program Cbject Collection
[isradio]:A audio-only channel or not.
[isplaying]:
This Channel is now playing or not. (true or false)
2.8.10 A DVB Program Object
DescriptionA DVB Program Object
Property
[ch_no]:
Channel ‘s Channel Number of this Program
[ch_name]:
The Program Name String (UTF8-Encoding)
[desc]:
The Program Information String (UTF8-Encoding)
[isnowprogram]:
This Program is now program or not (true or false)
[isvalid]:This Program is valid or not(true or false)
(EX: false-Expired/Other special purpose)
[starttime]:
Program Start Time (Time Unit: Seconds)
[proglength]:
Program Length (Time Unit: Minutes)
CAUTION:
In JavaScript, base time unit is 1/1000 Secs (Not 1 sec)
So if you want to calculate time or show time information you must notice this difference and convert between them!!
2.8.11 Get DVB Scheduled-Record Channel Id within 2 minutes
DescriptionGet a Channel Id that will start to record within 2 minutes.
Property
dvb.schprepare_ch_id
Value
0 | No Channel Id |
>0 | Valid Channel Id |
2.9 Middleware Relative Management Functions
2.9.1 Player Control Functions
2.9.1.1 Play
DescriptionPlays the content, specified by the src string
Function
stb_media.play(var src)
Parameter
src: Protocol– RTSP:// UDP://
Return
Returns 0 if the operation is successful, -1 if the operation is failed
2.9.1.2 Pause
DescriptionStops the playback. The last frame is displayed on the screen.
Function
stb_media.pause()
Return
No return value
2.9.1.3 Stop
DescriptionStops the playback and clears the screen.
Function
stb_media.stop()
Return
No return value
2.9.1.4 Continue
DescriptionResume the video stream playback from the stop position.
Function
stb_media.continuePlay()
Return
No return value
2.9.1.5 Set Position
DescriptionSet position based on the stream start position (in seconds).
Function
stb_media.setPosition(var position)
Parameter
position: integer (position in seconds)
Return
Returns 0 if the operation is successful, -1 if the operation is failed
Note
l This function only avoid when playing
2.9.1.6 Get Position
DescriptionGet the current position based on the stream start position.
Function
stb_media.getPosition()
Return
Returns the current position based on the stream start position (in seconds).
Note
l This function only avoid when playing
2.9.1.7 Set Speed
DescriptionSpecifies the stream playback speed.
Function
stb_media.setSpeed(var speed)
Parameter
speed: integer (1/4/12)
Return
Returns 0 if the operation is successful, -1 if the operation is failed
Note
l This function only avoid when playing
2.9.1.8 Get Speed
DescriptionGet the current stream playback speed.
Function
stb_media.getSpeed()
Return
Returns the current stream playback speed.
Note
l This function only avoid when playing
2.9.1.9 Set Audio PID
DescriptionSets the audio PID (for multi-language broadcast).
Function
stb_media.setAudioPID(var audioPID)
Parameter
audioPID: integer
Return
Returns 0 if the operation is successful, -1 if the operation is failed
Note
l This function only valid when playing
2.9.1.10 Get Audio PID
DescriptionGet the current audio PID.
Function
stb_media.getAudioPID()
Return
Returns the current used audio PID.
Note
l This function only valid when playing
2.9.1.11 Get Audio PIDs List
DescriptionGet the audio PIDs list of stream.
Function
stb_media.getAudioPIDS()
Return
Returns the string of audio PID list. ( separate by ‘,’)
Example:
10,80,69,122
Note
l This function only valid when playing
2.9.1.12 Set Volume
DescriptionSets the volume.
Function
stb_media.setVolume(var volume)
Parameter
volume: integer (range: 0~100)
Return
No return value
2.9.1.13 Get Volume
DescriptionGet the current volume level.
Function
stb_media.getVolume()
Return
Returns the current volume level.
2.9.2 SCREEN FUNCTIONS
2.9.2.1 Set PIG
DescriptionSet video display mode and location.
Function
stb_media.setPIG(var state)
stb_media.setPIG(var state, var width, var height, var x, var y)
Parameter
state: true for window mode; false for full-screen mode
width, height, x, and y are available for window mode only.
width: window width, maximum value is 1920.
height: window height, maximum value is 1080.
x: horizontal offset, maximum value is 1920.
y: vertical offset, maximum value is 1080.
Return
No return value.
2.9.2.2 Get PIG
DescriptionGet video display mode.
Function
stb_media.getPIG()
Return
Returns true if the video is displayed in window mode, or returns false if the video is displayed in full-screen mode.
2.9.2.3 Set Transparency Level
DescriptionSet the transparency level.
Function
stb_media.setAlphaLevel(var level)
Parameter
level: integer. Range 0~255
Return
No return value.
2.9.2.4 Get Transparency Level
DescriptionGet the current transparency level.
Function
stb_media.setAlphaLevel()
Return
Return the current transparency level.
2.9.2.5 Set Transparency Color
DescriptionSet the color that is considered as transparent.
Function
stb_media. setTransparentColor(var color)
Parameter
color:
Format :0xAARRGGBB
EX: Red-0xFFFF0000
Green-0xFF00FF00
Blue-0xFF0000FF
Return
No return value.
Note
If change transparent color when page loaded and images not change, you need force redraw to apply the setting. Omit forceRedraw parameter for other cases.
2.9.2.6 Get Transparency Color
DescriptionGet the color that is currently considered as transparent.
Function
stb_media.getTransparentColor()
Return
Return the color in the form of 0x00rrggbb that is currently considered as transparent. Return 0xFF000000 if no color consider as transparent.
2.9.3 MEDIA EVENTS MANAGEMENT
2.9.3.1 Get Media Event Code
DescriptionGet the variable contain the code of the last media event occured.
Property
stb_media.eventCode
Value
0 | Stopped | |
1 | Error | |
2 | EOF | Except DIB-150 |
3 | Buffering | (when play command sent but not playing yet) |
4 | Playing | Except DIB-150 |
5 | Paused | |
6 | Stopping | (when stop command sent but not stopped yet) |
102 | VOD End Of Stream | Only for DIB-150 |
202 | IPTV End Of Stream | Only for DIB-150 |
302 | DVB End Of Stream | Only for DIB-150 |
104 | VOD Playing | Only for DIB-150 |
204 | IPTV Playing | Only for DIB-150 |
304 | DVB Playing | Only for DIB-150 |
Комментариев нет:
Отправить комментарий