[AS3]onCuePoint（NetStream.onCuePoint 处理函数）

核心提示：onCuePoint = function(infoObject: Object) {}在播放 FLV 文件期间到达嵌入的提示点时进行调用，您可以在视频到达某个特定提示点时，[AS3]onCuePoint（NetStream.onCuePoint 处理函数），使用此处理函数触发代码中的操作，这样，当找到名称为 para

onCuePoint = function(infoObject: Object) {}

在播放 FLV 文件期间到达嵌入的提示点时进行调用。您可以在视频到达某个特定提示点时，使用此处理函数触发代码中的操作。这样，您就可以使应用程序中的其它操作与视频回放事件实现同步。

可以在 FLV 文件中嵌入的提示点有两种类型。

·　 业己接提示点：它指定 FLV 文件中的一个关键帧，而且其 time 属性对应于该关键帧。导航提示点经常被用作书签或入口点，以便用户在视频文件中导航。

·　 “事件”提示点：它由时间指定，而不管该时间是否对应于某个特定的关键帧。事件提示点通常代表视频中的某个时间，到达这个时间时可用于触发其它应用程序事件的情况就会发生。

属性 说明
 
　　name
　　 将提示点嵌入 FLV 文件时赋予提示点的名称。
 
　　time 
　　 提示点在视频文件回放期间的出现时间（以秒为单位）。
 
　　type
　　 到达的提示点的类型：业己接提示点或“事件”提示点。
 
　　参数
　　 为此提示点指定的一个关联数组，它由名称/值对字符串组成。任何有效的字符串都可用于参数名或参数值。
 
　　您可以在首次对 FLV 文件进行编码时，或者在“Flash 创作”工具中使用“视频导入”向导来导入视频剪辑时，在该 FLV 文件中定义提示点。

onCuePoint() 会在回放期间对某个提示点所指定的时间，接收有关该提示点的信息。

onMetaData() 会在视频文件中检索有关提示点的信息。不过它会在视频开始播放之前，获取有关所有提示点的信息。

您可以使用提供给 onMetaData() 事件处理函数的提示点列表，允许用户在传送视频流期间在预定义点处开始播放视频。将提示点的 time 属性的值传递给 NetStream.seek() 方法，以便从该提示点播放视频。

可用性：ActionScript 1.0、Flash Player 8

参数
　　infoObject:Object ― 一个对象，它包含提示点的 name、time、type 和 parameters。

示例
　　此示例中onCuePoint() 处理函数循环遍历 infoObject 对象中的每个命名属性，并输出属性的名称和值。当找到名称为 parameters 的属性时，它遍历列表中的每个参数名称，并输出参数的名称和值。

var nc:NetConnection = new NetConnection;  
nc.connect(null);  
var ns:NetStream = new NetStream(nc);  
ns.onCuePoint = function(infoObject:Object)  
{  
　　　 for (var propName:String in infoObject) {  
　　　　　　　trace(propName + " = " + infoObject[propName]);  
　　　　　　　if (propName == "parameters")  
　　　　　　　{  
　　　　　　　　　　 if (infoObject.parameters != undefined) {  
　　　　　　　　　　　　　　for (var paramName:String in infoObject.parameters)  
　　　　　　　　　　　　　　{  
　　　　　　　　　　　　　　trace(" " + paramName + ": " + infoObject.parameters[paramName]);  
　　　　　　　　　　　　　　}  
　　　　　　　　　　 }  
　　　　　　　}　　  
　　　 }  
};  
ns.play("/video/cuepoints.flv");