NetStream.play()属性

yun

[table][tr][td] 可用性
Flash Player 6
Flash Communication Server MX
用法
public play(name : Object [,start : Number[, len : Number[, reset : Object]]])
参数
name 一个识别名，用于由NetStream.publish()发布的实况数据，一个记录文件名用于回放，或者是false。
如果你传递false，
则流会停止播放，而你发送的任何额外的参数都会被忽略。
要回放FLV文件-针对记录流的默认的Flash文件格式，可以用不带文件扩展名的方式指定流名（例如，
"bolero"）。要回放
你存储在服务器上的MP3文件或是MP3文件的ID3标签，你必须用mp3:或id3:作为流名的前导。例
如，"mp3:bolero"或"id3:bolero"。
start 一个可选的数字参数，以秒为单位指定了开始的时间。这个参数也可以被用于指示这个流是实况
的还是记录的。
start的默认值是-2，这意味着Flash第一次试图播放在name中指定的实况流。如果一个实况流没有
被发现，则Flash会播
放在name中指定的记录流。如果实况流和记录流都没有被找到的话，则Flash会打开一个名为name
的实况流，尽管没有
东西在其上被发布。当有人的确开始在这个流上进行发布时，Flash会开始播放它。
如果你为start传递-1，Flash仅播放在name中指定的实况流。如果没有实况流被发现的话，则Flash
会无限期的等待它，
假如length被设置为-1的话；如果length被设置成一个不同的值，则Flash会等待length秒，在它开始
播放播放列表中的下一个项目之前。
如果你为start传递或一个正数，Flash仅播放一个名为name的记录流，从距离流的开头start秒处开始
播放。如果没有记
录流被发现，则Flash会立即开始播放播放列表中的下一个项目。
如果你为start传递了一个除-1或-2以外的其他的负值的话，则Flash会把这个值理解为-2。
len 一个可选的数字参数，以秒为单位指定了回放的持续时间。
len的默认值是-1，这意味着Flash会播放一个实况流，直到它不再可用，或是播放一个记录流，直
到它结束。
如果你为len传递，则Flash会播放单一帧，它是距离一个记录流的开头start秒（假定start等于或大
于）的那帧。
流在len秒之前就结束了，则当流结束时回放也会结束。） len秒，或是播放一个记录流
len秒。（如果一个
如果你为len传递了一个除-1以外的负值，则Flash会把这个值理解为-1。
reset 一个可选的布尔值或是数字，指定了是否要刷新任何先前的播放列表。如果reset被设置为false（），
则name会被添
加到（排队）到当前的播放列表中；也就是说，name的播放只能是在前面的流完成播放后才能进行。你可
以使用这个技术来创
建一个动态的播放列表。如果reset被设置为true（），则任何前面的play调用都会被清除，而name会被立即
播放。默认情况
下，这个值是true。
你也可以为reset参数指定一个值或，当播放包含消息数据的记录流时这是有用的。这些值分别类似于
传递了false（）和
true（）。一个值会维持一个播放列表，而一个值会重置播放列表。但不管怎么说，指定或的不同之处是导
致Flash Media
true（）。一个值会维持一个播放列表，而一个值会重置播放列表。但不管怎么说，指定或的不同之处是导
致Flash Media
Server一次性返回记录流中所有的消息，还是以消息被原始记录时的间隔返回（这是默认的行为）。
对于访问由Flash Media Server记录的日志文件而言，这尤其有用。
描述
方法。把正在Flash Media Server上被发布的流音频、视频，以及文本消息，或是存储在服务器上的一
个记录文件馈送到客
户机。这个方法仅对订阅这个指定流的客户机而言是可用的，对于流的发布者是不可用的。
要查看视频数据，你必须调用Video.attachVideo()；伴随视频的音频会被自动播放。如果只有音频数据
被流的话，则你可以
使用MovieClip.attachAudio()把流音频路由到一个影片剪辑，然后创建一个Sound对象来控制音频的某些方
面。
你可以使用这个方法的可选参数来控制回放行为的不同方面。下面的表格展示了这些值互相影响的几
种可能。
start len Flash Player的行为
默认 默认 播放实况流直到它不再可用。如果指定名的一个实况流没有被发现，则Flash
Player会播放一个记录
流直到它结束。
-2 19 在一个实况流可用之后，播放一个实况流直至秒。如果指定名的一个实况流没
有被发现，则
Flash Player会播放一个记录流秒。
15 19 播放一个记录流秒，从距离这个流的开头秒处开始播放。
15 默认 播放一个记录流，从距离这个流的开头秒处开始播放，直到这个流结束。
-1 默认 播放一个实况流，直到它不再可用。
这个方法可以用许多不同的信息对象调用NetStream.onStatus。例如，如果指定的流没有发现，则
NetStream.onStatus会被用一个NetStream.Play.StreamNotFound的code属性调用。
如果你想要创建一个能够在不同的实况或记录流间进行切换的动态播放列表的话，你可以不止一次的
调用play并为reset每
次传递false。反过来，如果你希望立即播放指定的流，清除任何正排队等待播放的其他的流，则你可以为reset
传递true。
例子
下面的范例展示了使用这个方法来回放实况或记录流的一些方法。
范例:
var my_nc:NetConnection = new NetConnection();
my_nc.connect("rtmp://localhost/appName/appInstance");
var my_ns:NetStream = new NetStream(my_nc);
my_video.attachVideo(my_ns);
//要播放一个正在别处被发布的名为"stephen"的实况流
//使用默认值- start时间是-2，length 是-1，
//flushPlaylists 是true -- 不传递任何可选的参数。
my_ns.play("stephen");
//要立即播放一个名为record1的记录流，
//从开头处开始播放，最长播放秒。
my_ns.play("record1", 0, 100, true);
范例:
//要在实况和记录流间进行播放和切换：
//假定我们有两个实况流live1和live2，
//以及三个记录流record1、record2和record3。
//播放顺序是record1、live1、record2、live2，以及record3。
var my_nc:NetConnection = new NetConnection();
my_nc.connect("rtmp://localhost/appName/appInstance");
//创建一个NetStream用于播放
var my_ns:NetStream = new NetStream(my_nc);var my_ns:NetStream = new NetStream(my_nc);
my_video.attachVideo(my_ns);my_video.attachVideo(my_ns);
//播放record1
my_ns.play("record1", 0, -1, false);
//从record1切换到live1。
//live1//live1将在将在record1record1结束后开始播放。结束后开始播放。
my_ns.play("live1", -1, 5, false);
//从live1切换到record2。
//record2将在live1播放秒钟后开始播放。
my_ns.play("record2", 0, -1, false);
//中断当前的播放并再次播放record1中的一段
//（通过这我们可以实现一个搜索）
my_ns.play("record1", 1, 5, true);
在下面的范例中，记录流文件log.flv中的数据消息以它们被原始记录时的间隔被返回。
var my_ns:NetStream = new NetStream(my_nc);
my_ns.play("log", 0, -1);
在下面的范例中，记录流文件log.flv中的数据消息被一次性返回，而不是它们被原始记录时的间隔被返
回。
var my_ns:NetStream = new NetStream(my_nc);
my_ns.play("log", 0, -1, 2);