VideoPlayer  - AS3 Flash

registrationX, registrationY, registrationWidth 및 registrationHeight 속성을 기준으로 비디오를 표시하는 방법을 지정합니다. scaleMode 속성이 VideoScaleMode.MAINTAIN_ASPECT_RATIO 또는 VideoScaleMode.NO_SCALE로 설정된 경우 align 속성이 자동 배치를 수행합니다. FLV 파일이 로드된 후에 이 속성을 변경하면 즉시 자동으로 배치되기 시작됩니다. 값은 VideoAlign 클래스에서 전달됩니다.

기본값: VideoAlign.CENTER.

관련 API 요소

부울 값을 true로 설정하는 경우 재생이 중단되면 플레이어가 스트림의 끝에 도달하거나 stop() 메서드가 호출되므로 FLV 파일이 프레임 1로 되감깁니다. 실시간 스트림에서는 이 속성이 아무런 의미가 없습니다.

기본값: false.

비디오 스트림 재생을 시작하기에 앞서 메모리에 버퍼링하는 시간을 초 단위로 지정하는 숫자입니다. RTMP를 통한 FLV 파일 스트리밍을 사용하면 파일은 다운로드되지 않고 메모리에 버퍼링되기만 하며, 이 속성의 설정을 기본값인 0.1에서 좀더 늘려야 할 수도 있습니다. HTTP를 통해 점진적으로 다운로드되는 FLV 파일을 사용하면 느린 구형 컴퓨터에서 고품질의 비디오를 볼 수는 있지만 이 값을 늘리더라도 효과는 거의 없습니다.

실시간이 아닌 사전 녹화된 비디오의 경우 bufferTime 속성을 0으로 설정하지 말고 기본 버퍼링 시간을 사용하거나 버퍼링 시간을 늘려야 합니다.

이 속성은 재생이 시작되기 전에 다운로드할 FLV 파일의 양을 지정하지는 않습니다.

관련 API 요소

HTTP 다운로드의 다운로드 크기를 바이트 단위로 나타내는 숫자입니다. 스트림이 없거나 FMS(Flash Media Server)에서 스트리밍되거나 아직 정보를 사용할 수 없는 경우 0을 반환합니다. 반환되는 값은 HTTP 다운로드에만 사용됩니다.

HTTP 다운로드 시에 다운로드한 총 바이트 수를 나타내는 숫자입니다. 스트림이 없거나 FMS(Flash Media Server)에서 스트리밍되거나 아직 정보를 사용할 수 없는 경우 -1을 반환합니다. 반환되는 값은 HTTP 다운로드에만 사용됩니다.

VideoPlayer 인스턴스의 높이를 픽셀 단위로 지정하는 숫자입니다.

참고: fl.video.VideoPlayer.videoHeight 속성과 비슷한 flash.media.Video.height 속성과 이 속성을 혼동하지 마십시오.

관련 API 요소

재생이 일시 정지되거나 중단되어 Flash에서 Flash Media Server와 같은 비디오 서버에 대한 유휴 연결을 종료하기 전까지의 시간(밀리초)입니다. 이 속성은 HTTP를 통한 FLV 파일 다운로드에 아무런 영향을 주지 않습니다.

비디오 스트림이 유휴 상태에 있을 때 이 속성을 설정하면 새 값으로 시간 초과 기간을 다시 시작합니다.

모든 VideoPlayer 객체에서 사용자 정의 클래스를 기본 INCManager 구현으로 사용하도록 하려면 iNCManagerClass 속성을 클래스 객체나 사용자 정의 클래스의 문자열 이름으로 설정합니다. FLVPlayback 클래스에는 사용자 정의 클래스의 정의가 포함되지만 VideoPlayer에는 포함되지 않습니다.

기본값은 문자열인 "fl.video.NCManager"입니다.

비디오 스트림이 실시간인 경우 true인 부울 값 속성입니다. 이 속성은 Flash Media Server와 같은 비디오 서버나 기타 Flash Video Streaming Service에서 스트리밍하는 경우에만 적용됩니다. HTTP 다운로드에서는 이 속성 값이 무시됩니다.

사전 녹화된 비디오 스트림을 비디오 플레이어로 전송할 때에는 isLive 속성을 false로 설정하고, 실시간 브로드캐스팅과 같은 실시간 데이터를 전송할 때에는 true로 설정합니다. 성능을 높이려면 isLive 속성을 false로 설정할 때 bufferTime 속성을 0으로 설정하지 마십시오.

관련 API 요소

RTMP를 사용하여 FMS(Flash Media Server)에서 FLV 파일을 스트리밍하는 경우 true로 설정되는 부울 값입니다. 다른 FLV 파일 소스에 대해서는 false입니다.

