| 패키지 | flash.media |
| 클래스 | public final class SoundTransform |
| 상속 | SoundTransform Object |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
관련 API 요소
flash.display.SimpleButton.soundTransform
flash.display.Sprite.soundTransform
flash.media.Microphone.soundTransform
flash.media.SoundChannel.soundTransform
flash.media.SoundMixer.soundTransform
flash.net.NetStream.soundTransform
flash.display.Sprite.soundTransform
flash.media.Microphone.soundTransform
flash.media.SoundChannel.soundTransform
flash.media.SoundMixer.soundTransform
flash.net.NetStream.soundTransform
공용 속성
| 속성 | 정의 주체 | ||
|---|---|---|---|
![]() | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| leftToLeft : Number
왼쪽 스피커에서 재생할 왼쪽 입력 양을 지정하는 값으로 0(없음)부터 1(전부)까지 가능합니다. | SoundTransform | ||
| leftToRight : Number
오른쪽 스피커에서 재생할 왼쪽 입력 양을 지정하는 값으로 0(없음)부터 1(전부)까지 가능합니다. | SoundTransform | ||
| pan : Number
-1(왼쪽 최대 패닝)부터 1(오른쪽 최대 패닝)까지의 좌우 사운드 패닝입니다. | SoundTransform | ||
| rightToLeft : Number
왼쪽 스피커에서 재생할 오른쪽 입력 양을 지정하는 값으로 0(없음)부터 1(전부)까지 가능합니다. | SoundTransform | ||
| rightToRight : Number
오른쪽 스피커에서 재생할 오른쪽 입력 양을 지정하는 값으로 0(없음)부터 1(전부)까지 가능합니다. | SoundTransform | ||
| volume : Number
0(묵음)부터 1(최대 볼륨)까지의 볼륨입니다. | SoundTransform | ||
공용 메서드
| 메서드 | 정의 주체 | ||
|---|---|---|---|
SoundTransform 객체를 만듭니다. | SoundTransform | ||
![]() |
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
![]() |
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
![]() |
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
![]() |
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
![]() |
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
![]() |
지정된 객체의 문자열 표현을 반환합니다. | Object | |
![]() |
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
속성 세부 정보
leftToLeft | 속성 |
leftToRight | 속성 |
pan | 속성 |
rightToLeft | 속성 |
rightToRight | 속성 |
volume | 속성 |
생성자 세부 정보
SoundTransform | () | 생성자 |
public function SoundTransform(vol:Number = 1, panning:Number = 0)| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
SoundTransform 객체를 만듭니다.
매개 변수vol:Number (default = 1) — 0(묵음)부터 1(최대 볼륨)까지의 볼륨입니다.
| |
panning:Number (default = 0) — -1(왼쪽 최대 패닝)부터 1(오른쪽 최대 패닝)까지의 좌우 사운드 패닝입니다. 값 0은 패닝이 없음(중앙)을 나타냅니다.
|
예제 ( 예제 사용 방법 )
다음 예제에서는 오른쪽 채널에서만 사운드가 재생되고 볼륨은 50%로 설정됩니다.
생성자에서 사운드가 로드되고 사운드 채널(channel)에 할당됩니다. SoundTranform 객체(transform)도 생성됩니다. 첫 번째 인수는 볼륨을 50%로 설정합니다(범위: 0.0 ~ 1.0). 두 번째 인수는 패닝을 설정합니다. 이 예제에서 패닝은 1.0으로 설정되는데, 이는 오른쪽 스피커에서만 사운드가 재생됨을 의미합니다. 이러한 설정이 적용되도록 transform SoundTranform 객체가 사운드 채널의 souundTransform 속성에 할당됩니다.
참고: 이 예제에 대한 제한된 오류 처리가 기록됩니다.
package {
import flash.display.Sprite;
import flash.net.URLRequest;
import flash.media.Sound;
import flash.media.SoundChannel;
import flash.media.SoundTransform;
import flash.events.IOErrorEvent;
public class SoundTransform_constructorExample extends Sprite
{
public function SoundTransform_constructorExample() {
var mySound:Sound = new Sound();
var url:URLRequest = new URLRequest("mySound.mp3");
var channel:SoundChannel;
var transform:SoundTransform = new SoundTransform(0.5, 1.0);
mySound.load(url);
channel = mySound.play();
channel.soundTransform = transform;
mySound.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
}
private function errorHandler(errorEvent:IOErrorEvent):void {
trace("The sound could not be loaded: " + errorEvent.text);
}
}
}
예제 예제 사용 방법
SoundTransformExample.as
다음 예제에서는 MP3 파일을 로드하고 재생합니다. MP3 파일이 재생되면 마우스 또는 다른 사용자 입력 장치를 이동합니다. 사용자 입력 장치를 Stage 위로 움직이면 볼륨과 패닝이 변경됩니다. 이 예제를 실행하려면 MySound.mp3 파일을 SWF 파일과 같은 디렉토리에 넣습니다.
package {
import flash.display.Sprite;
import flash.display.StageAlign;
import flash.display.StageScaleMode;
import flash.events.*;
import flash.media.Sound;
import flash.media.SoundChannel;
import flash.media.SoundTransform;
import flash.net.URLRequest;
import flash.utils.Timer;
public class SoundTransformExample extends Sprite {
private var url:String = "MySound.mp3";
private var soundFactory:Sound;
private var channel:SoundChannel;
private var positionTimer:Timer;
public function SoundTransformExample() {
stage.align = StageAlign.TOP_LEFT;
stage.scaleMode = StageScaleMode.NO_SCALE;
var request:URLRequest = new URLRequest(url);
soundFactory = new Sound();
soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
soundFactory.load(request);
channel = soundFactory.play();
stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
}
private function ioErrorHandler(event:Event):void {
trace("ioErrorHandler: " + event);
}
private function setPan(pan:Number):void {
trace("setPan: " + pan.toFixed(2));
var transform:SoundTransform = channel.soundTransform;
transform.pan = pan;
channel.soundTransform = transform;
}
private function setVolume(volume:Number):void {
trace("setVolume: " + volume.toFixed(2));
var transform:SoundTransform = channel.soundTransform;
transform.volume = volume;
channel.soundTransform = transform;
}
private function mouseMoveHandler(event:MouseEvent):void {
var halfStage:uint = Math.floor(stage.stageWidth / 2);
var xPos:uint = event.stageX;
var yPos:uint = event.stageY;
var value:Number;
var pan:Number;
if (xPos > halfStage) {
value = xPos / halfStage;
pan = value - 1;
} else if (xPos < halfStage) {
value = (xPos - halfStage) / halfStage;
pan = value;
} else {
pan = 0;
}
var volume:Number = 1 - (yPos / stage.stageHeight);
setVolume(volume);
setPan(pan);
}
}
}
Tue Jun 12 2018, 03:17 PM Z
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시