数据当前存在于缓冲区中的秒数。 您可以将此属性与 bufferTime 属性一起使用，以评估缓冲区将近填满的程度；例如，向正等待数据加载到缓冲区中的用户显示反馈。

另请参见

指定在开始显示流之前需要多长时间将消息存入缓冲区。 例如，若要确保流的最初 15 秒无中断播放，请将 bufferTime 设置为 15；Flash Player 将在把 15 秒的数据存入缓冲区后才开始播放该流。

默认值是 0.1（十分之一秒）。 若要确定当前位于缓冲区中的秒数，请使用 bufferLength 属性。

注意：若要避免在对预先录制的（非实时）内容进行流处理时发生扭曲，不要将 Netstream.bufferTime 为 0。 对于预先录制的内容，默认情况下 Flash Player 将使用输入缓冲区对媒体数据进行排队并正确播放媒体。 对于预先录制的内容，请使用默认设置或延长缓冲时间。

另请参见

已加载到播放器中的数据的字节数。 您可以将此属性与 bytesTotal 属性一起使用，以评估缓冲区将近填满的程度；例如，向正等待数据加载到缓冲区中的用户显示反馈。

另请参见

正加载到播放器中的文件的总大小（以字节为单位）。

另请参见

指定 Flash Player 是否应在开始加载 FLV 文件之前，尝试从所加载 FLV 文件的服务器下载跨域策略文件。 当对渐进式视频下载（独立的 FLV 文件）使用 NetStream 对象，或者加载的 FLV 文件位于执行调用的 SWF 文件所在的域外部时，应用此属性。 当使用 NetStream 对象获取 RTMP 资源时，忽略此属性。

当加载的 FLV 文件位于执行调用的 SWF 文件所在的域外部时，将此属性设置为 true，而且应使用 BitmapData.draw() 方法对视频进行像素级访问。 在加载时未将 checkPolicyFile 属性设置为 true 的情况下，如果调用 BitmapData.draw()，可能会收到一个 SecurityError 异常，因为没有下载所需的策略文件。

如果不需要对正在加载的视频进行像素级访问，则不要将 checkPolicyFile 设置为 true。 检查策略文件会占用网络带宽，并可能延迟下载的开始时间。

如果将 checkPolicyFile 设置为 true，则调用 NetStream.play() 方法时，Flash Player 必须成功下载一个相关的跨域策略文件，或者必须先确定在开始下载对象（在对 NetStream.play() 的调用中指定）之前，不存在这种策略文件。 为确认是否存在策略文件，Flash Player 将执行以下操作，具体顺序如下：

1. Flash Player 考虑已经下载的策略文件。
2. Flash Player 尝试下载在对 Security.loadPolicyFile() 方法的调用中指定的任何待处理的策略文件。
3. Flash Player 尝试从与传递给 NetStream.play() 的 URL 相对应的默认位置下载策略文件，在与该 URL 所在的同一台服务器上，该默认位置为 /crossdomain.xml。

无论哪种情况，Flash Player 都要求视频服务器上存在一个正确的策略文件，该文件可以提供对传递（根据该策略文件的位置）给 play() 的 URL 处的对象的访问，并允许执行调用的 SWF 所在的域通过一个或多个 <allow-access-from> 标签来访问视频。

如果将 checkPolicyFile 设置为 true，则 Flash Player 会等到策略文件确认完毕才下载视频。 等待对视频数据执行任何像素级操作（如调用 BitmapData.draw()），直至从 NetStream 对象收到 onMetaData 或 NetStatus 事件。

如果将 checkPolicyFile 设置为 true，但未找到相关的策略文件，则您只有执行需要策略文件的操作时，才会接收到错误，然后 Flash Player 会引发 SecurityError 异常。

如果要从使用服务器端 HTTP 重定向的 URL 下载 FLV 文件，则应谨慎使用 checkPolicyFile。 Flash Player 尝试检索与您在 NetStream.play() 中指定的初始 URL 相对应的策略文件。 如果最终的 FLV 文件由于 HTTP 重定向而来自不同的 URL，则最初下载的策略文件可能不适用于该 FLV 文件的最终 URL，该 URL 对安全决策颇为重要。

有关策略文件的详细信息，请参阅《ActionScript 3.0 编程》中的“Flash Player 安全性”一章。

另请参见

指定在其上调用回调方法的对象。 默认对象为 this，将创建 NetStream 对象。 如果将 client 属性设置为另一个对象，则将对该对象调用回调方法。

每秒显示的帧的数目。 如果您正在导出 FLV 文件以在多个系统上播放，则您可以在测试期间检查该值以帮助您确定在导出该文件时要应用多大程度的压缩。