관련 API 요소

NetSteam.onMetaData() 콜백 메서드(사용 가능한 경우)를 호출하여 받은 메타데이터 정보 패킷 객체입니다. metadataReceived 이벤트가 전달되면 준비됩니다.

FLV 파일이 Flash 8 인코더로 인코딩된 경우 metadata 속성에는 다음과 같은 정보가 들어 있습니다. 이전의 FLV 파일에는 height, width 및 duration 값만 들어 있습니다.

관련 API 요소

INCManager 객체는 NCManager 클래스의 인터페이스인 INCManager를 구현하는 클래스의 인스턴스에 대한 액세스를 제공합니다.

이 속성을 사용하여 사용자 정의 초기화가 필요한 사용자 정의 INCManager를 구현할 수 있습니다.

관련 API 요소

VideoPlayer에서 생성된 NetConnection 인스턴스에 직접 액세스할 수 있습니다.

VideoPlayer에서 생성된 NetStream 인스턴스에 직접 액세스할 수 있습니다.

NetStream의 클라이언트 속성에 사용자 정의 클래스를 등록합니다. 기본적으로 fl.video.VideoPlayerClient가 사용되며 이 클래스는 onMetaData() 및 onCuePoint() 메시지를 처리합니다. onImageData() 및onTextData()와 같은 다른 메시지에 대해 사용자 정의 처리 작업을 추가하려면 클래스를 직접 만들고 해당 클래스에 이 속성을 설정합니다.

해당 클래스의 생성자는 VideoPlayer 인스턴스만 매개 변수로 사용해야 하며 부울 값을 갖는 ready 속성을 가져야 합니다. Client가 파일 시작 부분에 나오는 데이터 메시지를 기다리는 동안에는 이 속성이 false가 됩니다. 이러한 메시지가 수신되기 전에 VideoPlayer가 autorewind로 조정되면 메시지가 수신되지 않을 수도 있습니다. 기본적으로 fl.video.VideoPlayerClient는 onMetaData()가 호출되는 즉시 ready 속성에서 true를 반환합니다.

이 속성을 클래스 객체 자체(아래 예제 참조) 또는 클래스의 문자열 이름으로 설정할 수 있습니다.

        import fl.video.
        VideoPlayer.netStreamClientClass = MyCustomClient;
        

이 속성을 해당 클래스의 문자열 이름으로 설정하는 것만으로는 해당 클래스가 SWF로 컴파일되게 할 수 없습니다. 기본값은 문자열 이름이 아니라 클래스 객체인 fl.video.VideoPlayerClient입니다.

모든 사용자 정의 구현은 하위 클래스 fl.video.VideoPlayer로 분류하는 것이 좋습니다. 그렇지 않으면 VideoPlayer 및 FLVPlayback 구성 요소에 내장되어 있는 메타데이터 및 큐 포인트 처리가 손상될 위험이 있습니다.

기본값: fl.video.VideoPlayerClient.

현재 재생 헤드 시간 또는 위치를 초 단위로 나타내는 숫자(소수 사용 가능)입니다. 이 속성을 설정하면 seek 이벤트를 트리거하며 seek 이벤트의 모든 제한 사항이 적용됩니다.

FLV 파일이 재생되는 동안 0.25초마다 업데이트되는 것을 포함하여 재생 헤드 시간이 변경되면 이 구성 요소에서 playheadUpdate 이벤트를 전달합니다.

검색 메서드 중 하나를 호출한 후 또는 검색을 위해 playheadTime을 설정한 후 몇 가지 이유로 인해 playheadTime 속성에서 예상된 값을 즉시 얻지 못할 수 있습니다. 첫째, 점진적인 다운로드를 위해서는 키프레임만을 검색할 수가 있으므로 검색을 하면 지정된 시간 다음의 첫 번째 키프레임 시간으로 연결됩니다. 즉, 스트리밍 중에는 FLV 소스 파일에 키프레임이 없어도 검색을 통해 항상 지정된 시간으로 정확히 이동합니다. 둘째, 검색은 비동기적이므로 검색 메서드를 호출하거나 playheadTime 속성을 설정해도 playheadTime이 즉시 업데이트되지는 않습니다. 검색이 완료된 후에 시간을 구하려면 seek 이벤트를 수신하면 됩니다. 이 이벤트는 playheadTime 속성이 업데이트되기 전에는 발생하지 않습니다.

관련 API 요소

각 playheadUpdate 이벤트 사이의 시간 간격을 밀리초 단위로 표시하는 숫자입니다. FLV 파일을 재생하는 동안 이 속성을 설정하면 타이머가 다시 시작됩니다.

