如何自定义VideoPlayer的全屏行为

Flex4中增加了一个视频播放组件：VideoPlayer，相信很多朋友已经在使用了，确实比原先方便很多（记得在Flex3的时候，我们还需要借用Flash IDE带的视频播放组件）。它的功能确实也足以覆盖我们大部分的一般性的需求。如果您有一些自定义的需求，比如需要自定义播放器的全屏行为，就要了解VideoPlayer的一些内部逻辑。

首先，VideoPlayer是支持全屏播放的，注意播放器的右下角有一个控制全屏状态的按钮，点击之后，视频就进入全屏状态，而播放条会位于稍微靠底部的位置，并且过一段时间后就会自动隐藏。再次点击全屏按钮，或按ESC键，即可退出全屏状态，恢复之前的默认状态。这是默认情况下，VideoPlayer的全屏行为。

如果我们为播放器实现了一个字幕显示功能，那么进入全屏状态后，如何把字幕也显示出来呢？来看一下具体的代码实现：

首先，要实现字幕功能，我们必然要对VideoPlayer的功能进行扩展。基于优先使用组合，而不是继承的建议，我们没有直接继承VideoPlayer，而是使用了Group，内部包含一个VideoPlayer和一个Text组件，Text组件显然是用来显示字幕的，它会叠加在VideoPlayer之上。

<s:VideoPlayer id="vplayer" width="100%" height="100%" currentTimeChange="timeChangeHander(event)" complete="vplayerCompleteHandler(event)" skinClass="com.riameeting.skin.RIAPlayerSkin"/>
<mx:Text id="captionText" width="100%" bottom="24"
textAlign="center" text="{currentCaption}"
filters="{[dropFilter]}"
selectable="false"
fontWeight="bold" color="#FFFFFF"
fontSize.normal="{model.captionFontSize}"
fontSize.fullScreen="{model.captionFontSizeFullScreen}"
/>

假设我们已经完成了字幕的解析和显示功能，那么在正常情况下，字幕播放是正常的，但是一旦进入全屏状态，我们就会发现字幕没有显示出来。因为显然用于显示字幕的Text组件在VideoPlayer之外。所以我们还需要做一些额外的工作，来把字幕显示也加入到VideoPlayer的全屏显示界面里面。

因为VideoPlayer也是基于皮肤机制的，所以我们需要为它指定一个自定义的皮肤（注意控制全屏的按钮，是在皮肤里面存在的），然后我们就可以控制全屏按钮的行为，禁用它的默认行为，并派发一个事件给我们的组件，这样我们的组件就可以在接受到事件之后，完成我们自定义的全屏代码的控制工作。代码里面我们直接注视掉了原先的按钮，增加一个显示和原先一致的新按钮，注意ID是不同的。

<!--
<s:Button id="fullScreenButton" right="0" bottom="0" label="Fullscreen"
skinClass="spark.skins.spark.mediaClasses.normal.FullScreenButtonSkin"
skinClass.fullScreenStates="spark.skins.spark.mediaClasses.fullScreen.FullScreenButtonSkin"
focusIn="event.target.depth=1" focusOut="event.target.depth=0"/>
-->
<s:Button id="fullScreenButtonImp1" right="0" bottom="0" label="Fullscreen"
skinClass="spark.skins.spark.mediaClasses.normal.FullScreenButtonSkin"
skinClass.fullScreenStates="spark.skins.spark.mediaClasses.fullScreen.FullScreenButtonSkin"
focusIn="event.target.depth=1" focusOut="event.target.depth=0" click="dispatchEvent(new Event('videoFullScreen',true))"/>


注意它派发了一个"videoFullScreen"的事件，并且是冒泡的，所以会被我们的组件接收到。然后我们就可以自定义播放器的全屏行为了。参见下面的代码片段，这段代码参阅了VideoPlayer自身的代码，并针对需求进行了一些改动。注意它的全屏控制，并不是简单的设置stage.displayState，还需要用PopUpManager将组件自身添加到最顶层显示，并将尺寸放大到全屏尺寸（之所以要这样实施，是因为如果用stage.fullScreenSourceRect属性，简单的定义全屏显示区域的话，播放器本身的UI会在放大后出现明显的锯齿，显示非常丑陋）。代码我大体上进行了注释，如下：

private var beforeFullScreenInfo:Object;
/**
* 全屏按钮被点击后，执行的事件侦听方法
*/
protected function fullScreenButtonHandler(event:Event):void
{
//判断状态，如果是全屏，就退出全屏，否则进入全屏
if(stage.displayState == StageDisplayState.FULL_SCREEN) {
//注意这个设置会触发fullScreenEventHandler，返回初始状态，将组件归位
stage.displayState = StageDisplayState.NORMAL;
} else {
var screenBounds:Rectangle = new Rectangle(0,0,stage.fullScreenWidth,stage.fullScreenHeight);
//这里要记录下当前组件的一些数据，用于返回初始状态的时候，将组件设置到原先的状态
beforeFullScreenInfo = {parent: this.parent,
x: this.x,
y: this.y,
explicitWidth: this.explicitWidth,
explicitHeight: this.explicitHeight,
percentWidth: this.percentWidth,
percentHeight: this.percentHeight,
isPopUp: this.isPopUp};
//获取组件在原先的父级上的索引
if (parent is IVisualElementContainer){
var ivec:IVisualElementContainer = IVisualElementContainer(parent);
beforeFullScreenInfo.childIndex = ivec.getElementIndex(this);
ivec.removeElement(this);
}else{
beforeFullScreenInfo.childIndex = parent.getChildIndex(this);
parent.removeChild(this);
}
//用PopUp机制，将组件添加到最上层显示
PopUpManager.addPopUp(this, FlexGlobals.topLevelApplication as DisplayObject, false, null, moduleFactory);
//设置组件的尺寸，匹配全屏下屏幕的尺寸
setLayoutBoundsSize(screenBounds.width, screenBounds.height, true);
this.explicitWidth = width;
this.explicitHeight = height;
setLayoutBoundsPosition(0, 0, true);
this.validateNow();
systemManager.stage.addEventListener(FullScreenEvent.FULL_SCREEN, fullScreenEventHandler);
stage.displayState = StageDisplayState.FULL_SCREEN;
currentState = "fullScreen";
}
}
/**
* 屏幕状态切换的时候，触发的事件侦听方法
*/
private function fullScreenEventHandler(event:FullScreenEvent):void
{
//只判断状态从全屏进入普通模式的情况
if(event.fullScreen) return;
currentState = "";
systemManager.stage.removeEventListener(FullScreenEvent.FULL_SCREEN, fullScreenEventHandler);
//根据之前记录的数据，将组件归位
this.x = beforeFullScreenInfo.x;
this.y = beforeFullScreenInfo.y;
this.explicitWidth = beforeFullScreenInfo.explicitWidth;
this.explicitHeight = beforeFullScreenInfo.explicitHeight;
this.percentWidth = beforeFullScreenInfo.percentWidth;
this.percentHeight = beforeFullScreenInfo.percentHeight;
if (!beforeFullScreenInfo.isPopUp){
// remove from top level application:
PopUpManager.removePopUp(this);
// add back to original parent
if (beforeFullScreenInfo.parent is IVisualElementContainer)
beforeFullScreenInfo.parent.addElementAt(this, beforeFullScreenInfo.childIndex);
else
beforeFullScreenInfo.parent.addChildAt(this, beforeFullScreenInfo.childIndex);
}
beforeFullScreenInfo = null;
invalidateSize();
invalidateDisplayList();
}