在实时（未缓冲的）模式下，数据在订阅流的缓冲区中停留的秒数。 此属性指定当前的网络传输延迟（延迟时间）。

此属性主要用于服务器（例如：Flash Media Server）；有关详细信息，请参阅类的描述。

您可以获取此属性的值来粗略估量流的传输质量，并将其传达给用户。

此 NetStream 对象的对象编码（AMF 版本）。 NetStream 对象从关联的 NetConnection 对象继承了它的 objectEncoding 值。 如果 ActionScript 3.0 SWF 文件需要与在 Flash Player 9 之前发布的服务器进行通信，则了解此属性非常重要。 有关详细信息，请参阅 NetConnection 类中 objectEncoding 属性的描述。

此属性的值取决于流是本地还是远程的。 本地流返回 NetConnection.defaultObjectEncoding 的值。在这些流上，null 被传递给 NetConnection.connect() 方法。 远程流返回与服务器建立的连接的对象编码。通过远程流连接到服务器。

如果在未建立服务器连接时就尝试读取此属性，或者尝试更改此属性，Flash Player 将引发异常。

另请参见

在此 NetStream 对象中控制声音。 有关详细信息，请参阅 SoundTransform 类。

另请参见

播放头的位置（以秒为单位）。

另请参见

创建可用于通过指定的 NetConnection 对象播放 FLV 文件的流。

另请参见

指定一个通过 NetStream 对象发送的音频流，它来自作为源传递的 Microphone 对象。 此方法仅可用于指定流的发布者。

此方法主要用于服务器（例如：Flash Media Server）；有关详细信息，请参阅类的描述。

您可以在调用 publish() 方法并真正开始传输之前或之后，调用此方法。 想要收听此音频的订阅者必须调用 NetStream.play() 方法。 您可以通过指定的 Microphone 对象的 soundTransform 属性来控制此音频流的声音属性。

参数

另请参见

开始从指定的源捕获视频，或者如果 theCamera 被设置为 null，则停止捕获操作。 此方法仅可用于指定流的发布者。

此方法主要用于服务器（例如：Flash Media Server）；有关详细信息，请参阅类的描述。

在附加了视频源后，必须调用 NetStream.publish() 才能开始传输。 想要显示视频的订阅者必须调用 NetStream.play() 和 Video.attachCamera() 方法，才能在舞台上显示视频。

可以使用 snapshotMilliseconds 并通过提供一个正数值，将指定毫秒数的尾片添加到视频输入信号中的方式来发送单个快照（通过提供值 0）或一系列快照（实际上是延时拍摄镜头）。 尾片延长了视频消息的显示时间。 通过重复调用带有 snapshotMilliseconds 的正数值的 attachCamera()，交替快照和尾片的序列就产生了延时拍摄镜头。 例如，可以每天捕获一个帧，将其追加到视频文件上。 当订阅者播放该文件时，每个帧都会在屏幕上显示指定的毫秒数，然后才会显示下一个帧。

snapshotMilliseconds 参数的用途不同于可通过 Camera.setMode() 设置的 fps 参数。 在指定 snapshotMilliseconds 时，您可以控制录制的帧之间的时间间隔。 在使用 Camera.setMode() 指定 fps 时，您在控制录制和回放多长时间。

例如，假设您想每隔 5 分钟取一个快照，一共要取 100 个快照。 您可以通过以下两种方式来实现：

• 您可以每隔 5 分钟发出一个 NetStream.attachCamera(myCamera, 500) 命令，重复执行 100 次。 整个录制过程将需要 500 分钟，但是产生的文件将在 50 秒内完成回放（100 个帧，帧与帧之间的时间间隔为 500 毫秒）。
• 您可以发出一个 fps 值为 1/300（每 300 秒一次，即每 5 分钟一次）的 Camera.setMode() 命令，然后发出一个 NetStream.attachCamera(source) 命令，使摄像头连续捕捉 500 分钟的图像。 产生的文件将在 500 分钟内完成回放，这与录制的时间长度相同，每个帧显示 5 分钟。

这两种方法都同样捕获了 500 个帧，并且都很有用；具体采用何种方法，主要取决于对回放的要求。 例如，在第二种情况中，可以是整段时间一直在录制音频。 另外，两个文件的大小也相近。

参数

停止播放流上的所有数据，将 time 属性设置为 0，并使该流可用于其它用途。 此命令还会删除已通过 HTTP 下载的 FLV 文件的本地副本。 虽然 Flash Player 会删除它所创建的 FLV 文件的本地副本，但该视频的副本可以永久保存在浏览器的缓存目录中。 如果必须完全阻止缓存或本地存储 FLV 文件的操作发生，请使用 Flash Media Server 2。

