http://webnoties.blog.163.com/blog/static/183525141201371593846669
刚开始学习flash as3编程,一些学习笔记也丢上来吧,现在还都是些初级的话题~
Flash 已经提供了ExternalInterface接口与JavaScript通信,ExternalInterface有两个方法,call和 addCallback,call的作用是让Flash调用js里的方法,addCallback是用来注册flash函数让js调用。下面是官方文档对 call和addCallback的说明:
利用 ActionScript,可以在 HTML 页上执行以下操作:
调用任何 JavaScript 函数。
传递任意数量、具有任意名称的参数。
传递各种数据类型(Boolean、Number、String 等等)。
接收来自 JavaScript 函数的返回值。
通过在 HTML 页上使用 JavaScript,可以:
调用 ActionScript 函数。
使用标准的函数调用表示法传递参数。
将值返回给 JavaScript 函数。
实际使用的时候,需要注意以下两点:
一、调用时机。js调用flash对象提供的函数时,可能swf还没有完全加载完,此时调用会失败。类似的,flash调用js函数时,也存在js函数还没load到的情况。所以adobe官方示例里采用了一种比较绕的逻辑来避免这种问题:
页面上有一个变量_isJSReady,初始为false。还有一个isJSReady函数用来返回_isJSReady的值,供flash调用。在合适的时机(例如:window.onload),将_isJSReady设置为true,表示flash可以使用js里的函数了;
flash里有一个定时器,定期(例如:100ms)去调用页面上的isJSReady方法,直到isJSReady返回true,就可以addCallback,调用页面上的flashReadyHandler方法,通知页面可以跟flash交互了。
二、如何获取flash对象。将flash插入到页面有很多方法,例如swfobject.js或者AC_RunActiveContent.js类似的库。我们来看一种最原始的方法,直接在html插入标记来插入flash:
- <</SPAN>object
classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" - codebase="http://download.macromedia.com/pub/shockwave/cabs
- /flash/swflash.cab#version=10,0,0,0"
width="730" height="520" - id="test"
align="middle"> - <</SPAN>param
name="allowScriptAccess" value="sameDomain" /> - <</SPAN>param
name="allowFullScreen" value="false" /> - <</SPAN>param
name="movie" value="test.swf" /> - <</SPAN>param
name="quality" value="high" /> - <</SPAN>param
name="bgcolor" value="#ffffff" /> - <</SPAN>embed
src="test.swf" quality="high" bgcolor="#ffffff" - width="730"
height="520" name="test" align="middle" allowScriptAccess="always" - allowFullScreen="false"
type="application/x-shockwave-flash" - pluginspage="http://www.adobe.com/go/getflashplayer_cn"
/> - </</SPAN>object>
假设test.swf提供了hello的方法,我们来在js里调用这个方法,代码如下:
document.getElementByIdx_x_x("test").hello();
结果,除了IE之外,其他浏览器都不会工作,会提示找不到hello这个方法。这个问题困扰了我比较久。最后发现:在非IE浏览器里,flash提供的方法是加在embed上的,我们要得到object下的embed对象,调用embed上的方法才会成功!
官方示例是采用下面方法获取flash对象的:
- function
getFlashMovieObject(movieName){ - if
(window.document[movieName]){ - return
window.document[movieName]; - }else
if (navigator.appName.indexOf("Microsoft")==-1){ - if
(document.embeds && document.embeds[movieName]) -
return document.embeds[movieName]; -
}else{ -
return document.getElementByIdx_x_x(movieName); - }
这里罗列出所有情况,当然不会有问题。其实,没必要弄得这么复杂,我们给object和embed取不同名称,例如一个test1,一个test2,如果是 IE就getElementById(“test1”),其它浏览器getElementById(“test2”)就行了。另外,如果使用js插入 swf的话,很可能js里就已经做过判断,根据不同浏览器来输出object和embed其中一种。总之,如果调用失败,首先检查得到的flash对象是不是[object HTMLEmbedElement]。
最后,放上一个例子,是我参照官方文档写的。
补充一个细节:在傲游里,刷新页面后js调用flash里的方法可能会失败。这篇文章有提到这个问题,解决方法是给swf地址加上随机数,让浏览器每次都重新加载flash。不过这样swf就不能被浏览器缓存,很无语~下面是一段判断傲游的js代码,建议只针对傲游加随机数。
- var
isMaxthon = false; -
try { - if
(external.max_language_id != undefined){ - isMaxthon
= true; - }
- }catch
(e){} -
alert(isMaxthon);
package {
import flash.display.Sprite;
import flash.events.*;
import flash.external.ExternalInterface;
import flash.text.TextField;
import flash.utils.Timer;
import flash.text.TextFieldType;
import flash.text.TextFieldAutoSize;
public class ExternalInterfaceExampleextends Sprite {
private var input:TextField;
private var output:TextField;
private var sendBtn:Sprite;
public function ExternalInterfaceExample() {
input = new TextField();
input.type = TextFieldType.INPUT;
input.background = true;
input.border = true;
input.width = 350;
input.height = 18;
addChild(input);
sendBtn = new Sprite();
sendBtn.mouseEnabled = true;
sendBtn.useHandCursor=true;
sendBtn.buttonMode=true;
sendBtn.x = input.width + 10;
sendBtn.graphics.beginFill(0xCCCCCC);
sendBtn.graphics.drawRoundRect(0, 0, 80, 18, 10, 10);
sendBtn.graphics.endFill();
sendBtn.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(sendBtn);
output = new TextField();
output.y = 25;
output.width = 450;
output.height = 325;
output.multiline = true;
output.wordWrap = true;
output.border = true;
output.text = "Initializing...\n";
addChild(output);
if (ExternalInterface.available) {
try {
output.appendText("Adding callback...\n");
ExternalInterface.addCallback("sendToActionScript", receivedFromJavaScript);
if (checkJavaScriptReady()) {
output.appendText("JavaScript is ready.\n");
} else {
output.appendText("JavaScript is not ready, creating timer.\n");
var readyTimer:Timer = new Timer(100, 0);
readyTimer.addEventListener(TimerEvent.TIMER, timerHandler);
readyTimer.start();
}
} catch (error:SecurityError) {
output.appendText("A SecurityError occurred: " + error.message + "\n");
} catch (error:Error) {
output.appendText("An Error occurred: " + error.message + "\n");
}
} else {
output.appendText("External interface is not available for this container.");
}
}
private function receivedFromJavaScript(value:String):void {
output.appendText("JavaScript says: " + value + "\n");
output.borderColor=0xffffff*Math.random();
}
private function checkJavaScriptReady():Boolean {
var isReady:Boolean = ExternalInterface.call("isReady");
return isReady;
}
private function timerHandler(event:TimerEvent):void {
output.appendText("Checking JavaScript status...\n");
var isReady:Boolean = checkJavaScriptReady();
if (isReady) {
output.appendText("JavaScript is ready.\n");
Timer(event.target).stop();
}
}
private function clickHandler(event:MouseEvent):void {
if (ExternalInterface.available) {
ExternalInterface.call("sendToJavaScript", input.text);
}
}
}
}
html js
lang="en">
onload="pageInit();">
http-equiv="Content-Type" content="text/html; charset=utf-8" />
ExternalInterfaceExample
classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
id="ExternalInterfaceExample
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab">
name="quality" value="high" />
name="bgcolor" value="#869ca7" />
name="allowScriptAccess" value="sameDomain" />
width="500" height="375" name="ExternalInterfaceExample
play="true" loop="false" quality="high"
type="application/x-shockwave-flash"
pluginspage="http://www.macromedia.com/go/getflashplayer">
type="text" name="input" value="" />
type="button" value="Send" onclick="sendToActionScript(this.form.input.value);" />
/>