Sound

메모리의 짧은 효과음을 재생하며, SoundBuffer를 보유하여 샘플 저장소를 유지합니다.

상속 관계

계층 (theme_hierarchy_view_summary)

SoundSource
- Sound

소스와 상속

멤버 목록53

생성자

constructor

속성

[audioHandle]
times
values
Conestatic
Statusstatic

생성자

constructor

new Sound(
    bufferOrSource:
        | Readonly<
            Pick<
                SoundBuffer,
                | typeof audioHandle
                | "getSamples"
                | "getSampleCount"
                | "getSampleRate"
                | "getChannelCount"
                | "getChannelMap"
                | "getDuration"
                | "saveToFile",
            >,
        >
        | Sound,
): Sound
오디오 버퍼를 연결하거나 Sound의 속성과 버퍼 참조를 복사합니다.

매개변수
bufferOrSource

    | Readonly<
        Pick<
            SoundBuffer,
            | typeof audioHandle
            | "getSamples"
            | "getSampleCount"
            | "getSampleRate"
            | "getChannelCount"
            | "getChannelMap"
            | "getDuration"
            | "saveToFile",
        >,
    >
    | Sound
반환값
Sound
소스와 상속
오버라이드 대상: SoundSource.constructor
- 정의 위치: src/audio/sound.ts:22

속성

`보호됨` `읽기 전용`times

times: BigInt64Array

소스와 상속

`보호됨` `읽기 전용`values

values: Float32Array

소스와 상속

`정적` `읽기 전용`Cone

Cone: typeof Cone = Cone

지향성 원뿔 설정 타입입니다.

소스와 상속

`정적` `읽기 전용`Status

Status: typeof SoundStatus = SoundStatus

재생 상태 열거형입니다.

소스와 상속

메소드

assign

assign(source: Sound): this
속성과 버퍼 연결을 복사하고 현재 Sound를 정지하여 재생 위치를 처음으로 되돌립니다.

매개변수
source
Sound
반환값
this
소스와 상속
오버라이드 대상: SoundSource.assign
- 정의 위치: src/audio/sound.ts:38

`보호됨`command

command(command: number): void
매개변수
command
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.command
- 정의 위치: src/audio/sound-source.ts:370

`보호됨`field

field(field: number, write: boolean): void
매개변수
field
number
write
boolean
반환값
void
소스와 상속
상속받은 타입: SoundSource.field
- 정의 위치: src/audio/sound-source.ts:373

`보호됨`get

get(field: number): number
매개변수
field
number
반환값
number
소스와 상속
상속받은 타입: SoundSource.get
- 정의 위치: src/audio/sound-source.ts:376

getAttenuation

getAttenuation(): number
거리 감쇠 계수를 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getAttenuation
- 정의 위치: src/audio/sound-source.ts:294

getBuffer

getBuffer(): Readonly
현재 연결된 버퍼의 읽기 전용 참조를 반환합니다.

반환값
Readonly
소스와 상속
- 정의 위치: src/audio/sound.ts:62

getCone

getCone(): Cone
지향성 원뿔 매개변수의 복사본을 반환합니다.

반환값
Cone
소스와 상속
상속받은 타입: SoundSource.getCone
- 정의 위치: src/audio/sound-source.ts:163

getDirection

getDirection(): Vector3f
소리 방출 방향의 복사본을 반환합니다.

반환값
Vector3f
소스와 상속
상속받은 타입: SoundSource.getDirection
- 정의 위치: src/audio/sound-source.ts:141

getDirectionalAttenuationFactor

getDirectionalAttenuationFactor(): number
지향성 감쇠 계수를 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getDirectionalAttenuationFactor
- 정의 위치: src/audio/sound-source.ts:209

getDopplerFactor

getDopplerFactor(): number
도플러 효과 배율을 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getDopplerFactor
- 정의 위치: src/audio/sound-source.ts:195

getMaxDistance

getMaxDistance(): number
최대 거리를 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getMaxDistance
- 정의 위치: src/audio/sound-source.ts:252

getMaxGain

getMaxGain(): number
최대 게인을 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getMaxGain
- 정의 위치: src/audio/sound-source.ts:280

getMinDistance

getMinDistance(): number
최소 기준 거리를 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getMinDistance
- 정의 위치: src/audio/sound-source.ts:238

getMinGain

getMinGain(): number
최소 게인을 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getMinGain
- 정의 위치: src/audio/sound-source.ts:266

getPan

getPan(): number
스테레오 팬을 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getPan
- 정의 위치: src/audio/sound-source.ts:85

getPitch

getPitch(): number
음높이 배율을 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getPitch
- 정의 위치: src/audio/sound-source.ts:71

getPlayingOffset

getPlayingOffset(): Time
현재 재생 위치를 나타내는 시간의 복사본을 반환합니다.