ActionScript 큐 포인트는 재생 헤드가 업데이트될 때 시작하므로 playheadUpdateInterval 속성 값을 줄이면 ActionScript 큐 포인트의 정확도가 높아집니다.

재생 헤드 업데이트 간격은 전역 setInterval() 메서드 호출에 의해 설정되므로, 업데이트는 이러한 방식으로 설정된 다른 모든 간격과 마찬가지로 SWF 파일 프레임 속도보다 더 자주 발생할 수는 없습니다. 따라서 예를 들어 기본 프레임 속도가 12fps(초당 프레임 수)인 경우에 설정할 수 있는 최소 유효 간격은 약 83밀리초, 즉 1초(1000밀리초)를 12로 나눈 값입니다.

기본값: 250.

관련 API 요소

각 progress 이벤트 사이의 시간 간격을 밀리초 단위로 표시하는 숫자입니다. 비디오 스트림을 재생하는 동안 이 속성을 설정하면 타이머가 다시 시작됩니다.

자동 크기 조정 시 비디오 내용을 정렬하는 데 사용되는 높이입니다. registrationHeight 속성과 height 속성을 혼동하지 마십시오. height 속성은 비디오 내용의 실제 높이를 반영합니다.

예제 1에서는 다음 설정으로 80x80 FLV 파일을 로드합니다.

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

예제 2에서는 다음 설정으로 예제 1과 같은 시나리오를 로드합니다.

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

예제 3에서는 다음 설정으로 예제 2와 같은 시나리오를 로드합니다.

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

registrationHeight 속성을 설정하는 것은 height 속성을 설정하는 것과 같으며 그 반대의 경우도 마찬가지입니다. 다른 속성을 설정하거나 폭을 변경하는 메서드(예: scaleX, setSize 및 setScale)를 호출해도 height와 registrationHeight를 동기화 상태로 유지합니다.

관련 API 요소

자동 크기 조정 시 비디오 내용을 정렬하는 데 사용되는 폭입니다. registrationWidth 속성과 width 속성을 혼동하지 마십시오. width 속성은 비디오 내용의 실제 폭을 반영합니다.

예제 1에서는 다음 설정으로 80x80 FLV 파일을 로드합니다.

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

예제 2에서는 다음 설정으로 예제 1과 같은 시나리오를 로드합니다.

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

예제 3에서는 다음 설정으로 예제 2와 같은 시나리오를 로드합니다.

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

registrationWidth 속성을 설정하는 것은 width 속성을 설정하는 것과 같으며 그 반대의 경우도 마찬가지입니다. 다른 속성을 설정하거나 폭을 변경하는 메서드(예: scaleX, setSize 및 setScale)를 호출해도 width와 registrationWidth를 동기화 상태로 유지합니다.

관련 API 요소

자동 크기 조정 시 비디오 내용을 정렬하는 데 사용되는 x 좌표입니다. 비디오 내용의 실제 위치를 반영하는 x 속성과 혼동하지 마십시오.

예제 1에서는 다음 설정으로 80x80 FLV 파일을 로드합니다.

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

예제 2에서는 다음 설정으로 예제 1과 같은 시나리오를 로드합니다.

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

예제 3에서는 다음 설정으로 예제 2와 같은 시나리오를 로드합니다.

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

x 또는 registrationX 속성을 설정하면 첫 번째 속성에서 오프셋을 유지할 수 있도록 두 번째 속성이 변경됩니다. 예를 들어 x가 10이고 registrationX는 20인 경우 x를 110으로 설정하면 registrationX도 120으로 설정됩니다.

관련 API 요소

자동 크기 조정 시 비디오 내용을 정렬하는 데 사용되는 y 좌표입니다. 비디오 내용의 실제 위치를 반영하는 y 속성과 혼동하지 마십시오.

예제 1에서는 다음 설정으로 80x80 FLV 파일을 로드합니다.

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

예제 2에서는 다음 설정으로 예제 1과 같은 시나리오를 로드합니다.

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

예제 3에서는 다음 설정으로 예제 2와 같은 시나리오를 로드합니다.

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

y 또는 registrationY 속성을 설정하면 첫 번째 속성에서 오프셋을 유지할 수 있도록 두 번째 속성이 변경됩니다. 예를 들어 y가 10이고 registrationY는 20인 경우 y를 110으로 설정하면 registrationY도 120으로 설정됩니다.

관련 API 요소

