getURL()

可用性

Flash Lite 1.0。

用法

getURL(url [ , window [, "variables"]])

Operands

url 可从其获取文档的 URL。

window 可选参数,它指定应将文档加载到其中的窗口或 HTML 框架。

注意

window 参数不是为 Flash Lite 应用程序指定的,因为手机上的浏览器不支持多个窗口。

您可以输入空字符串或特定窗口的名称,或者从下面的保留目标名称中选择:

variables 用于发送变量的 GETPOST 方法。如果没有变量,则省略此参数。GET 方法将变量追加到 URL 的末尾,它用于发送少量的变量。POST 方法在单独的 HTTP 标头中发送变量,它用于发送大量的变量。

说明

函数;将来自特定 URL 的文档加载到窗口中,或将变量传递到位于所定义 URL 的另一个应用程序。要测试此函数,请确保要加载的文件位于指定的位置。要使用绝对 URL(例如 http://www.myserver.com),则需要网络连接。

Flash Lite 1.0 仅识别 HTTP、HTTPS、mailto 和 tel 协议。Flash Lite 1.1 除了识别这几种协议外,还能识别 file、SMS(短消息服务)和 MMS(多媒体消息服务)协议。

Flash Lite 将调用传递到操作系统,而操作系统会用指定协议的已注册的默认应用程序处理该调用。

每一帧或每个事件处理函数只能处理一个 getURL() 函数。

某些手机将 getURL() 函数限制为仅处理按键事件。在这种情况下,只有在按键事件处理函数中触发了 getURL() 调用时,才会处理它。即使在这种情况下,每个事件处理函数也只能处理一个 getURL() 函数。

示例

在下面的 ActionScript 中,Flash Lite 播放器会在默认的浏览器中打开 mobile.example.com:

myURL = "http://mobile.example.com";
 on(keyPress "1") {
    getURL(myURL);
}

您也可以使用 GETPOST 从当前时间轴中发送变量。以下示例使用 GET 方法向 URL 中追加变量:

firstName = "Gus";
lastName = "Richardson";
age = 92;
getURL("http://www.example.com", "_blank", "GET");

下面的 ActionScript 使用 POST 在 HTTP 标头中发送变量:

firstName = "Gus";
lastName = "Richardson";
age = 92;
getURL("http://www.example.com", "POST");

可以分配一个按钮函数来打开一个 addresssubjectbody 文本字段已填充的电子邮件合成窗口。使用以下方法之一可以分配一个按钮函数:方法 1 用于 Shift-JIS 或英文字符编码;方法 2 仅用于英文字符编码。

方法 1:为每个需要的参数设置变量,如本例所示:

on (release, keyPress "#"){
subject = "email subject";
body = "email body";
getURL("mailto:somebody@anywhere.com", "", "GET");
}

方法 2:在 getURL() 函数内定义每个参数,如本例所示:

on (release, keyPress "#"){
getURL("mailto:somebody@anywhere.com?cc=cc@anywhere.com&bcc=bcc@anywhere.
com&subject=I am the email subject&body=I am the email body");
}

方法 1 生成自动 URL 编码,而方法 2 保留字符串中的空格。例如,使用方法 1 生成的字符串如下所示:

email+subject
email+body

与此相对照,方法 2 生成以下字符串:

email subject
email body

以下示例使用 tel 协议:

on (release, keyPress "#"){
    getURL("tel:117");
}

在以下示例中,getURL() 用于发送 SMS 消息:

mySMS = "sms:4156095555?body=sample sms message";
on(keyPress "5") {
    getURL(mySMS);
}

在以下示例中,getURL() 用于发送 MMS 消息:

// mms 示例
myMMS = "mms:4156095555?body=sample mms message";
on(keyPress "6") {
    getURL(myMMS);
}

在以下示例中,getURL() 用于打开存储在本地文件系统上的文本文件:

// file 协议示例
filePath = "file://c:/documents/flash/myApp/myvariables.txt";
on(keyPress "7") {
    getURL(filePath);
}