FLVPlaybackCaptioning  - AS3

FLVPlaybackCaptioning 구성 요소에서 캡션을 처리하기 위해 TextField 객체를 자동으로 이동하고 크기를 조정할지 여부를 결정합니다.

autoLayout 속성을 true로 설정하면 캡션이 포함된 DisplayObject 인스턴스나 TextField 객체가 FLVPlayback 인스턴스의 아래쪽에 10픽셀을 표시합니다. 캡션 영역은 FLVPlayback 인스턴스의 폭을 덮은 상태로 각 측면에 10픽셀의 여백을 유지합니다.

이 속성을 true로 설정하면 DisplayObject 인스턴스나 TextField 객체가 FLVPlayback 인스턴스 위에 직접 표시합니다. 직접 TextField 객체를 만드는 경우 autoLayout을 false로 설정해야 합니다. wordWrap = false이면 캡션 영역이 FLVPlayback 인스턴스의 가운데로 배치되지만 FLVPlayback 인스턴스보다 넓을 수 있습니다.

레이아웃을 제어하려면 captionChange 이벤트를 수신하여 TextField 객체 인스턴스가 만들어진 시기를 확인해야 합니다.

기본값: true.

관련 API 요소

캡션 기능을 설정 및 해제하는 전환 기능을 제공하는 captionButton FLVPlayback 사용자 정의 UI 구성 요소 인스턴스를 정의합니다.

captionButton 속성은 FLVPlayback 속성인 playButton, pauseButton, muteButton 등과 비슷하게 작동합니다.

관련 API 요소

캡션을 표시할 DisplayObject 인스턴스를 설정합니다.

인스턴스를 TextField 객체로 설정하면 직접 대상으로 지정됩니다. 인스턴스를 하나 이상의 TextField 객체가 포함된 DisplayObjectContainer로 설정하면 TextField 객체에 가장 낮은 표시 인덱스와 함께 캡션이 표시됩니다.

DisplayObjectContainer 메서드는 scale-9 배경의 동영상 클립 같은 객체를 지원합니다. 이 객체는 TextField 객체의 크기를 변경할 때 크기를 조절할 수 있습니다.

좀더 복잡한 크기 조절 및 드로잉이 필요한 경우 DisplayObjectContainer 메서드에서 captionChange 이벤트를 수신하는 코드를 작성합니다.

참고: captionTargetName 또는 captionTarget 속성이 설정되지 않으면 FLVPlaybackCaptioning 인스턴스에서 captionTarget 속성에 의해 다음 서식으로 설정된 텍스트 필드를 만듭니다.

• black background (background = true; backgroundColor = 0x000000;)
• white text (textColor = 0xFFFFFF )
• autoSize = TextFieldAutoSize.LEFT
• multiLine = true
• wordWrap = true
• font = "_sans"
• size = 12

이러한 값을 사용자 정의하려면 captionTargetCreated 이벤트를 수신합니다.

관련 API 요소

TextField 객체 또는 캡션이 포함된 TextField 객체를 둘러싼 MovieClip의 인스턴스 이름입니다.

대상을 지정하지 않으려면 이 속성을 빈 문자열(즉, 지정한 대상 없음)이나 auto로 설정합니다. 이 속성은 주로 [구성 요소 관리자]에서 사용됩니다. 코드를 작성하는 경우 이 속성 대신 captionTarget 속성을 사용합니다.

기본값: auto.

관련 API 요소

캡션 처리할 FLVPlayback 인스턴스를 설정합니다. FLVPlayback 인스턴스의 부모는 FLVPlaybackCaptioning 인스턴스의 부모와 동일해야 합니다.

flvPlaybackName 또는 flvPlayback 속성이 모두 설정되어 있지 않으면 FLVPlaybackCaptioning 인스턴스가 부모가 동일한 FLVPlayback 인스턴스를 검색하여 발견되는 첫 번째 인스턴스를 캡션 처리합니다.

관련 API 요소

캡션 처리할 FLVPlayback 인스턴스의 FLVPlayback 인스턴스 이름을 설정합니다.

대상을 지정하지 않으려면 이 속성을 빈 문자열이나 auto로 설정합니다. FLVPlayback 인스턴스의 부모는 FLVPlaybackCaptioning 인스턴스의 부모와 동일해야 합니다.

FLVPlayback 인스턴스 이름은 주로 [구성 요소 관리자]에서 사용됩니다. 코드를 작성하는 경우 flvPlayback 속성을 사용합니다.