로드한 후에 비디오 크기 조절 방법을 지정합니다. VideoScaleMode.MAINTAIN_ASPECT_RATIO로 설정하면 registrationX, registrationY, registrationWidth 및 registrationHeight에서 정의한 사각형 내에서 비디오 종횡비를 유지합니다. VideoScaleMode.NO_SCALE로 설정하면 비디오 크기를 자동으로 소스 FLV 파일의 크기에 맞춰 조절합니다. VideoScaleMode.EXACT_FIT로 설정하면 소스 FLV 파일의 크기가 무시되고 비디오가 registrationX, registrationY, registrationWidth 및 registrationHeight에 따라 정의된 사각형에 맞게 확대됩니다. FLV 파일을 로드한 후 이와 같이 설정하면 자동 레이아웃 조정이 즉시 시작됩니다. 값은 VideoScaleMode에서 전달됩니다.

기본값: VideoScaleMode.MAINTAIN_ASPECT_RATIO.

관련 API 요소

가로 크기를 지정하는 숫자입니다.

기본값: 1.

관련 API 요소

세로 크기를 지정하는 숫자입니다.

기본값: 1.

관련 API 요소

NetStream.soundTransform 속성에 대한 직접 액세스를 제공하여 기타 사운드 컨트롤 기능을 사용할 수 있도록 합니다. 이 속성을 지정하여 설정을 변경하고 속성의 getter 접근자 메서드를 사용하여 현재 설정을 가져올 수 있습니다.

관련 API 요소

스트리밍할 FLV 파일의 URL 및 스트리밍 방식을 지정하는 문자열입니다. 이 URL로는 FLV 파일에 대한 HTTP URL, 스트림에 대한 RTMP URL 또는 XML 파일에 대한 HTTP URL을 사용할 수 있습니다.

[구성 요소 관리자] 또는 속성 관리자에서 이 속성을 설정하면 다음 enterFrame 이벤트가 발생할 때 FLV 파일이 로드되어 재생되기 시작합니다. 이와 같이 지연되면 여러 속성 중 로드 작업에 영향을 주는 isLive, autoPlay 및 cuePoints 속성을 설정할 수 있는 시간이 생깁니다. 또한 첫 번째 프레임에 배치된 ActionScript가 재생을 시작하기 전에 FLVPlayback 구성 요소에 영향을 줄 수 있습니다.

ActionScript를 통해 이 속성을 설정한 경우 autoPlay 속성이 false로 설정되면 즉시 VideoPlayer.load() 메서드를 호출하고, 또는 autoPlay 속성이 true로 설정된 경우 VideoPlayer.play() 메서드를 호출합니다. autoPlay, totalTime 및 isLive 속성은 새 FLV 파일의 로드 방식에 영향을 주므로 이러한 속성은 source 속성을 설정하기에 앞서 설정해야 합니다.

새 FLV 파일이 자동으로 재생되지 않도록 하려면 autoPlay 속성을 false로 설정합니다.

관련 API 요소

구성 요소의 상태를 지정하는 문자열입니다. 이 속성은 load(), play(), stop(), pause() 및 seek() 메서드를 사용하여 설정합니다.

state 속성에서 사용할 수 있는 값은 buffering, connectionError, disconnected, loading, paused, playing, rewinding, seeking 및 stopped입니다. FLVPlayback 클래스 속성을 사용하여 이러한 상태를 테스트할 수 있습니다.

관련 API 요소

반응할 수 있는 상태이면 true로 설정되는 부울 값입니다. 응답할 수 없는 상태인 경우 play(), load(), stop(), pause() 및 seek() 메서드에 대한 호출은 응답 가능한 상태로 바뀔 때까지 대기열에 있다가 나중에 실행됩니다. 이러한 호출은 대기열에 있다가 나중에 실행되므로 일반적으로 stateResponsive 속성 값을 추적할 필요는 없습니다. 응답 가능한 상태는 stopped, playing, paused 및 buffering 상태입니다.

관련 API 요소

비디오의 총 재생 시간을 초 단위로 나타내는 숫자입니다.

FMS(Flash Media Server)에서 스트리밍하고 기본 NCManager를 사용하는 경우 이 값은 서버측 API(Application Programming Interface)에서 자동으로 결정됩니다. 이렇게 설정된 값은 이 속성을 통해 설정되거나 메타데이터를 통해 수집된 모든 설정보다 우선합니다. source 속성을 설정한 후 stopped 또는 playing 상태에 도달하면 이 속성을 확인할 수 있습니다. FMS에서 실시간으로 스트리밍하는 경우에는 이 속성이 아무런 의미가 없습니다.

