Authorware类和函数:authorware7.0函数教学文章连载--Network类

bandwidth

语法：rate:=bandwidth（selector）

说明：返回预读取或下载数据的速度，单位为字节／秒。参数selector用于选择返回何种速度，可能的取值如下：

#piece—程序被读取或下载的速度

#external—外部内容通过ineturl xtra被加载的速度

#plugin—authorware web player下载分段文件的速度

gotonetpage

语法：gotonetpage（"url" [，"windowtype"]）

说明：打开指定的url地址，可以是进行网络打包的authorware程序，也可以是mime类型的地址。参数 "windowtype" 可能的取值如下：

_self—使用当前的浏览器窗口并退出当前程序（默认情况）

_blank—保持现在的窗口，在另一个浏览器窗口中显示url的内容

此函数只能在由authorware web player运行的程序中使用。

netabort

语法：result:=netabort（netid）

说明：中断由netid指定的下载操作。返回值小于0表示出现错误，关于详细的错误信息请参阅系统函数neterror。该函数只能用于由authorware web player运行的程序中。

netdownload

语法：string:=netdownload（"url"）

说明：将指定url中的文件下载到本地硬盘，并返回本地存储位置：路径及文件名。该函数将文件下载至map文件中put行所指定的位置。如果map文件中没有指定存储位置，该函数将文件下载至authorware web player所在文件夹下的download文件夹中。该函数只能用于由authorware web player运行的程序中，当authorware web player在非信任模式下运行程序时将该函数禁用。

netdownloadbackground

语法：netid:=netdownloadbackground（"url" [，"filename"]）

说明：将url中指定的文件在后台下载至指定位置filename并返回一个惟一的标识netid。如果没有指定下载位置，该函数将文件下载至authorware web player所在文件夹下的download文件夹中。该函数只能用于由authorware web player运行的程序中，当authorware web player在非信任模式下运行程序时将该函数禁用。

netdownloadname

语法：filename:=netdownloadname（netid）

说明：返回由netid指定的目标文件名。如果netid无效则返回空字符串。该函数只能用于由authorware web player运行的程序中，当authorware web player在非信任模式下运行程序时将该函数禁用。

neterror

语法：errorcode:=neterror（netid）

说明：返回由netid指定的下载中出现的错误代码：

0—没有错误

–1—失败

–2—错误参数

–3—不匹配

–4—内存已满

–5—错误实例

–6—超时

–7—数据结束

–8—请求不被支持

–9—只读

–10—版本不兼容

–11—不能执行

–12—系统忙

–13—违反安全性

–14—文件丢失或出错

–15—无效的netid

该函数只能用于由authorware web player运行的程序中，当authorware web player在非信任模式下运行程序时将该函数禁用。

netfilesize

语法：size:=netfilesize（"url" [，time-out]）

说明：返回指定url中内容的大小，单位为字节。如果url不存在或发生错误，该函数返回–1。参数time-out用于设置超时时间，默认值为30秒。该函数只能用于由authorware web player运行的程序中。当authorware web player在非信任模式下运行程序时对不安全的协议会将该函数禁用。

netlastmoddate

语法：result:=netlastmoddate（"url" [，time-out] [，format]）

说明：返回特定url最近一次被修改的日期。参数time-out用于设置超时时间，默认值为30秒。参数format指定返回的日期格式：

0—本地时间（默认值）

1—从格林威治时间1900年1月1日起的天数

如果url不存在或发生错误，该函数返回""（如果format=0）或–1（如果format=1）。 该函数只能用于由authorware web player运行的程序中。当authorware web player在非信任模式下运行程序时对不安全的协议会将该函数禁用。

netpercentdone

语法：progress:=netpercentdone（netid）

说明：返回由netid指定的下载过程的进度。在下载完毕后该函数返回100。该函数只能用于由authorware web player运行的程序中，当authorware web player在非信任模式下运行程序时将该函数禁用。

netpreload

语法：result:=netpreload（iconid@"icontitle"）

说明：启动包含指定设计图标的程序段的异步传输。该函数只能用于由authorware web

 player运行的程序中。

posturl

语法：string:=posturl（"url"，"content" [，time-out]）

说明：将指定内容粘贴到特定的url，并返回结果字符串。参数time-out用于设置超时时间，默认值为30秒。如果不需要返回结果字符串，可以将time-out设置为“0”。该函数的执行影响到两个系统变量：iostatus和iomessage。

readurl

语法：string:=readurl（"url" [，time-out]）

说明：读取指定的url并返回文件的内容或字符串（javascript）。参数time-out用于设置超时时间，默认值为30秒。如果不需要返回结果字符串，可以将time-out设置为“0”。该函数的执行影响到两个系统变量iostatus和iomessage。如果程序通过authorware web player在非信任模式下运行，使用该函数读取本地驱动器中数据的操作将被禁止。

resetbandwidth

语法：resetbandwidth（selector）

说明：为指定的选择器清除带宽统计。参数selector标识设置何种速率，可能的取值如下：

#piece—文件被读取或下载的速率

#external—外部数据经由ineturl xtra加载的速率

#plugin—authorware web player下载分段文件的速率