NetStream.onCuePoint属性

yun

可用性
Flash Player 8
Flash Media Server用法public onCuePoint = function(infoObject:Object) {}参数infoObject 一个具有下列属性的对象：属性 描述name 当线索点被嵌入到FLV文件中时被赋予的名字。time 回放期间线索点在视频文件中出现的时间，以秒为单位。type 到达的线索点的类型：“navigation”或“event”。parameters 一个为这个线索点指定的名字/值对字符串的联合数组。任何合法的字符串都可以被用作参数名或值。返回或值。返回无描述事件处理器。在一个FLV文件被播放期间，当到达一个被嵌入的线索点时调用。你可以在你的代码中使用这个处理器来在视频到达一个特定的线索点时触发动作。这可以让你利用视频回放事件来同步你的应用程序中的其他动作。下面是可以被嵌入到一个FLV文件中的两类线索点：navigation cue point（导航线索点）在FLV文件中指定一个关键帧；这类线索点的time属性与相应的关键帧精确对应。导航线索点经常被用作书签或入口点，以便用户可以在视频文件中导航。event cue point（事件线索点）是由时间指定的，而不管该时刻是否对应着某个特定的关键帧。事件线索点通常用于表现视频中的某些时刻，在这些时刻会发生某些事情，事件线索点可以被用于触发其他应用程序事件。你可以在首次编码一个FLV文件时定义其中的线索点，或是当你在Flash创作工具中利用视频导入向导引入一个视频剪辑时定义其中的线索点。始播放前获取所有线索点的信息。onCuePoint事件处理器可以在回放期间获取特定时刻的线索点的信息。一般而言，如果你希望你的代码在一个特定的线索点出现的时刻对其做出响应，则你就应该在你的代码中使用onCuePoint事件处理器来触发某些动作。你可以使用提供给onMetaData事件处理器的一系列线索点来让你的用户沿着视频流中预定义的点来播放视频。把线索点的time属性的值传递给NetStream.seek()方法可以从线索点处开始播放视频。例子本范例中的代码是从创建新的NetConnection和NetStream对象开始的。然后为NetStream对象定义了onCuePoint处理器。这个本范例中的代码是从创建新的infoObject NetConnection和NetStream对象开始的。然后为NetStream对象定义了onCuePoint处理器。这个处理器循环遍历infoObject对象中的每一个命名属性并打印属性的名字和值。当发现名为parameters的属性时，会循环遍历列表中的每一个参数并打印参数的名字和值。[table][tr][td] var nc:NetConnection = new NetConnection();
nc.connect(null);
var ns:NetStream = new NetStream(nc);
{ns.onCuePoint = function(infoObject:Object)
{ trace("onCuePoint:");
for (var propName:String in infoObject) {
if (propName != "parameters")
{
trace(propName + " = " + infoObject[propName]);
}
else else
{
trace("parameters =");
if (infoObject.parameters != undefined) {
for (var paramName:String in infoObject.parameters)
{
trace(" " + paramName + ": " + infoObject.parameters[paramName]);
}
}
else
{
trace("undefined");
}
}
}
trace("---------");
}
ns.play("http://www.helpexamples.com/flash/video/cuepoints.flv");
这个范例中的代码会使得下列信息被显示：
onCuePoint:
parameters =
lights: beginning
type = navigation
time = 0.418
name = point1
---------
onCuePoint:
parameters =
lights: middle
type = navigation
time = 7.748
name = point2
---------
onCuePoint:
parameters =
lights: end
type = navigation
time = 16.02
name = point3
---------