버전

menu_open
Wwise SDK 2024.1.0
ak.wwise.core.audioSourcePeaks.getMinMaxPeaksInRegion

오디오 음원의 정해진 영역 내 min/max 피크를 바이너리 문자열 형태로 구합니다 (채널당 하나). 문자열은 Base64 인코딩, 16 비트 signed int 배열로 돼있으며, 인터리브된 min/max 값이 있습니다. getCrossChannelPeaks가 true일 경우, 하나의 바이너리 문자열만 모든 채널의 피크를 전역적으로 나타냅니다.

Arguments

이름 타입 설명
object * any of: 오디오 음원 오브젝트의 ID (GUID), 이름, 또는 경로.
string The name of the object qualified by its type or Short ID in the form of type:name or Global:shortId. Only object types that have globally-unique names or Short Ids are supported. Ex: Event:Play_Sound_01, Global:245489792
string 해당 형식의 오브젝트 GUID: {aabbcc00-1122-3344-5566-77889900aabb}.
string Wwise 오브젝트의 프로젝트 경로로서, 카테고리 및 Work-Unit 포함. 예: \Actor-Mixer Hierarchy\Default Work Unit\New Sound SFX.
timeFrom * number 피크가 필요한 오디오 음원 섹션의 시작 시간 (단위: 초). timeTo보다 작은 숫자여야 합니다. 범위: [0,*]
timeTo * number 피크가 필요한 오디오 음원 섹션의 끝 시간 (단위: 초). timeFrom보다 큰 숫자여야 합니다. 범위: [0,*]
numPeaks * integer 필요한 피크 개수 (최소 1개). 범위: [1,4294967295]
getCrossChannelPeaks boolean true일 경우, 피크는 채널당이 아니라 모든 채널에 걸쳐 전역적으로 계산됩니다.

(필수 *)

인자 스키마

Result

이름 타입 설명
peaksBinaryStrings array 바이너리 문자열의 배열.
peaksBinaryStrings [...] string 바이너리 문자열로서, min/max 피크 데이터의 한 채널을 나타냅니다. getCrossChannelPeaks가 true일 경우, 이 배열에 하나의 바이너리 문자열만 존재하며, 모든 채널에 걸친 min/max 피크를 나타냅니다.
numChannels number 피크 데이터의 채널 개수 (즉, peaksBinaryStrings의 문자열 개수). getCrossChannelPeaks가 true인 경우 1이 됩니다.
maxAbsValue number 한 피크가 가질 수 있는 최대값. 배열 내 피크를 이 숫자로 나누어 노멀라이즈하는 데 사용됩니다 (-1에서 1 사이).
peaksArrayLength number 반환된 min/max 채널 배열 내 피크의 개수. peaksArrayLength가 numPeaks 입력 인자보다 작을 경우, 사용할 수 있는 샘플 개수가 numPeaks가 요청한 것보다 적다는 뜻입니다. 이 경우, 요청한 시간 범위 내의 모든 샘플 값이 배열에 포함됩니다.
peaksDataSize number 피크 min/max 배열 내 데이터의 크기. peaksBinaryStrings를 16 비트 정수 배열로 디코딩할 때 사용할 수 있습니다 (peaksArrayLength와 함께 사용).
channelConfig string The channel configuration.

결과 스키마

더 보기

예제

Wwise Authoring API에 대한 더 자세한 정보는 Wwise Authoring API (WAAPI, Wwise 저작 API) 사용하기 를 참고하세요.


이 페이지가 도움이 되었나요?

지원이 필요하신가요?

질문이 있으신가요? 문제를 겪고 계신가요? 더 많은 정보가 필요하신가요? 저희에게 문의해주시면 도와드리겠습니다!

지원 페이지를 방문해 주세요

작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.

프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.

Wwise를 시작해 보세요