반환값
Time
소스와 상속
상속받은 타입: SoundSource.getPlayingOffset
- 정의 위치: src/audio/sound-source.ts:366

getPosition

getPosition(): Vector3f
3차원 위치의 복사본을 반환합니다.

반환값
Vector3f
소스와 상속
상속받은 타입: SoundSource.getPosition
- 정의 위치: src/audio/sound-source.ts:127

getStatus

getStatus(): SoundStatus
네이티브 엔진의 현재 재생 상태를 조회합니다.

반환값
SoundStatus
소스와 상속
상속받은 타입: SoundSource.getStatus
- 정의 위치: src/audio/sound-source.ts:315

getVelocity

getVelocity(): Vector3f
속도의 복사본을 반환합니다.

반환값
Vector3f
소스와 상속
상속받은 타입: SoundSource.getVelocity
- 정의 위치: src/audio/sound-source.ts:181

getVolume

getVolume(): number
볼륨 백분율을 반환합니다.

반환값
number
소스와 상속
상속받은 타입: SoundSource.getVolume
- 정의 위치: src/audio/sound-source.ts:99

isLooping

isLooping(): boolean
반복 재생 여부를 반환합니다.

반환값
boolean
소스와 상속
상속받은 타입: SoundSource.isLooping
- 정의 위치: src/audio/sound-source.ts:308

isRelativeToListener

isRelativeToListener(): boolean
리스너 기준 상대 좌표 사용 여부를 반환합니다.

반환값
boolean
소스와 상속
상속받은 타입: SoundSource.isRelativeToListener
- 정의 위치: src/audio/sound-source.ts:224

isSpatializationEnabled

isSpatializationEnabled(): boolean
공간 음향 효과의 활성화 여부를 반환합니다.

반환값
boolean
소스와 상속
상속받은 타입: SoundSource.isSpatializationEnabled
- 정의 위치: src/audio/sound-source.ts:113

pause

pause(): void
재생 위치를 유지한 채 일시 정지합니다.

반환값
void
소스와 상속
상속받은 타입: SoundSource.pause
- 정의 위치: src/audio/sound-source.ts:342

play

play(): void
재생을 시작하거나 재개합니다. 이미 재생 중이면 SFML 동작에 따라 다시 시작합니다.

반환값
void
소스와 상속
상속받은 타입: SoundSource.play
- 정의 위치: src/audio/sound-source.ts:335

setAttenuation

setAttenuation(value: number): void
거리 감쇠 계수를 설정합니다. 0은 거리 감쇠를 비활성화합니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setAttenuation
- 정의 위치: src/audio/sound-source.ts:287

setBuffer

setBuffer(buffer: Readonly): void
오디오 버퍼 참조를 교체하여 유지하고 네이티브 재생 음원을 갱신합니다.

매개변수
buffer
Readonly
반환값
void
소스와 상속
- 정의 위치: src/audio/sound.ts:51

setCone

setCone(value: Readonly<ConeInput>): void
내부 및 외부 원뿔 각도와 외부 게인을 설정하고 네이티브 오디오 엔진을 갱신합니다.

매개변수
value
Readonly<ConeInput>
반환값
void
소스와 상속
상속받은 타입: SoundSource.setCone
- 정의 위치: src/audio/sound-source.ts:150

setDirection

setDirection(value: ReadonlyValue<Vector3f>): void
음원의 소리 방출 방향을 설정합니다.

매개변수
value
ReadonlyValue<Vector3f>
반환값
void
소스와 상속
상속받은 타입: SoundSource.setDirection
- 정의 위치: src/audio/sound-source.ts:134

setDirectionalAttenuationFactor

setDirectionalAttenuationFactor(value: number): void
음원 방향이 감쇠에 미치는 영향 계수를 설정합니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setDirectionalAttenuationFactor
- 정의 위치: src/audio/sound-source.ts:202

setDopplerFactor

setDopplerFactor(value: number): void
도플러 효과 배율을 설정합니다. 0은 비활성화합니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setDopplerFactor
- 정의 위치: src/audio/sound-source.ts:188

setEffectProcessor

setEffectProcessor(processor?: EffectProcessor): void
효과 처리기를 연결하고 참조를 유지합니다. undefined는 처리기를 제거합니다.

매개변수
processor선택 사항
EffectProcessor
반환값
void
소스와 상속
상속받은 타입: SoundSource.setEffectProcessor
- 정의 위치: src/audio/sound-source.ts:322

setLooping

setLooping(value: boolean): void
끝에 도달한 후 반복 재생할지 설정합니다.

매개변수
value
boolean
반환값
void
소스와 상속
상속받은 타입: SoundSource.setLooping
- 정의 위치: src/audio/sound-source.ts:301

setMaxDistance

setMaxDistance(value: number): void
거리 감쇠에 사용할 최대 거리를 설정합니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setMaxDistance
- 정의 위치: src/audio/sound-source.ts:245