另请参见

暂停视频流的回放。 如果视频已经暂停，则调用此方法将不会执行任何操作。

另请参见

开始回放外部音频或视频 (FLV) 文件。 若要查看视频数据，您必须创建一个 Video 对象并调用 Video.attachNetStream() 方法；与视频一起进行流式处理的音频或只包含音频的 FLV 文件会自动播放。 若要对来自麦克风的音频进行流式处理，请使用 NetStream.attachAudio() 方法，并通过 Microphone 对象控制音频的某些属性。

若要控制与 FLV 文件关联的音频，您可以使用 DisplayObjectContainer.addChild() 方法将音频路由到播放列表中的某个对象；然后创建 Sound 对象来控制该音频的某些属性。 有关详细信息，请参阅“DisplayObjectContainer.addChild() 方法”。

如果无法找到 FLV 文件，则调度 netStatus 事件。 若要停止正在播放的流，请使用 close() 方法。

使用此方法时，请考虑 Flash Player 安全模型。 受信任的本地沙箱或只能与远程内容交互的沙箱中的 SWF 文件可以加载和播放远程沙箱中的 FLV 文件，但如果未经跨域策略文件形式的显式许可，则无法访问该远程 FLV 文件的数据。 还可以在包含 SWF 内容的 HTML 页中设置 object 和 embed 标签的 allowNetworking 参数，防止 SWF 文件使用此方法。

有关详细信息，请参阅以下部分：

• security chapter（在《ActionScript 3.0 编程》一书中）和有关 LiveDocs 的最新注释
• Flash Player 9 Security White Paper
• Netstream.checkPolicyFile 属性。

参数

另请参见

将音频流、视频流和文本消息流从客户端发送到服务器（例如：Flash Media Server 2），并可选择在传输期间记录该流。 此方法仅可用于指定流的发布者。

此方法主要用于服务器（例如：Flash Media Server 2）；有关详细信息，请参阅类的描述。

不要使用此方法让客户端播放已发布和录制的流。 而应为该客户端创建一个 NetStream 实例，并调用 play() 方法：

  var subscribeNS:NetStream = new NetStream(myNetConnection);
  subscribeNS.play("streamToPlay");
  

使用 Flash Media Server 2 录制流时，Flash 会创建一个 FLV 文件，并将其保存在服务器上应用程序目录的子目录中。 每个流都保存在名称与传递给 NetConnection.connect() 方法的 command 参数的应用程序实例名称值相匹配的目录中。 Flash Player 会自动创建这些目录；您不必为每个实例名称都创建一个目录。 例如，以下代码说明如何连接到应用程序的某个特定实例，该实例保存在应用程序目录中名为 lectureSeries 的目录下。 名为 lecture.flv 的文件保存在名为 /yourAppsFolder/lectureSeries/streams/Monday 的子目录中：

  var myNC:NetConnection = new NetConnection();
  myNC.connect("rtmp://server.domain.com/lectureSeries/Monday");
  var myNS:NetStream = new NetStream(myNC);
  myNS.publish("lecture", "record");
  

下例说明如何连接到同一个应用程序的不同实例，而发出相同的发布命令。 名为 lecture.flv 的文件保存在名为 /yourAppsFolder/lectureSeries/streams/Tuesday 的子目录中。

  var myNC:NetConnection = new NetConnection();
  myNC.connect("rtmp://server.domain.com/lectureSeries/Tuesday");
  var myNS:NetStream = new NetStream(my_nc);
  myNS.publish("lecture", "record");
  

如果不传递实例名称的值，则该值将与传递给 name 属性的值相匹配，该属性保存在名为 /yourAppsFolder/appName/streams/_definst_（针对“默认实例”）的子目录中。 有关使用实例名称的详细信息，请参阅 NetConnection.connect() 方法。 有关回放 FLV 文件的信息，请参阅 NetStream.play() 方法。

此方法可调度具有若干个不同信息对象的 netStatus 事件。 例如，如果某个用户在具有指定名称的流上进行发布，则 netStatus 事件将随 NetStream.Publish.BadName 的代码属性一起调度。 有关详细信息，请参阅 netStatus 事件。

参数

另请参见

指定传入的音频是否在流上播放。 此方法仅可用于订阅了指定流的客户端，不可用于流的发布者。

此方法主要用于服务器（例如：Flash Media Server）；有关详细信息，请参阅类的描述。