flvPlaybackName 또는 flvPlayback 속성이 모두 설정되어 있지 않거나 auto로 설정되어 있으면 FLVPlaybackCaptioning 인스턴스가 부모가 동일한 FLVPlayback 인스턴스를 검색하여 발견되는 첫 번째 인스턴스를 캡션 처리합니다.

기본값: auto.

관련 API 요소

캡션을 표시하는 데 사용됩니다. true이면 캡션을 표시하고 false이면 캡션을 표시하지 않습니다.

captionButton 속성을 사용하여 사용자가 캡션을 설정하거나 해제할 수 있도록 하려면 showCaptions 속성을 false로 설정합니다.

기본값: true.

관련 API 요소

true로 설정되면 Timed Text 파일에서 서식 명령을 제한합니다.

simpleFormatting 속성이 true로 설정되면 다음 스타일이 지원되지 않습니다.

• tts:backgroundColor
• tts:color
• tts:fontSize
• tts:fontFamily
• tts:wrapOption

simpleFormatting 속성이 true로 설정되면 다음 스타일이 지원되지 않습니다.

• tts:fontStyle
• tts:fontWeight
• tts:textAlign

캡션 정보가 포함된 Timed Text XML 파일의 URL입니다(필수 속성).

다국어 트랙을 지원합니다.

track 속성을 가장 잘 사용하는 방법은 포함된 큐 포인트에 다국어 트랙을 지원하는 것입니다.

FLVPlaybackCaptioning 큐 포인트에 대해 지원되는 형식을 사용해야 합니다.

track 속성이 0이 아닌 다른 것으로 설정된 경우 FLVPlaybackCaptioning 구성 요소에서 큐 포인트에 대한 text<n> 속성을 검색합니다. 여기서 n은 트랙 값입니다.

예를 들어 track == 1이면 FLVPlayBackCaptioning 구성 요소에서 큐 포인트에 대한 매개 변수 text1을 검색합니다. 일치하는 매개 변수가 없으면 큐 포인트 매개 변수의 text 속성을 사용합니다.

기본값: 0.

FLVPlayback 구성 요소의 특정 VideoPlayer에 캡션을 연결합니다.

FLVPlayback 구성 요소의 activeVideoPlayerIndex 및 visibleVideoPlayerIndex 속성을 사용하여 여러 비디오 플레이어에서 캡션을 사용하려는 경우 사용할 각 VideoPlayer마다 FLVPlaybackCaptioning 구성 요소의 인스턴스를 하나씩 만들고 인덱스에 따라 이 속성을 설정해야 합니다.

비디오 플레이어가 하나만 사용되는 경우 VideoPlayer 인덱스의 기본값은 0입니다.

관련 API 요소

새 FLVPlaybackCaptioning 인스턴스를 만듭니다.

캡션 텍스트에 검색 문자열이 들어 있는 FLVPlayback 구성 요소 큐 포인트의 배열을 반환합니다.

매개 변수

캡션이 들어 있는 FLVPlayback 구성 요소 큐 포인트 배열을 반환합니다.

HTML 형식 사본과 같은 모든 캡션이 들어 있는 문자열을 반환합니다.

각 캡션은 class 특성("fl_video_caption"), 고유한 id 특성("fl_video_caption_2_0_"으로 시작되는 문자열) 및 title 특성(비디오에서 캡션이 표시되는 시간 코드)을 사용하여 p 태그 안에 포함되어 있습니다.

다음은 반환되는 HTML의 간단한 예입니다.

		 <div id="fl_video_transcript" class="fl_video_transcript">
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_1" title="0:00.50"><i>( speaking French ): </i><br/><b>George: </b> Bonjour, Marie.</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_2" title="0:01.75"><b>Marie: </b> Bonjour, George.</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_3" title="0:03.75">VoilÀ une sucette.</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_4" title="0:05.50"><b>George: </b> C'est pour moi?</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_5" title="0:06.50"><b>Marie: </b> Oui, c'est pour toi.</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_6" title="0:08.00"><b>George: </b> Merci, Marie!</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_7" title="0:09.50"><b>Marie: </b> De rien, George.</p>
		 </div>
		 

매개 변수

시간 코드 문자열과 같은 시간(초)을 반환합니다.

매개 변수

캡션 대상 텍스트 필드에서 캡션이 추가되거나 제거될 때 전달됩니다.

다음 조건을 만족하는 경우에도 이 이벤트가 전달됩니다.

• captionTargetName 속성이 설정되지 않은 경우
• captionTarget 속성이 설정되지 않은 경우
• FLVPlaybackCaptioning 인스턴스에서 캡션을 처리하기 위해 자동으로 TextField 객체를 만드는 경우