setMaxGain

setMaxGain(value: number): void
거리 감쇠 후의 최대 게인을 설정합니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setMaxGain
- 정의 위치: src/audio/sound-source.ts:273

setMinDistance

setMinDistance(value: number): void
최대 볼륨을 유지하는 최소 기준 거리를 설정합니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setMinDistance
- 정의 위치: src/audio/sound-source.ts:231

setMinGain

setMinGain(value: number): void
거리 감쇠 후의 최소 게인을 설정합니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setMinGain
- 정의 위치: src/audio/sound-source.ts:259

setPan

setPan(value: number): void
스테레오 팬을 설정합니다. -1은 왼쪽, 0은 중앙, 1은 오른쪽입니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setPan
- 정의 위치: src/audio/sound-source.ts:78

setPitch

setPitch(value: number): void
음높이와 재생 속도 배율을 설정합니다. 1은 원래 속도입니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setPitch
- 정의 위치: src/audio/sound-source.ts:64

setPlayingOffset

setPlayingOffset(value: ReadonlyValue<Time>): void
소리 시작점 기준 재생 시간을 설정합니다.

매개변수
value
ReadonlyValue<Time>
반환값
void
소스와 상속
상속받은 타입: SoundSource.setPlayingOffset
- 정의 위치: src/audio/sound-source.ts:356

setPosition

setPosition(value: ReadonlyValue<Vector3f>): void
3차원 위치를 설정합니다. 리스너 위치 및 거리 매개변수와 단위가 같아야 합니다.

매개변수
value
ReadonlyValue<Vector3f>
반환값
void
소스와 상속
상속받은 타입: SoundSource.setPosition
- 정의 위치: src/audio/sound-source.ts:120

setRelativeToListener

setRelativeToListener(value: boolean): void
리스너 기준 상대 위치 여부를 설정합니다. false는 월드 좌표를 사용합니다.

매개변수
value
boolean
반환값
void
소스와 상속
상속받은 타입: SoundSource.setRelativeToListener
- 정의 위치: src/audio/sound-source.ts:217

setSpatializationEnabled

setSpatializationEnabled(value: boolean): void
위치, 거리, 방향에 따른 공간 음향 효과의 활성화 여부를 설정합니다.

매개변수
value
boolean
반환값
void
소스와 상속
상속받은 타입: SoundSource.setSpatializationEnabled
- 정의 위치: src/audio/sound-source.ts:106

setVelocity

setVelocity(value: ReadonlyValue<Vector3f>): void
도플러 효과에 사용할 3차원 속도를 설정합니다. 단위는 위치 단위/초입니다.

매개변수
value
ReadonlyValue<Vector3f>
반환값
void
소스와 상속
상속받은 타입: SoundSource.setVelocity
- 정의 위치: src/audio/sound-source.ts:174

setVolume

setVolume(value: number): void
볼륨을 백분율로 설정합니다. 0은 무음, 100은 원래 볼륨입니다.

매개변수
value
number
반환값
void
소스와 상속
상속받은 타입: SoundSource.setVolume
- 정의 위치: src/audio/sound-source.ts:92

stop

stop(): void
정지하고 재생 위치를 0으로 되돌립니다.

반환값
void
소스와 상속
상속받은 타입: SoundSource.stop
- 정의 위치: src/audio/sound-source.ts:349

심볼 멤버

`읽기 전용`[audioHandle]

"[audioHandle]": AudioHandle<"source">

소스와 상속

Sound

계층 (theme_hierarchy_view_summary)

생성자

속성

메소드

생성자

constructor

매개변수

반환값

속성

보호됨 읽기 전용times

보호됨 읽기 전용values

정적 읽기 전용Cone

정적 읽기 전용Status

메소드

assign

매개변수

반환값

보호됨command

매개변수

반환값

보호됨field

매개변수

반환값

보호됨get

매개변수

반환값

getAttenuation

반환값

getBuffer

반환값

getCone

반환값

getDirection

반환값

getDirectionalAttenuationFactor

반환값

getDopplerFactor

반환값

getMaxDistance

반환값

getMaxGain

반환값

getMinDistance

반환값

getMinGain

반환값

getPan

반환값

getPitch

반환값

getPlayingOffset

반환값

getPosition

반환값

getStatus

반환값

getVelocity

반환값

getVolume

반환값

isLooping

반환값

isRelativeToListener

반환값

isSpatializationEnabled

반환값

pause

반환값

play

반환값

setAttenuation

매개변수

반환값

setBuffer

매개변수

반환값

setCone

매개변수

반환값

`보호됨` `읽기 전용`times

`보호됨` `읽기 전용`values

`정적` `읽기 전용`Cone

`정적` `읽기 전용`Status

`보호됨`command

`보호됨`field

`보호됨`get

`읽기 전용`[audioHandle]