패키지	flash.events
클래스	public class SampleDataEvent
상속	SampleDataEvent Event Object

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10, AIR 1.5

플레이어에 새 오디오 데이터가 필요할 때 전달됩니다.

동적으로 생성되는 오디오를 관리하려는 경우 이 이벤트를 사용합니다. 이 환경에서 Sound 객체에는 실제로 사운드 데이터가 들어 있지 않습니다. 대신 이 객체는 이 이벤트에 할당하는 함수를 통해 스트리밍되어 들어오는 사운드 데이터에 대한 소켓 역할을 합니다.

함수에서는 ByteArray.writeFloat() 메서드를 사용하여 재생할 샘플링 데이터가 들어 있는 ByteArray 객체(event.data)에 씁니다.

Sound.play()를 호출하면 플레이어에서 이벤트 핸들러를 호출하여 사운드 샘플이 들어 있는 데이터 청크를 요청하기 시작합니다. 플레이어는 사용자가 데이터 제공을 중단하거나 SoundChannel.stop()이 호출될 때까지 이벤트를 계속 전송하고 사운드를 재생합니다.

이벤트의 지연 시간은 플랫폼마다 다르며 Flash Player의 이후 버전에서 변경될 수 있습니다. 따라서 특정 지연 시간을 사용하는 대신 직접 계산해야 합니다. ActionScript에서 지연 시간을 계산하려면 ((SampleDataEvent.position/44.1) - SoundChannelObject.position) 공식을 사용합니다.

2048에서 8192 사이의 샘플을 SampleDataEvent 객체에 제공합니다. 최상의 성능을 위해 샘플을 최대한 많이 제공하는 것이 좋습니다. 제공하는 샘플이 적을수록 재생 중 잡음이 발생하거나 고르지 않게 재생될 가능성이 높습니다. 이러한 동작은 플랫폼마다 다를 수 있으며 여러 가지 상황(예: 브라우저 크기 조절 시)에서 발생할 수 있습니다. 한 플랫폼에서는 2048 샘플만 제공하는 코드가 문제없이 작동하지만 같은 코드가 다른 플랫폼에서는 잘 작동하지 않을 수 있습니다. 지연 시간을 최대한 낮추려면 사용자가 데이터 양을 선택할 수 있게 하는 것이 좋습니다.

2048보다 적은 샘플을 제공하면 Flash Player에서 나머지 샘플을 재생한 다음 사운드 파일의 끝에 도달한 경우와 같이 사운드를 중지하여 SoundComplete 이벤트를 발생시킵니다.

Sound.extract() 메서드를 사용하여 Sound 객체에서 데이터를 추출한 다음 동적 스트림에 기록하여 재생할 수도 있습니다.

이 이벤트를 Sound 객체와 함께 사용할 때 활성화되는 다른 Sound 메서드는 Sound.extract() 및 Sound.play()뿐입니다. 다른 메서드나 속성을 호출하면 "invalid call" 예외가 발생합니다. SoundChannel 객체의 모든 메서드와 속성은 계속 사용할 수 있습니다.

예제 보기

참고 사항

---

var mySound:Sound = new Sound();
function sineWaveGenerator(event:SampleDataEvent):void {
    for ( var c:int=0; c<8192; c++ ) {
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
    }
}

mySound.addEventListener(SampleDataEvent.SAMPLE_DATA,sineWaveGenerator);
mySound.play();