平台相关指令::日期和时间
GetDateDay()
status = FSCommand2( “GetDateDay” )
获得当前的日期(1-31)。
返回 -1 为不支持,支持则返回 1-31 之间的数字。
GetDateMonth()
status = FSCommand2( “GetDateMonth” )
获得当前的月份(1-12)。
返回 -1 为不支持,支持则返回 1-12 之间的数字。
GetDateWeekday()
status = FSCommand2( “GetDateWeekday” )
获得当前的月份(0-6)。
返回 -1 为不支持,支持则返回 0-6 之间的数字。
GetDateYear()
status = FSCommand2( “GetDateYear” )
获得当前的年份。
返回 -1 为不支持,支持则返回数字,如:2005。
GetLocaleLongDate()
status = FSCommand2( “GetLocaleLongDate”, “longdate” )
获取当前的长日期串。日期格式根据手机本身以及 Locale 来确定。日期值指向到一个字串。
返回 -1 为不支持,0 则为支持。
以下是两个返回的 longdate 的例子:
October 16, 2004
16 October 2004
GetLocaleShortDate()
status = FSCommand2( “GetLocaleShortDate”, “shortdate” )
获取当前的短日期串。日期格式根据手机本身以及 Locale 来确定。日期值指向到一个字串。
返回 -1 为不支持,0 则为支持。
以下是两个返回的 shortdate 的例子:
10/16/2004
16-10-2004
GetLocaleTime()
status = FSCommand2( “GetLocalTime”, “time” )
获取当前的时间串。时间格式根据手机本身以及 Locale 来确定。时间值指向到一个字串。
返回 -1 为不支持,0 则为支持。
以下是两个返回的 time 的例子:
6:10:44 PM
18:10:44
GetTimeHours()
status = FSCommand2( “GetTimeHours” )
获得当前的小时(0-23)。
返回 -1 为不支持,支持则返回 0-23 之间的数字。
GetTimeMinutes()
status = FSCommand2( “GetTimeMinutes” )
获得当前的分钟(0-59)。
返回 -1 为不支持,支持则返回 0-59 之间的数字。
GetTimeSeconds()
status = FSCommand2( “GetTimeSeconds” )
获得当前的秒(0-59)。
返回 -1 为不支持,支持则返回 0-59 之间的数字。
GetTimeZoneOffset()
status = FSCommand2( “GetTimeZoneOffset”, “timezoneoffset” )
获取当前的时差数。时差值指向到一个数字,单位为秒。
返回 -1 为不支持,0 则为支持。
以下是两个返回的 timezoneoffset 的例子:
540: Japan standard time
-420: Pacific daylight savings time
平台相关指令::音量
GetMaxVolumeLevel()
status = FSCommand2( “GetMaxVolumeLevel” )
获取系统最大音量。
返回 -1 为不支持,支持则返回一个数字。
GetVolumeLevel()
status = FSCommand2( “GetVolumeLevel” )
获取系统当前音量。
返回 -1 为不支持,支持则返回一个数字。
平台相关指令::震动
StartVibrate()
status = FSCommand2( “StartVibrate”, time_on, time_off, repeat )
设定手机震动,time_on 为开始时间,time_off 为停止时间, repeat 为重复次数。time_on 和 time_off 均为百分秒,并且不超过 5 秒。
返回 -1 为不支持,0 为目前正在震动,1 为出现错误。
StopVibrate()
status = FSCommand2( “StopVibrate” )
停止震动。
返回 -1 为不支持,0 为停止成功。
平台相关指令::电源
GetBatteryLevel()
status = FSCommand2( “GetBatteryLevel” )
获得电量。
返回 -1 为不支持,支持则返回一个数字。
GetMaxBatteryLevel()
status = FSCommand2( “GetMaxBatteryLevel” )
获得最大电量。
返回 -1 为不支持,支持则返回一个数字。
GetPowerSource()
status = FSCommand2( “GetPowerSource” )
获取供电方式。
返回 -1 为不支持,0 为目前在使用电池供电,1 为目前在使用外部电源供电。
平台相关指令::网络信息
GetMaxSignalLevel()
status = FSCommand2( “GetMaxSignalLevel” )
获取最大信号强度值。
返回 -1 为不支持,支持则返回一个数字。
GetNetworkConnectStatus()
status = FSCommand2( “GetNetworkConnectStatus” )
获取当前网络状态。
返回 -1 为不支持,其它则为
0:在网络连接状态;
1:正在试图连接网络;
2:无可用网络连接;
3:网络连接暂停状态;
4:无法判断状态。
GetNetworkName()
status = FSCommand2( “GetNetworkName”, “networkname” )
获取连接网络的名称,返回值指向一个字串。
返回 -1 为不支持,其它则为
0:未连接网络;
1:连接网络,但是无法获取名称;
2:成功。
返回的 networkname 的例子:
AT&T Wireless
KPN Mobile
GetNetworkRequestStatus()
status = FSCommand2( “GetNetworkRequestStatus” )
获取网络请求状态。
返回 -1 为不支持,其它则为
0:等待中,网络连接已经成功,主机名已经解析,服务器也已经连接;
1:等待中,网络连接已经成功;
2:等待中,但是网络连接尚未成功;
3:等待中,连接已经成功,主机名已经解析;
4:失败,网络连接错误;
5:失败,连接服务器失败;
6:服务器返回 404 错误;
7:失败,无法连接 DNS 服务器或者无法解析主机名称;
8:请求成功完成;
9:请求超时;
10:尚未执行请求。
GetNetworkStatus()
status = FSCommand2( “GetNetworkStatus” )
获取网络状态。
返回 -1 为不支持,其它则为
0:无网络;
1:在本地网络;
2:在本地扩展网络;
3:漫游。
GetSignalLevel()
status = FSCommand2( “GetSignalLevel” )
获取当前信号强度值。
返回 -1 为不支持,支持则返回一个数字。
平台相关指令::用户设备信息
GetLanguage()
status = FSCommand2( “GetLanguage”, “language”)
获取用户设备使用的语言,返回值指向一个字串。
返回 -1 为不支持,0 则为支持。
返回的 language 值:
cs: Czech.
da: Danish.
de: German.
en-UK: UK or international English.
en: USA English.
es: Spanish.
fi: Finnish.
fr: French.
hu: Hungarian.
it: Italian.
jp: Japanese.
ko: Korean.
nl: Dutch.
no: Norwegian.
pl: Polish.
pt: Portuguese.
ru: Russian.
Platform integration commands 45
sv: Swedish.
tr: Turkish.
xu: The language cannot be determined.
zh-CN: Simplified Chinese.
zh-TW: Traditional Chinese.
平台相关指令::用户设备及播放器标识
GetDeviceID()
status = FSCommand2( “GetDeviceID”, “id” )
获取设备的 ID,返回值指向一个字串。
返回 -1 为不支持,0 则为支持。
GetPlatform()
status = FSCommand2( “GetPlatform”, “platform” )
获取设备的操作系统平台,返回值指向一个字串。
返回 -1 为不支持,0 则为支持。
返回的 paltform 例子:
506i
FOMA1
GetDevice()
status = FSCommand2( “GetDevice”, “device” )
获取设备的型号,返回值指向一个字串。
返回 -1 为不支持,0 则为支持。