HTTP 다운로드를 사용할 때 FLV 파일에 메타데이터가 포함되어 있으면 이 값이 자동으로 결정되고, 그렇지 않은 경우 명시적으로 설정하지 않으면 NaN이 됩니다. 이 값을 명시적으로 설정하면 스트림의 메타데이터 값이 무시됩니다.

이 속성을 설정하는 경우 이 값은 source 설정에 따라 로드되는 다음 FLV에 영향을 줍니다. 이미 로드된 FLV 파일에는 아무런 영향을 주지 않습니다. 또한 FLV 파일이 로드될 때까지 이 속성은 전달된 새 값을 반환하지 않습니다.

이 속성을 설정(명시적으로 또는 자동으로)하지 않더라도 재생에는 아무런 문제가 없지만 검색 컨트롤을 사용할 때 문제가 발생할 수 있습니다.

값을 명시적으로 설정하지 않으면 메타데이터에서 유효한 값으로 설정할 때까지 NaN이 됩니다.

관련 API 요소

로드된 FLV 파일의 소스 폭입니다. 아직 사용할 수 있는 정보가 없는 경우 이 속성은 -1을 반환합니다.

관련 API 요소

로드된 FLV 파일의 소스 폭입니다. 아직 사용할 수 있는 정보가 없는 경우 이 속성은 -1을 반환합니다.

관련 API 요소

true로 설정하면 VideoPlayer 인스턴스를 화면에 표시하는 부울 값입니다. false로 설정하면 구성 요소를 표시하지 않습니다.

기본값: true.

볼륨 컨트롤 설정을 나타내는 0에서 1까지의 숫자입니다.

기본값: 1.

관련 API 요소

스테이지에서 VideoPlayer 인스턴스의 폭을 지정하는 숫자입니다.

참고: flash.media.Video.width 속성은 fl.video.VideoPlayer.videoWidth 속성과 비슷합니다.

관련 API 요소

비디오 플레이어의 가로 위치를 픽셀 단위로 지정하는 숫자입니다.

x 속성을 설정하면 registrationX 속성에도 영향을 줍니다. x 또는 registrationX 속성을 설정하면 첫 번째 속성에서 오프셋을 유지할 수 있도록 두 번째 속성이 변경됩니다. 예를 들어 x가 10이고 registrationX는 20인 경우 x를 110으로 설정하면 registrationX도 120으로 설정됩니다.

관련 API 요소

비디오 플레이어의 세로 위치를 픽셀 단위로 지정하는 숫자입니다.

y 속성을 설정하면 registrationY 속성에도 영향을 줍니다. y 또는 registrationY 속성을 설정하면 첫 번째 속성에서 오프셋을 유지할 수 있도록 두 번째 속성이 변경됩니다. 예를 들어 y가 10이고 registrationY는 20인 경우 y를 110으로 설정하면 registrationY도 120으로 설정됩니다.

관련 API 요소

지정된 폭과 높이로 VideoPlayer 객체를 만듭니다.

관련 API 요소

비디오 스트림 및 Flash Media Server 연결을 강제로 닫습니다. 이 메서드가 close 이벤트를 트리거합니다. 유휴 시간 제한 기능을 통해 스트림이 닫히므로 일반적으로 이 메서드를 직접 호출하지 않아도 됩니다.

관련 API 요소

play() 메서드와 비슷하지만 FLV 파일이 재생되지 않으면서 로드됩니다. FLV 파일의 첫 번째 프레임이 표시되면 필요한 경우 자동으로 크기가 조정됩니다. 초기 로드 및 자동 배치 후에는 VideoState.PAUSED 상태가 됩니다.

load() 메서드는 play() 메서드와 매개 변수가 같지만 URL 없이 호출할 수 없습니다. 그렇게 할 경우 오류가 발생합니다. 비디오 플레이어가 응답할 수 없는 상태이면 load() 메서드가 요청을 대기열에 보관합니다.

매개 변수

관련 API 요소

INCManager.connectToURL() 메서드를 호출한 후 연결이 완료되거나 실패한 후에 INCManager에 의해 호출됩니다. 연결이 실패한 경우에는 호출하기 전에 INCManager.netConnection 속성을 null 또는 undefined로 설정합니다.

관련 API 요소

INCManager.reconnect() 메서드를 호출한 후 재연결이 완료되거나 실패한 경우에 INCManager에서 호출합니다. 연결이 실패한 경우에는 호출하기 전에 INCManager.netconnection 속성을 null로 설정합니다.

관련 API 요소

비디오 재생을 일시 정지합니다. 비디오가 일시 정지 또는 중단된 상태이면 아무런 효과가 없습니다. 다시 재생을 시작하려면 play()를 호출합니다. 매개 변수를 사용하지 않습니다.