您可以在调用 NetStream.play() 方法并真正开始接收流之前或之后，调用此方法。 例如，您可以将这些方法附加到某个按钮上，用户可以通过单击该按钮将传入的音频流静音或取消静音。

如果指定的流仅包含音频数据，则将 false 值传递给该方法可以阻止 NetStream.time 进一步递增。

参数

指定传入的音频是否将在流上播放。 此方法仅可用于订阅了指定流的客户端，不可用于流的发布者。

此方法主要用于服务器（例如：Flash Media Server 2）；有关详细信息，请参阅类的描述。

您可以在调用 NetStream.play() 方法并真正开始接收流之前或之后，调用此方法。 例如，您可以将这些方法附加到某个按钮上，用户可以通过按该按钮来显示或隐藏传入的视频流。

如果指定的流仅包含视频数据，则将 false 值传递给该方法可以阻止 NetStream.time 进一步递增。

参数

恢复回放暂停的视频流。 如果视频已在播放，则调用此方法将不会执行任何操作。

另请参见

搜寻最接近于指定位置（从流的开始位置算起的偏移量，以秒为单位）的关键帧。 到达该位置时，流将恢复播放。

参数

另请参见

在指定的流上向所有订阅客户端发送一条消息。 此方法仅可用于指定流的发布者。

此方法主要用于服务器（例如：Flash Media Server 2）；有关详细信息，请参阅类的描述。

若要处理并响应消息，请以 myStream.HandlerName 格式创建一个处理函数。

Flash Player 不对方法或方法的数据、对象原型变量或不可枚举的变量进行序列化处理。 对于显示对象，Flash Player 仅对路径而不对数据进行序列化处理。

参数

另请参见

  import flash.net.NetConnection;
  import flash.net.NetStream;
  import flash.events.NetStatusEvent;
  import flash.media.Video;
  import flash.utils.setTimeout;
  
  var nc:NetConnection = new NetConnection();
  nc.objectEncoding = 0;
  nc.addEventListener("netStatus", onNCStatus);
  nc.connect("rtmp://www.example.com/MyApp/MyInstance");
  var ns1:NetStream;
  var vid:Video = new Video(300,300);
  addChild(vid);
  var obj:Object = new Object();
  obj.myFunction = function(event:String):void {
   trace(event);
  }
  
  function onNCStatus(event:NetStatusEvent):void {
   if(event.info.code == "NetConnection.Connect.Success") {
    ns1 = new NetStream(nc);
    ns1.play("MyVideo");
    vid.attachNetStream(ns1);
    ns1.client = obj;
    ns1.publish("dummy", "live");
    
    var ns2:NetStream = new NetStream(nc);
    ns2.play("dummy");
    ns2.client = obj;
    
    setTimeout(sendHello, 3000);
   }
  }
  
  function sendHello():void {
    ns1.send("myFunction", "hello");
  }
  

暂停或恢复流的回放。 第一次调用此方法时，将暂停播放；下一次调用此方法时，将恢复播放。 您可以使用此方法，允许用户通过按某个按钮来暂停或恢复回放。

另请参见

在异步引发异常（即来自本机异步代码）时调度。 当服务器调用客户端上未定义的方法时调度此事件。

此事件具有以下属性：

另请参见

在出现输入或输出错误并导致网络操作失败时调度。

此事件具有以下属性：

在 NetStream 对象报告其状态或错误条件时调度。 netStatus 事件包含一个 info 属性，该属性是一个包含有关事件特定信息（例如连接尝试成功还是失败）的信息对象。

此事件具有以下属性：

另请参见

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

此事件主要用于服务器（例如：Flash Media Server 2）；有关详细信息，请参阅类的描述。 它不是 Flash Player API 的一部分，只是为了方便起见包含在此语言参考中。 您不能使用 addEventListener() 方法或任何其它的 EventDispatcher 方法来侦听或处理此事件。 相反，您必须定义一个回调函数，并将其直接附加到以下对象之一：

• NetStream 实例的 client 属性所引用的对象。
• NetStream 子类的一个实例。 NetStream 是一个密封类，即无法在运行时将属性或方法添加到 NetStream 对象。 然而，您可以创建 NetStream 的子类并在其中定义您的事件处理函数，或者将该子类变为动态的并对子类的实例添加事件处理函数。

可以在 FLV 文件中嵌入以下几种类型的提示点：

• 导航提示点，它指定 FLV 文件中的一个关键帧，提示点的 time 属性对应于该关键帧。 导航提示点经常被用作书签或入口点，以便用户在视频文件中导航。
• 事件提示点，它由时间指定，而不管该时间是否对应于某个特定的关键帧。 事件提示点通常代表视频中的某个时间，到达这个时间时可用于触发其它应用程序事件的情况就会发生。