captionChange 이벤트에는 CaptionChangeEvent.CAPTION_CHANGE 상수가 있습니다.

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

관련 API 요소

captionTarget 속성이 만들어진 다음 캡션이 추가되기 전(captionTarget 속성이 비어 있을 때)에 전달됩니다.

사용자 정의 DisplayObject로 captionTarget 속성을 설정한 경우나 captionTargetName 속성을 설정한 경우에는 이 이벤트가 전달되지 않습니다.

이것은 defaultTextFormat 속성 같은 TextField 객체의 속성을 사용자 정의하는 경우 이 이벤트를 수신합니다.

captionTargetCreated 이벤트에는 CaptionTargetEvent.CAPTION_TARGET_CREATED 상수가 있습니다.

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

관련 API 요소

Timed Text XML 데이터가 모두 로드된 후에 전달됩니다.

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

관련 API 요소

URLLoader.load() 이벤트를 호출하여 HTTP를 통해 Timed Text XML 파일에 액세스를 시도하고 현재 Flash Player 환경에서 이 요청에 대한 상태 코드를 감지 및 반환할 수 있는 경우에 전달됩니다.

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

관련 API 요소

URLLoader.load() 이벤트 호출로 인해 치명적인 오류가 발생하여 Timed Text XML 파일의 다운로드가 종료된 경우에 전달됩니다.

이 이벤트가 처리되지 않는 경우 오류가 발생합니다.

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

관련 API 요소

URLLoader.load() 메서드 호출에 이어 Timed Text XML 파일을 로드하기 위한 다운로드 작업이 시작될 때 전달됩니다.

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

관련 API 요소

Timed Text XML 파일 다운로드가 진행되면서 데이터가 수신될 때 전달됩니다.

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

관련 API 요소

URLLoader.load() 이벤트를 호출하여 보안 샌드박스 외부의 서버에서 Timed Text XML 파일을 로드하려고 시도하는 경우에 전달됩니다.

이 이벤트가 처리되지 않는 경우 오류가 발생합니다.

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

관련 API 요소

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

trace (FLVPlaybackCaptioning.SHORT_VERSION);

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

관련 API 요소

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

trace (FLVPlaybackCaptioning.VERSION);

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

관련 API 요소

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

1. 새 Flash 파일(ActionScript 3.0)을 엽니다.
2. FLVPlayback 구성 요소를 스테이지의 0,0에 배치하고 인스턴스 이름을 player로 지정합니다.
3. FLVPlaybackCaptioning 구성 요소를 스테이지의 0,0에 배치하고 인스턴스 이름을 captioning으로 지정합니다.
4. 스테이지에 CaptionButton 구성 요소를 배치합니다.
5. FLA 파일을 저장하고 이름(예: captionEx)을 지정합니다.
6. 새 ActionScript 파일을 엽니다.
7. 새 ActionScript 파일에 다음 클래스 예제 코드를 붙여 넣고 FLA 파일과 같은 디렉토리에 FLVPlaybackCaptioningExample.as로 저장합니다.
8. FLA 파일(예: captionEx)의 속성 관리자에서 문서 클래스 항목을 FLVPlaybackCaptioningExample로 설정합니다.
9. [컨트롤] > [동영상 테스트]를 선택합니다.

package
{
    import fl.video.CaptionChangeEvent;
    import fl.video.FLVPlayback;
    import fl.video.FLVPlaybackCaptioning;
    import flash.display.Sprite;
    import flash.text.TextField;
    
    public class FLVPlaybackCaptioningExample extends Sprite {

        private var videoPath:String = "http://www.helpexamples.com/flash/video/caption_video.flv";
        private var captioningPath:String = "http://www.helpexamples.com/flash/video/caption_video.xml";
        
        public function FLVPlaybackCaptioningExample() {
            player.source = videoPath;
            player.skin = "SkinOverAllNoCaption.swf";
            player.skinBackgroundColor = 0x666666;
            player.skinBackgroundAlpha = 0.5;

            captioning.flvPlayback = player;
            captioning.source = captioningPath;
            captioning.autoLayout = false;            
            captioning.addEventListener(CaptionChangeEvent.CAPTION_CHANGE, onCaptionChange);
        }

        private function onCaptionChange(e:CaptionChangeEvent):void {
            var tf:* = e.target.captionTarget;
            var player:FLVPlayback = e.target.flvPlayback;

            // move the caption below the video
            tf.y = 210;            
        }
    }
}