플레이어가 응답할 수 없는 상태인 경우 pause() 메서드는 요청을 대기열에 보관합니다.

연결된 스트림이 없을 때 호출되면 예외가 발생합니다. 이 메서드를 안전하게 호출할 수 있는 때를 확인하려면 stateChange 이벤트와 connected 속성을 사용합니다.

플레이어가 중단 상태인 경우에는 pause() 메서드를 호출해도 아무 작업이 수행되지 않으며 플레이어는 중단 상태를 그대로 유지합니다.

관련 API 요소

비디오를 재생합니다. 비디오가 일시 정지되거나 중단되거나 이미 재생 중일 때 호출할 수 있습니다. 이미 로드된 비디오를 재생하거나 URL을 전달하여 새 스트림을 로드하려면 인수를 사용하지 않고 이 메서드를 호출합니다.

플레이어가 응답할 수 없는 상태이면 요청을 대기열에 보관합니다.

연결된 스트림이 없을 때 인수 없이 호출된 경우 예외를 발생시킵니다. 이 메서드를 언제 안전하게 호출할 수 있는지 확인하려면 stateChange 이벤트와 connected 속성을 사용합니다.

매개 변수

관련 API 요소

FLV 파일이 충분히 다운로드되었을 때 재생합니다. FLV 파일이 다운로드되었거나 FMS(Flash Media Server)에서 스트리밍하는 경우 playWhenEnoughDownloaded() 메서드를 호출하면 매개 변수 없이 play() 메서드를 호출하는 것과 같은 결과가 발생합니다. 이 메서드를 호출하면 재생이 일시 정지되지 않으므로 많은 경우 이 메서드를 호출하기에 앞서 pause() 메서드를 호출할 수 있습니다.

파일에서 소수점 이하 세 자리까지 초 단위(밀리초)로 지정된 시간을 검색합니다. 비디오가 재생 중이면 해당 시점부터 계속 재생합니다. 비디오가 일시 정지되어 있으면 해당 시점을 검색하고 일시 정지된 상태를 유지합니다. 중단된 경우 비디오는 해당 시점을 검색하고 일시 정지 상태로 전환합니다. 실시간 스트림에는 아무런 영향을 주지 않습니다.

검색 메서드 중 하나를 호출하거나 검색을 위해 playheadTime을 설정한 후에 playheadTime 속성에서 예상된 값을 즉시 얻지 못할 수 있습니다. 점진적인 다운로드의 경우 키프레임만 검색할 수 있으므로 검색을 하면 지정된 시간 이후의 첫 번째 키프레임 시간으로 연결됩니다.

참고: 스트리밍을 사용하는 경우에는 소스 FLV 파일 중 해당 위치에 키프레임이 없더라도 지정된 시간으로 항상 정확히 이동할 수 있습니다.

검색은 비동기적이므로 검색 메서드를 호출하거나 playheadTime 속성을 설정해도 playheadTime이 즉시 업데이트되지는 않습니다. 검색이 완료된 후 시간을 가져오려면 seek 이벤트를 수신합니다. 이 절차는 playheadTime 속성이 업데이트되기 전에는 시작되지 않습니다.

연결된 스트림이 없을 때 호출되면 예외가 발생합니다. 이 메서드를 언제 안전하게 호출할 수 있는지 확인하려면 stateChange 이벤트와 connected 속성을 사용합니다.

매개 변수

관련 API 요소

scaleX 및 scaleY 속성을 동시에 설정합니다. scaleX 또는 scaleY를 개별적으로 설정하면 두 개의 autolayout 이벤트가 트리거되지만 setScale() 메서드를 호출하면 autolayout 이벤트가 하나만 발생합니다.

scaleMode 속성이 VideoScaleMode.MAINTAIN_ASPECT_RATIO 또는 VideoScaleMode.NO_SCALE인 경우 이 메서드를 호출하면 autolayout 이벤트가 즉시 발생합니다.

매개 변수

관련 API 요소

width 및 height 속성을 동시에 설정합니다. width 또는 height를 개별적으로 설정하면 두 개의 autolayout 이벤트가 트리거되지만 setSize() 메서드를 호출하면 autolayout 이벤트가 하나만 발생합니다.

scaleMode 속성이 VideoScaleMode.MAINTAIN_ASPECT_RATIO 또는 VideoScaleMode.NO_SCALE로 설정된 경우 이 메서드를 호출하면 바로 autolayout 이벤트가 트리거됩니다.

매개 변수

관련 API 요소

