视频类
Flash Player作为流媒体的表现形式之一，视频编码是其最大的特色。.flv文件是Flash Player基本的视频文件格式，可以在Flash Player运行时加载，不被编译到虚拟机中，这就大大减小了Flash Player文件的体积，增加了Flash Player视频文件在网络上传输的速度。
21.1 视频类
在ActionScript 3.0中，提供了一个Video类，用来处理视频。使用Video类可以控制基本的视频文件功能比如编码、滤镜等。
通过使用Video类的属性和方法，可以在程序中直接显示实时的视频流，而不用把视频文件编译到Flash Player视频文件中。其常用的属性如表21.1所示，常用的方法如表21.2所示。
表21.1 Video类常用的属性
| 属 性 |
说 明 |
| deblocking |
指示作为后处理的一部分应用于已解码视频的滤镜的类型 |
| smoothing |
指定在缩放视频时是否应进行平滑处理（插补数据） |
| videoHeight |
以像素为单位指定视频流的高度 |
| videoWidth |
以像素为单位指定视频流的宽度 |
表21.2 Video类常用的方法
| 方 法 |
说 明 |
| attachCamera |
指定在应用程序窗口中Video对象的边界内显示来自摄像头的视频流 |
| attachNetStream |
指定在应用程序窗口中Video对象的边界内显示视频流 |
| clear |
清除该Video对象中当前显示的图像 |
21.2 加载视频文件
.flv格式是Flash Player网络传输的视频文件的基本格式。可以通过一些工具把其他的视频文件格式转换为.flv格式，比如Flash CS3自带的工具Flash Video Encode。
加载一个视频文件，通常可以分为三步实现。其步骤如下所示。
创建一个NetConnection对象。NetConnection类作用是连接到远程服务器中，调用命令，播放视频。其代码如下所示：
// 建立连接
var nc:NetConnection = new NetConnection();
nc.connect(null);
创建一个NetStream对象。NetStream类作用是通过NetConnection对象提供的连接，打开Flash Player与服务器或Flash Player与本地文件系统之间的单向流连接。其代码如下所示：
// 创建视频流
var ns:NetStream = new NetStream(nc);
// 开始播放
ns.play("lake.flv");
创建一个Video对象。调用Video类的attachNetStream事件，可以直接显示视频流。其代码如下所示：
// 视频传输到本地
// 创建Video对象
var vid:Video = new Video();
vid.attachNetStream(ns);
通过这三个步骤的操作，视频文件就被加载并播放。
下面示例说明如何播放一个本地的视频文件lake.flv。其完整的代码如下所示：
package
{
import flash.display.Sprite;
import flash.net.NetConnection;
import flash.net.NetStream;
import flash.media.Video;
import flash.events.AsyncErrorEvent;
public class VideoExample extends Sprite
{
/*************************************
* 构造函数
* */
public function VideoExample()
{
// 建立连接
var nc:NetConnection = new NetConnection();
nc.connect(null);
// 创建视频流
var ns:NetStream = new NetStream(nc);
ns.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
// 指定视频名
ns.play("lake.flv");
// 视频传输到本地
var vid:Video = new Video();
vid.attachNetStream(ns);
// 添加到舞台上
addChild(vid);
}
/*************************************
* 捕获连接异常
* */
function asyncErrorHandler(event:AsyncErrorEvent):void
{
// 错误处理
}
}
}
编译代码，运行效果如图21.1所示。
图21.1 加载视频文件
21.3 视频文件的控制
视频文件的控制是指在视频在播放过程中，用户通过一些交互式的按钮或者其他组件触发事件，精确的控制视频的播放，包括停止播放、暂停播放、视频回放等。
21.3.1 从指定的位置播放
通过NetStream对象的play()方法可以回放视频文件，但是play()方法是从视频文件的开始播放的。有时候，我们需要从指定的位置或者时间开始播放，那么什么方法可以满足这个要求呢？在NetStream类中提供了seek()方法，可以搜索指定位置开始播放。其参数有一个，表示从流的开始位置算起的偏移量，以秒为单位。其语法格式如下所示：
seek(offset:Number):void
比如下面的示例作用是从第5秒开始播放一个视频文件，代码如下所示：
package
{
import flash.display.Sprite;
import flash.net.NetConnection;
import flash.net.NetStream;
import flash.media.Video;
public class VideoExample extends Sprite
{
/*************************************
* 构造函数
* */
public function VideoExample()
{
// 建立连接
var nc:NetConnection = new NetConnection();
nc.connect(null);
// 创建视频流
var ns:NetStream = new NetStream(nc);
// 指定视频名
ns.play("lake.flv");
// 从第5秒开始播放
ns.seek(5);
// 视频传输到本地
var vid:Video = new Video();
vid.attachNetStream(ns);
// 添加到舞台上
addChild(vid);
}
}
}
编译代码，运行的效果如图21.2所示。
图21.2 从指定的位置播放
21.3.2 停止
需要停止一个正在播放的视频的时候，要使用NetStream对象的close()方法。close()方法同时也停止了从服务器中下载视频。其语法格式如下所示：
close():void
如果要继续播放和从服务器中下载视频，需要再次调用NetStream对象的play()方法。下面的示例使用close()方法停止正在播放的视频，代码如下所示：
package
{
import flash.display.Sprite;
import flash.net.NetConnection;
import flash.net.NetStream;
import flash.media.Video;
import flash.events.MouseEvent;
import flash.events.AsyncErrorEvent;
import fl.controls.Button;
public class VideoExample extends Sprite
{
var ns:NetStream;
var nc:NetConnection;
var vid:Video;
/*************************************
* 构造函数
* */
public function VideoExample()
{
LoadVideo();
LoadStopButton();
}
/*************************************
* 加载视频文件
* */
private function LoadVideo():void
{
// 建立连接
nc = new NetConnection();
nc.connect(null);
// 创建视频流
ns = new NetStream(nc);
ns.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
// 指定视频名
ns.play("lake.flv");
// 视频传输到本地
vid = new Video();
vid.attachNetStream(ns);
// 添加到舞台上
addChild(vid);
}
/*************************************
* 创建一个停止的按钮
* */
private function LoadStopButton():void
{
// 增加停止按钮
var stop_btn:Button = new Button();
stop_btn.label = "停止";
stop_btn.move(10, 250);
stop_btn.addEventListener(MouseEvent.CLICK, StopBtn_Click);
addChild(stop_btn);
}
/*************************************
* 创建一个停止按钮的单击事件
* */
private function StopBtn_Click(e:MouseEvent):void
{
// 停止播放
ns.close();
}
/*************************************
* 捕获连接异常
* */
function asyncErrorHandler(event:AsyncErrorEvent):void
{
// 错误处理
}
}
}
编译代码，运行效果如图21.3所示。
图21.3 停止正在播放的视频
21.3.3 暂停与回放
暂停正在播放的视频，需要使用NetStream对象的pause()方法。如果暂停之后，需要从暂停的地方播放，就需要用到resume()方法了。resume()方法作用是恢复播放暂停的视频流。其语法格式如下所示：
resume():void
下面的示例使用pause()方法和resume()方法控制正在播放的视频，示例代码如下所示：
package
{
import flash.display.Sprite;
import flash.net.NetConnection;
import flash.net.NetStream;
import flash.media.Video;
import flash.events.MouseEvent;
import flash.events.AsyncErrorEvent;
import fl.controls.Button;
public class VideoExample extends Sprite
{
var ns:NetStream;
var nc:NetConnection;
var vid:Video;
var pause_btn:Button;
/*************************************
* 构造函数
* */
public function VideoExample()
{
LoadVideo();
LoadPauseButton();
}
/*************************************
* 加载视频文件
* */
private function LoadVideo():void
{
// 建立连接
nc = new NetConnection();
nc.connect(null);
// 创建视频流
ns = new NetStream(nc);
ns.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
// 指定视频名
ns.play("lake.flv");
// 视频传输到本地
vid = new Video();
vid.attachNetStream(ns);
// 添加到舞台上
addChild(vid);
}
/*************************************
* 创建一个暂停/回放按钮
* */
private function LoadPauseButton():void
{
// 增加暂停/回放按钮
pause_btn = new Button();
pause_btn.label = "暂停";
pause_btn.move(10, 250);
pause_btn.addEventListener(MouseEvent.CLICK, PauseBtn_Click);
addChild(pause_btn);
}
/*************************************
* 创建一个暂停按钮的单击事件
* */
private function PauseBtn_Click(e:MouseEvent):void
{
if(e.target.label == "暂停")
{
// 停止播放
ns.pause();
pause_btn.label = "回放";
}
else
{
// 回放
ns.resume();
pause_btn.label = "暂停";
}
}
/*************************************
* 捕获连接异常
* */
function asyncErrorHandler(event:AsyncErrorEvent):void
{
// 错误处理
}
}
}
编译代码，运行效果如图21.4所示。
图21.4 暂停和回放视频
21.3.4 控制视频的音量
控制视频中的声音，需要使用NetStream对象中的soundTransform属性，soundTransform属性返回的是一个SoundTransform对象，SoundTransform对象中的volume属性可以控制声音。
下面的示例使用Slider控件控制视频中声音的大小，代码如下所示：
package
{
import flash.display.Sprite;
import flash.net.NetConnection;
import flash.net.NetStream;
import flash.media.Video;
import flash.media.SoundTransform;
import fl.events.SliderEvent;
import flash.events.AsyncErrorEvent;
import fl.controls.Slider;
public class VideoSoundExample extends Sprite
{
var ns:NetStream;
var nc:NetConnection;
var vid:Video;
var sound_slider:Slider;
var sound:SoundTransform;
/*************************************
* 构造函数
* */
public function VideoSoundExample()
{
LoadVideo();
LoadSlider();
}
/*************************************
* 加载视频文件
* */
private function LoadVideo():void
{
// 建立连接
nc = new NetConnection();
nc.connect(null);
// 创建视频流
ns = new NetStream(nc);
ns.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
// 创建声音
sound = ns.soundTransform;
// 指定视频名
ns.play("lake.flv");
// 视频传输到本地
vid = new Video();
vid.attachNetStream(ns);
// 添加到舞台上
addChild(vid);
}
/*************************************
* 创建Slider控件
* */
private function LoadSlider():void
{
sound_slider = new Slider();
sound_slider.move(10, 250);
// 声音默认值
sound_slider.value = sound.volume;
sound_slider.addEventListener(SliderEvent.CHANGE, volumeChange
Handler);
addChild(sound_slider);
}
/*************************************
* 控制声音
* */
private function volumeChangeHandler(event:SliderEvent):void
{
// 获取Slider控件的值
sound.volume = event.value;
ns.soundTransform = sound;
}
/*************************************
* 捕获连接异常
* */
function asyncErrorHandler(event:AsyncErrorEvent):void
{
// 错误处理
}
}
}
编译代码，运行效果如图21.5所示。
图21.5 视频中的音量控制
21.4 获取视频文件的信息
可以使用onMetaData回调处理函数获取视频文件的信息。视频文件的信息包括持续时间、宽度、高度及帧速等。
21.4.1 onMetaData回调方法
onMetaData是一个回调函数，使用这个回调函数，可以获取元数据的信息，也就是视频文件的信息，包括持续时间、高度、宽度、帧速、视频编码器及音频编码器等。
回调方法有很多参数，通过不同的参数，可以获取元数据不同的信息。回调方法的常用的参数如表21.3所示。
表21.3 onMetaData回调函数的常用的参数
| 参 数 |
说 明 |
| audiocodecid |
指示已使用的音频编解码器（编码/ 解码技术） |
| audiodatarate |
指示音频的编码速率，以每秒千字节为单位 |
| audiodelay |
指示原始FLV文件的“time 0”在FLV文件中保持多长时间。为了正确同步音频，视频内容需要有少量的延迟 |
| canSeekToEnd |
如果FLV文件是用最后一帧（它允许定位到渐进式下载影片剪辑的末尾）上的关键帧编码的，则该值为true。如果FLV文件不是用最后一帧上的关键帧编码的，则该值为false |
| cuePoints |
嵌入在FLV文件中的提示点对象组成的数组，每个提示点对应一个对象。如果FLV文件不包含任何提示点，则值是未定义的 |
| duration |
以秒为单位指定FLV文件的持续时间 |
| framerate |
表示FLV文件的帧速率 |
| height |
以像素为单位表示FLV文件的高度 |
| videocodecid |
表示用于对视频进行编码的编解码器的版本 |
| videodatarate |
表示FLV文件的视频数据速率 |
| width |
以像素为单位表示FLV文件的宽度 |
onMetaData回调方法的关联对象是赋值给NetStream对象的client()方法的，下面的示例说明onMetaData回调方法如何使用，代码如下所示：
// 创建回调函数的对象
var customClient:Object = new Object();
customClient.onMetaData = metaDataHandler;
// 创建视频流
var ns:NetStream = new NetStream(nc);
// 回调函数的对象customClient
// 赋值给NetStream对象的属性client
ns.client = customClient;
// 指定视频名
ns.play("Bear.flv");
/*************************************
* onMetaData回调函数的事件
* */
function metaDataHandler(metadata:Object):void
{
// 处理数据
}
21.4.2 获取视频文件的基本信息
使用回调函数onMetaData可以获取视频文件的基本信息。下面的示例通过onMetaData回调函数获取视频文件的持续时间、帧速、高度和宽度，代码如下所示：
package
{
import flash.display.Sprite;
import flash.net.NetConnection;
import flash.net.NetStream;
import flash.media.Video;
import flash.events.AsyncErrorEvent;
public class CuoPointExample extends Sprite
{
var ns:NetStream;
var nc:NetConnection;
var vid:Video;
public function CuoPointExample()
{
LoadVideo();