| 패키지 | flash.net |
| 클래스 | public dynamic class NetStreamPlayOptions |
| 상속 | NetStreamPlayOptions  EventDispatcher Object |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
NetStream.play2() 메서드에 전달할 수 있는 다양한 옵션을 지정합니다. NetStreamPlayOptions 객체를 play2()에 전달하면 클래스의 속성에 따라 다양한 옵션이 지정됩니다. 이 클래스는 비트율 및 크기가 다른 스트림으로 전환하거나 재생 목록에서 다른 내용으로 전환하여 스트림 간의 동적 전환을 구현하는 데 주로 사용됩니다.
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| len : Number
streamName에 지정된 스트림의 재생 시간(초)입니다. | NetStreamPlayOptions | ||
| offset : Number
Flash Media Server 동적 스트리밍을 위해 서버가 서로 다른 비트율의 스트림 간에 전환되는 절대 스트림 시간입니다. | NetStreamPlayOptions | ||
| oldStreamName : String
전환하기 전의 이전 스트림 이름입니다. | NetStreamPlayOptions | ||
| start : Number
streamName의 시작 시간(초)입니다. | NetStreamPlayOptions | ||
| streamName : String
전환하거나 재생할 새 스트림의 이름입니다. | NetStreamPlayOptions | ||
| transition : String
streamName이 재생되거나 전환되는 모드입니다. | NetStreamPlayOptions | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
NetStreamPlayOptions 객체를 만들어 NetStream.play2() 메서드에 전달되는 옵션을 지정합니다. | NetStreamPlayOptions | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | |
|
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | |
|
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | |
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
|
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
len | 속성 |
public var len:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
streamName에 지정된 스트림의 재생 시간(초)입니다. 기본값은 -1입니다. 이 경우 Flash Player는 사용 가능한 동안 실시간 스트림을 재생하거나 기록 스트림을 끝까지 재생합니다. len에 0을 전달하면 Flash Player는 기록 스트림의 시작 부분에서 start초 위치에 있는 단일 프레임을 재생합니다. 이는 start가 0보다 크거나 같은 경우에만 해당합니다.
len에 음수를 전달하면 Flash Player는 실시간 스트림이 사용 가능하게 된 후 len초 동안 재생하거나 기록 스트림을 len초 동안 재생합니다. len초 이전에 스트림이 끝나면 스트림이 끝날 때 재생이 끝납니다.
len에 -1이 아닌 음수를 전달하면 Flash Player에서 값을 -1로 해석합니다.
관련 API 요소
offset | 속성 |
public var offset:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Flash Media Server 동적 스트리밍을 위해 서버가 서로 다른 비트율의 스트림 간에 전환되는 절대 스트림 시간입니다. offset 속성은 NetStream.play2()가 NetStreamPlayTransitions.SWITCH 전환 모드와 함께 호출되는 경우 사용됩니다. 전환 모드에는 빠른 전환과 표준 전환의 두 가지가 있습니다. offset의 기본값은 빠른 전환 모드를 나타내는 -1입니다. 빠른 전환을 사용할 시기와 표준 전환을 사용할 시기를 결정하는 ActionScript 논리를 작성하십시오.
빠른 전환
빠른 전환 모드의 경우 Flash Media Server는 버퍼의 데이터가 재생될 때까지 기다리지 않고 새 스트림으로 전환됩니다. 이전 스트림에서 버퍼링된 offset 이후의 데이터는 모두 지워집니다. 이전 스트림에서 버퍼링된 데이터는 재생할 필요가 없으므로 빠른 전환은 표준 전환보다 속도가 빠릅니다.
offset의 기본값은 빠른 전환 모드를 나타내는 -1입니다. offset이 -1인 경우에는 netstream.time + 3 이후에(재생 지점으로부터 약 3초 이후) 첫 사용 가능 키프레임에서 전환이 발생합니다. offset 속성을 netstream.time보다 큰 값으로 설정할 수도 있습니다. 예를 들어 재생 지점으로부터 5초 후에 빠른 전환을 수행하려면 offset 속성을 netstream.time + 5로 설정합니다. offset 값이 netstream.time보다 작으면 NetStream.Play.Failed 상태 이벤트가 전송됩니다.
참고: offset 속성은 절대 스트림 시간이며 재생 지점으로부터의 오프셋이 아닙니다. 예를 들어 재생 지점으로부터 5초 후에 전환하려면 offset 속성을 5가 아닌 netstream.time + 5로 설정합니다.
표준 전환
빠른 전환 대신 표준 전환을 사용하려면 offset을 netstream.time + netstream.bufferLength보다 큰 값으로 설정합니다.
클라이언트가 버퍼에서 비트율이 높고, CPU 문제나 삭제된 프레임이 아닌 대역폭 드롭으로 인해 낮은 대역폭으로 전환하려는 경우에는 표준 전환을 사용하십시오. 클라이언트는 표준 전환에서처럼 가능한 한 더 높은 비트율을 재생하고 버퍼의 끝에서는 보다 낮은 비트율로 전환하길 원할 수 있습니다.
자세한 내용은 Adobe Flash Media Server Developer's Guide에서 "Fast switching between streams"를 참조하십시오.
관련 API 요소
oldStreamName | 속성 |
public var oldStreamName:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
전환하기 전의 이전 스트림 이름입니다. 전환을 수행하지 않고 단순히 스트림을 재생하기 위해 NetStream.play2()를 사용하려는 경우 이 속성의 값은 null이거나 정의되지 않아야 합니다. 그렇지 않은 경우 전환하기 전의 이전 스트림을 지정합니다.
관련 API 요소
start | 속성 |
public var start:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
streamName의 시작 시간(초)입니다. 유효한 값은 -2, -1 및 0입니다.
start의 기본값은 -2입니다. 이 경우 Flash Player는 우선 streamName에 지정된 실시간 스트림을 재생해 봅니다. 이러한 이름의 실시간 스트림이 없으면 Flash Player에서 streamName에 지정된 기록 스트림을 재생합니다. 실시간 스트림이나 기록 스트림이 없으면 배급 중인 시스템이 없더라도 Flash Player에서 이름이 streamName인 실시간 스트림을 엽니다. 이 스트림에 대해 배급이 시작되면 Flash Player에서 재생을 시작합니다.
start에 -1을 전달하면 Flash Player에서 streamName에 지정된 실시간 스트림만 재생합니다. 실시간 스트림이 없는 경우 len이 -1로 설정되어 있으면 Flash Player에서 무한정 대기합니다. len이 다른 값으로 설정되어 있으면 Flash Player에서 len초 동안 대기한 후 재생 목록의 다음 항목을 재생합니다.
start에 0이나 양수를 전달하면 Flash Player에서 이름이 streamName인 기록 스트림만 재생하며, 스트림 시작 부분에서 start초부터 재생합니다. 기록 스트림이 없으면 Flash Player에서 즉시 재생 목록의 다음 항목을 재생합니다.
start에 -1 또는 -2가 아닌 음수를 전달하면 Flash Player에서 값을 -2로 해석합니다.
관련 API 요소
streamName | 속성 |
public var streamName:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
전환하거나 재생할 새 스트림의 이름입니다. oldStreamName이 null이거나 정의되지 않은 경우 NetStream.play2()를 호출하면 단순히 streamName의 재생이 시작됩니다. oldStreamName이 지정된 경우 NetStream.play2()를 호출하면 oldStreamName이 streamName으로 전환되고 transition 속성에 지정된 전환 모드가 사용됩니다.
관련 API 요소
transition | 속성 |
public var transition:String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
streamName이 재생되거나 전환되는 모드입니다. 사용할 수 있는 값은 NetStreamPlayTransitions 클래스의 상수입니다. Netstream.play2()를 호출하여 스트림을 재생하는지 아니면 전환하는지에 따라 전환 모드의 동작이 다릅니다. 전환 모드에 대한 자세한 내용은 NetStreamPlayTransitions 클래스를 참조하십시오.
관련 API 요소
NetStreamPlayOptions | () | 생성자 |
public function NetStreamPlayOptions()| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
NetStreamPlayOptions 객체를 만들어 NetStream.play2() 메서드에 전달되는 옵션을 지정합니다.
관련 API 요소
Tue Jun 12 2018, 03:17 PM Z