비디오 재생을 중단합니다. autoRewind가 true로 설정되어 있으면 첫 프레임까지 되감습니다. 비디오가 이미 중단된 상태이면 아무런 효과가 없습니다. 다시 재생을 시작하려면 play()를 호출합니다. 매개 변수를 사용하지 않습니다.

플레이어가 응답할 수 없는 상태이면 요청을 대기열에 보관합니다.

연결된 스트림이 없을 때 호출되면 예외가 발생합니다. 이 메서드를 안전하게 호출할 수 있는 때를 확인하려면 stateChange 이벤트와 connected 속성을 사용합니다.

관련 API 요소

autoRewind 속성이 true로 설정되어 재생 헤드가 비디오 플레이어의 시작 부분으로 이동할 때 전달됩니다.

autoRewound 이벤트는 VideoEvent 유형이며 VideoEvent.AUTO_REWOUND 상수를 가집니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

VideoPlayer 인스턴스가 시간 제한 또는 close() 메서드 호출을 통해 NetConnection을 닫거나, 사용자가 load() 또는 play() 메서드를 호출하거나 source 속성을 설정하여 RTMP 연결을 닫을 때 전달됩니다. FLVPlayback 인스턴스는 FMS(Flash Media Server) 또는 기타 FVSS(Flash Video Streaming Service)에서 스트리밍할 때만 이 이벤트를 전달합니다.

close 이벤트는 VideoEvent 유형이며 VideoEvent.CLOSE 상수를 갖습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

플레이어가 FLV 파일의 끝에 도달하여 재생이 완료될 때 전달됩니다. stop() 또는 pause() 메서드를 호출하거나 해당 컨트롤을 클릭하면 구성 요소가 이 이벤트를 전달하지 않습니다.

응용 프로그램에서 점진적 다운로드를 사용할 경우 totalTime 속성이 명시적으로 설정되지 않고, 메타데이터에 재생 시간을 지정하지 않은 FLV 파일이 다운로드됩니다. 이 경우 비디오 플레이어가 이 이벤트를 전달하기에 앞서 totalTime 속성을 대략적인 총 시간으로 설정합니다.

비디오 플레이어에서는 stateChange 및 stopped 이벤트도 전달합니다.

complete 이벤트는 VideoEvent 유형이며 VideoEvent.COMPLETE 상수를 갖습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

큐 포인트에 도달했을 때 전달되는 이벤트입니다. 이 이벤트 객체에는 FLV 파일 큐 포인트에 대한 NetStream.onCuePoint 이벤트 콜백에 의해 수신된 info 객체를 포함하는 info 속성이 있습니다. ActionScript 큐 포인트의 경우 이 이벤트에는 ActionScript 큐 포인트 메서드 또는 속성으로 전달된 객체가 포함되어 있습니다.

cuePoint 이벤트는 MetadataEvent 유형이며 MetadataEvent.CUE_POINT 상수를 갖습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

drmAuthenticate 이벤트

drmError 이벤트

drmError 이벤트

비디오 플레이어를 배치하거나 크기를 조정할 때 전달됩니다. 이 이벤트는 다음과 같은 두 가지 경우에 전달됩니다.

• autoLayout 이벤트를 사용하거나 setScale() 또는 setSize() 메서드를 호출하거나 width, height, scaleX 및 scaleY 속성을 변경하여 비디오 플레이어를 배치하는 경우
• 크기가 서로 다른 비디오 플레이어 두 개가 있고 visibleVideoPlayerIndex 속성이 한 비디오 플레이어에서 다른 비디오 플레이어로 전환되는 경우

layout 이벤트는 LayoutEvent 유형이며 LayoutEvent.LAYOUT 상수를 가집니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

FLV 파일의 메타데이터에 처음 도달할 때 전달됩니다. 이 이벤트 객체에는 NetStream.onMetaData 이벤트 콜백에 의해 수신된 info 객체를 포함하는 info 속성이 있습니다.

metadataReceived 이벤트는 MetadataEvent 유형이며 MetadataEvent.METADATA_RECEIVED 상수를 갖습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

FLV 파일이 playheadUpdateInterval 속성에 지정한 빈도로 재생되는 동안, 또는 되감기가 시작될 때 전달되는 이벤트입니다. 비디오 플레이어가 일시 정지 또는 중단된 상태에서는 검색 작업이 발생하지 않는 한 구성 요소에서 이 이벤트를 전달하지 않습니다.

playheadUpdate 이벤트는 VideoEvent 유형이며 VideoEvent.PLAYHEAD_UPDATE 상수를 갖습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