onCuePoint 事件对象具有以下属性：

您可以在首次对 FLV 文件进行编码时，或者在 Flash 创作工具中使用“视频导入”向导来导入视频剪辑时，在该 FLV 文件中定义提示点。

onMetaData 事件还会在视频文件中检索有关提示点的信息。 不过，onMetaData 事件会在视频开始播放之前，获取有关所有提示点的信息。 onCuePoint 事件会在回放期间对某个提示点所指定的时间，接收有关该提示点的信息。

通常，要让代码在特定的提示点出现时对它给予响应，请使用 onCuePoint 事件来触发代码中的某个操作。

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

另请参见

在 Flash Player 接收在正播放的 FLV 文件中嵌入的描述性信息时调度。

此特殊事件主要用于服务器（例如：Flash Media Server）；有关详细信息，请参阅类的描述。 从技术角度而言，它不是 Flash Player API 的一部分，只是为了方便起见包含在此语言参考中。 您不能使用 addEventListener() 方法或任何其它的 EventDispatcher 方法来侦听或处理此事件。 相反，您必须定义一个回调函数，并将其直接附加到以下对象之一：

• NetStream 实例的 client 属性所引用的对象。
• NetStream 子类的一个实例。 NetStream 是一个密封类，即无法在运行时将属性或方法添加到 NetStream 对象。 然而，您可以创建 NetStream 的子类并在其中定义您的事件处理函数，或者将该子类变为动态的并对子类的实例添加事件处理函数。

Flash Video Exporter 实用程序（1.1 版本或更高版本）将视频的持续时间、创建日期、数据速率及其它信息嵌入视频文件本身。 不同的视频编码器嵌入不同的元数据组中。

此事件在调用 NetStream.play() 方法之后、在视频播放头前进之前触发。

在多数情况下，FLV 元数据中嵌入的持续时间值接近实际持续时间，但是并不精确。 换言之，当播放头在视频流的结尾处时，此值不会始终与 NetStream.time 属性的值相匹配。

另请参见

在 NetStream 对象完全播放完流后调度。 此处理函数将返回信息对象，这些信息对象提供 netStatus 事件返回的信息之外的其它信息。 您可以在 NetStream 对象从播放列表中的一个流切换到另一个流时（如信息对象 NetStream.Play.Switch 所示），或者在 NetStream 对象播放到结尾时（如信息对象 NetStream.Play.Complete 所示），使用此处理函数触发代码中的操作。 若要响应此事件，必须创建一个函数来处理服务器所发送的信息对象。

此事件主要用于服务器（例如：Flash Media Server）；有关详细信息，请参阅类的描述。 它不是 Flash Player API 的一部分，只是为了方便起见包含在此语言参考中。 您不能使用 addEventListener() 方法或任何其它的 EventDispatcher 方法来侦听或处理此事件。 相反，您必须定义一个回调函数，并将其直接附加到以下对象之一：

• NetStream 实例的 client 属性所引用的对象。
• NetStream 子类的一个实例。 NetStream 是一个密封类，即无法在运行时将属性或方法添加到 NetStream 对象。 然而，您可以创建 NetStream 的子类并在其中定义您的事件处理函数，或者将该子类变为动态的并对子类的实例添加事件处理函数。

此事件可返回一个具有以下属性的信息对象：

另请参见

在本例中，创建 Video 和 NetStream 对象并调用 Video.attachNetStream() 和 NetStream.play() 方法的代码放在处理函数中。 仅当连接到 NetConnection 对象的尝试取得成功时才调用处理函数，即，当 netStatus 事件返回 info 对象（带有一个表示成功的 code 属性）时，才调用该处理函数。 建议您在调用 NetStream.play() 之前，等待连接成功。

package {
    import flash.display.Sprite;
    import flash.events.NetStatusEvent;
    import flash.events.SecurityErrorEvent;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import flash.events.Event;

    public class NetConnectionExample extends Sprite {
        private var videoURL:String = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        public function NetConnectionExample() {
            connection = new NetConnection();
            connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            connection.connect(null);
        }

        private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace("Stream not found: " + videoURL);
                    break;
            }
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function connectStream():void {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }
    }
}

class CustomClient {
    public function onMetaData(info:Object):void {
        trace("metadata: duration=" + info.duration + " width=" + info.width + " height=" + info.height + " framerate=" + info.framerate);
    }
    public function onCuePoint(info:Object):void {
        trace("cuepoint: time=" + info.time + " name=" + info.name + " type=" + info.type);
    }
}