GPSystem类

在ECMAScript术语中，GPSystem实际上是GlobalPlatform脚本语言的本机对象，所有脚本在任何时候都可以使用它。GPSystem对象仅作为GPSystem可用，不可实例化或由任何其他方法创建。

GPSystem表示通用系统功能，根据主机环境的能力，这些功能可能适用于所有脚本。

Constants常量

无

Properties成员属性

无

Static Methods静态成员方法

dateTimeByteString()

原型：

ByteString dateTimeByteString()

返回包含当前数据和时间的ByteString对象。结果将有七个字节长，并包含如下格式的日期和时间：

字节0和1：年份为四个BCD数字，范围为0x2001到0x9999。

字节2：月份为两个BCD数字，范围为0x01至0x12。

字节3：两个BCD数字的月份日期，范围为0x01到0x31。

字节4：小时为两个BCD数字，范围为0x00至0x23。

字节5：分钟为两个BCD数字，范围为0x00至0x59。

字节6：第二个为两个BCD数字，范围为0x00至0x59。

Arguments参数

Returns返回

Exceptions异常

Example示例

try
{
    bs = GPSystem.dateTimeByteString();
    Print("GPSystem.dateTimeByteString() : " + bs.toString(ASCII));
}
catch (e)
{
    Print("Exception : " + e.className + "," + e.error + "," + e.reason + "," + e.message);
}

getSystemID()

原型：

ByteString getSystemID()

返回依赖于供应商的系统ID值。如果没有可用的，则可以为null。

Arguments参数

Returns返回

Exceptions异常

Example示例

try
{
    bs = GPSystem.getSystemID();
    Print("GPSystem.getSystemID() : " + bs.toString(ASCII));
}
catch (e)
{
    Print("Exception : " + e.className + "," + e.error + "," + e.reason + "," + e.message);
}

getVersion()

原型：

ByteString getVersion()

以字符串形式检索脚本解释器实现的GlobalPlatform脚本的版本。这与XML概要文件的版本不同。后者的信息可以通过在XML文档中导航适当的属性来获得。

这是GP脚本解释器在执行脚本时使用的规范版本。例如，对于为支持此规范而编写的脚本解释器，GPSystem.getVersion()方法将返回包含“1.1.0”的ASCII编码字符串。

返回的版本可能包含第四个数字，指定脚本解释器中实现的勘误表的版本。如果第四个数字为零，则执行了没有任何勘误表的原始规范。如果未返回此数字，则说明解释器未实现规范的勘误表。

Arguments参数

Returns返回

Exceptions异常

Example示例

try
{
    bs = GPSystem.getVersion();
    Print("GPSystem.getVersion() : " + bs.toString(ASCII));
}
catch (e)
{
    Print("Exception : " + e.className + "," + e.error + "," + e.reason + "," + e.message);
}

trace()

原型：

Boolean trace(Object traceData)

使用ECMAScript方法toString()将数据作为字符串附加到特定于供应商的跟踪文件中，该字符串包含在traceData指定的对象中。在GPTS脚本语言系统中，该功能属于扩展功能，目前版本未支持。

Arguments参数

Returns返回

Exceptions异常

Example示例

try
{
    GPSystem.trace("wait 2000 ms start...........");
    GPSystem.wait(2000);
    GPSystem.trace("wait 2000 ms end...........");
}
catch (e)
{
    Print("Exception : " + e.className + "," + e.error + "," + e.reason + "," + e.message);
}

wait()

原型：

wait(Number value)

暂停一段时间（单位：毫秒）。

Arguments参数

Returns返回

Exceptions异常

Example示例

try
{
    bs = GPSystem.dateTimeByteString();
    Print("Start Time : " + bs.toString(ASCII));

    GPSystem.wait(2000);

    bs = GPSystem.dateTimeByteString();
    Print("End Time : " + bs.toString(ASCII));
}
catch (e)
{
    Print("Exception : " + e.className + "," + e.error + "," + e.reason + "," + e.message);
}