진행률을 다운로드한 바이트 수로 나타냅니다. 로드를 시작할 때부터 모든 바이트를 로드하거나 네트워크 오류가 발생할 때까지 progressInterval 속성에 지정된 빈도에 따라 전달되는 이벤트입니다. 기본값으로 설정하면 load를 호출할 때 시작하여 모든 바이트를 로드하거나 네트워크 오류가 발생할 때까지 0.25초마다 전달됩니다. 이 이벤트를 사용하여 로드된 바이트나 버퍼에 있는 바이트 수를 확인할 수 있습니다.

점진적 HTTP 다운로드를 사용하는 경우에만 전달됩니다. 진행률을 다운로드한 바이트 수로 나타냅니다. 이 이벤트 객체에는 같은 이름의 FLVPlayback 속성과 동일한 bytesLoaded 및 bytesTotal 속성이 있습니다.

progress 이벤트는 VideoProgressEvent 유형이며 VideoProgressEvent.PROGRESS 상수를 갖습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

FLV 파일이 로드되어 표시할 준비가 되었을 때 전달되는 이벤트입니다. 이 이벤트는 play() 또는 load() 메서드를 사용하여 새 FLV 파일을 로드한 후 처음으로 응답 가능한 상태가 되었을 때 시작됩니다. 또한 로드되는 각 FLV 파일에 대해 한 번만 발생합니다.

ready 이벤트는 VideoEvent 유형이며 VideoEvent.READY 상수를 갖습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

재생 상태가 변경될 때 전달되는 이벤트입니다. autoRewind 호출이 완료되면 stateChange 이벤트가 되감기 상태로 전달됩니다. 되감기가 끝날 때까지 stateChange 이벤트는 시작되지 않습니다.

이 이벤트는 재생 시 응답할 수 없는 상태(예: 연결, 크기 조정 또는 되감기 작업 중)가 되거나 응답 가능한 상태로 전환되는 시점을 추적하는 데 사용할 수 있습니다. play(), pause(), stop() 및 seek() 메서드는 플레이어가 응답 가능한 상태가 될 때 실행할 요청을 대기열에 보관합니다.

stateChange 이벤트는 VideoEvent 유형이며 VideoEvent.STATE_CHANGE 상수를 갖습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

구성 요소의 짧은 버전 번호를 나타내는 상태 변수입니다. 버전 번호는 FLA 파일이 있으며 구성 요소 버전을 알아야 하는 경우에 유용합니다. 구성 요소 버전을 확인하려면 다음 코드를 FLA 파일에 입력합니다.

FLVPlayback.SHORT_VERSION

SHORT_VERSION 변수에는 2.0과 같이 주 버전 번호와 부 버전 번호만 포함됩니다. VERSION 변수에는 2.0.0.11과 같이 주 버전 번호, 부 버전 번호, 개정 번호 및 빌드 번호가 포함됩니다.

관련 API 요소

구성 요소의 긴 버전 번호를 나타내는 상태 변수입니다. 버전 번호는 FLA 파일이 있으며 구성 요소 버전을 알아야 하는 경우에 유용합니다. 구성 요소 버전을 확인하려면 다음 코드를 FLA 파일에 입력합니다.

FLVPlayback.VERSION

VERSION 변수에는 2.0.0.11과 같이 주 버전 번호, 부 버전 번호, 개정 번호 및 빌드 번호가 포함됩니다. SHORT_VERSION 변수에는 2.0과 같이 주 버전 번호와 부 버전 번호만 포함됩니다.

관련 API 요소

예제를 실행하려면 다음 단계를 수행합니다.

1. 라이브러리에 FLVPlayback 구성 요소를 추가합니다.
2. testVideoPath를 FLV 파일의 절대 또는 상대 경로로 바꿉니다.
3. 이 코드를 FLA 파일과 같은 디렉토리에 VideoPlayerExample.as로 저장합니다.
4. FLA 파일의 Document 클래스를 VideoPlayerExample로 설정합니다.

package
{
    import fl.video.VideoPlayer;
    import flash.display.Sprite;
    import flash.filters.BlurFilter;

    public class VideoPlayerExample extends Sprite 
    {
        private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv"
        private var player:VideoPlayer;
        private var blurryPlayer:VideoPlayer;
        
        public function VideoPlayerExample() {
            player = new VideoPlayer();
            player.play(videoPath);
            player.setScale(0.75, 0.75);
            addChild(player);
            
            blurryPlayer = new VideoPlayer();
            blurryPlayer.play(videoPath);
            blurryPlayer.setScale(0.75,0.75);
            blurryPlayer.filters = [ new BlurFilter(8, 8, 1) ];
            blurryPlayer.x = 250;
            addChild(blurryPlayer);            
        }
    }
}