Wwise SDK 2018.1.11

Get the min/max peak pairs, in a given region of an audio source, as a collection of binary strings (one per channel). The strings are base-64 encoded 16-bit signed int arrays, with min and max values being interleaved. If getCrossChannelPeaks is true, there will be only one binary string representing peaks across all channels globally.

Supported by

Graphical User Interface, Command-Line Interface.

Arguments

Name	Type	Description
object *		The ID (GUID), name, or path of the audio source object.
timeFrom *	number	The start time, in seconds, of the section of the audio source for which peaks are required. This number must be smaller than timeTo.
timeTo *	number	The end time, in seconds, of the section of the audio source for which peaks are required. This number must be larger than timeFrom.
numPeaks *	integer	The number of peaks that are required (minimum 1).
getCrossChannelPeaks	boolean	When true, peaks will be calculated globally across channels, instead of per channel.

(Required *)

Arguments Details

object

description : The ID (GUID), name, or path of the audio source object.
Possibilities, one of the following :

1) type : string
pattern : ^(StateGroup|SwitchGroup|SoundBank|GameParameter|Event|Effect|AudioDevice|Trigger|Attenuation|DialogueEvent|Bus|AuxBus|Conversion|ModulatorLfo|ModulatorEnvelope|ModulatorTime|Platform|Language|AcousticTexture):[a-zA-Z_]+[a-zA-Z0-9_]*$
description : The name of the object qualified by its type in the form of type:name. Only object types that have globally-unique names are supported.

2) type : string
pattern : ^\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}$

3) type : string
pattern : ^\

timeFrom

type : number
description : The start time, in seconds, of the section of the audio source for which peaks are required. This number must be smaller than timeTo.
minimum : 0

timeTo

type : number
description : The end time, in seconds, of the section of the audio source for which peaks are required. This number must be larger than timeFrom.
minimum : 0

numPeaks

type : integer
description : The number of peaks that are required (minimum 1).
minimum : 1
maximum : 4294967295

getCrossChannelPeaks

type : boolean
description : When true, peaks will be calculated globally across channels, instead of per channel.

Result

Name	Type	Description
peaksBinaryStrings	array	An array of binary strings. Each binary string represents one channel of min max peaks data. When getCrossChannelPeaks is true there will only be one binary string in this array, representing the min max peaks across all channels.
numChannels	number	The number of channels of peak data (i.e. the number of strings in peaksBinaryStrings). This will be 1 if getCrossChannelPeaks is true.
maxAbsValue	number	The maximum value that a peak can take. This can be used to normalize the peaks in the array (between -1, 1), by dividing each by this number.
peaksArrayLength	number	The number of peaks in the returned min max channel arrays. If peaksArrayLength is less than the numPeaks input argument, this indicates fewer samples were available than numPeaks requested. In this case, the arrays contain all of the sample values within the requested time window.
peaksDataSize	number	The size of the data in the peaks min max arrays. This can be used (in conjunction with peaksArrayLength) to decode the peaksBinaryStrings to 16 bit integer arrays

Result Details

peaksBinaryStrings

type : array

resultSchema / peaksBinaryStrings / ...

items

type : string
description : An array of binary strings. Each binary string represents one channel of min max peaks data. When getCrossChannelPeaks is true there will only be one binary string in this array, representing the min max peaks across all channels.

numChannels

type : number
description : The number of channels of peak data (i.e. the number of strings in peaksBinaryStrings). This will be 1 if getCrossChannelPeaks is true.

maxAbsValue

type : number
description : The maximum value that a peak can take. This can be used to normalize the peaks in the array (between -1, 1), by dividing each by this number.

peaksArrayLength

type : number
description : The number of peaks in the returned min max channel arrays. If peaksArrayLength is less than the numPeaks input argument, this indicates fewer samples were available than numPeaks requested. In this case, the arrays contain all of the sample values within the requested time window.

peaksDataSize

type : number
description : The size of the data in the peaks min max arrays. This can be used (in conjunction with peaksArrayLength) to decode the peaksBinaryStrings to 16 bit integer arrays

Examples :

Get peaks per channel

Get peaks for an audio source object.

Arguments:

{
    "object": "{AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE}", 
    "timeFrom": 0.0, 
    "timeTo": 2.0, 
    "numPeaks": 750, 
    "getCrossChannelPeaks": false
}

Result:

{
    "peaksBinaryStrings": [
        "longbase64string", 
        "longbase64string"
    ], 
    "numChannels": 2, 
    "maxAbsValue": 32767, 
    "peaksArrayLength": 750, 
    "peaksDataSize": 1000
}

Get peaks across channels

Get peaks for an audio source object.

Arguments:

{
    "object": "{AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE}", 
    "timeFrom": 0.0, 
    "timeTo": 2.0, 
    "numPeaks": 750, 
    "getCrossChannelPeaks": true
}

Result:

{
    "peaksBinaryStrings": [
        "longbase64string"
    ], 
    "numChannels": 2, 
    "maxAbsValue": 32767, 
    "peaksArrayLength": 750, 
    "peaksDataSize": 1000
}

Detailed JSON Schema

Arguments :

{
    "type": "object", 
    "properties": {
        "object": {
            "description": "The ID (GUID), name, or path of the audio source object.", 
            "anyOf": [
                {
                    "type": "string", 
                    "pattern": "^(StateGroup|SwitchGroup|SoundBank|GameParameter|Event|Effect|AudioDevice|Trigger|Attenuation|DialogueEvent|Bus|AuxBus|Conversion|ModulatorLfo|ModulatorEnvelope|ModulatorTime|Platform|Language|AcousticTexture):[a-zA-Z_]+[a-zA-Z0-9_]*$", 
                    "description": "The name of the object qualified by its type in the form of type:name. Only object types that have globally-unique names are supported."
                }, 
                {
                    "type": "string", 
                    "pattern": *Must be a valid GUID*
                }, 
                {
                    "type": "string", 
                    "pattern": "^\\\\"
                }
            ]
        }, 
        "timeFrom": {
            "type": "number", 
            "description": "The start time, in seconds, of the section of the audio source for which peaks are required. This number must be smaller than timeTo.", 
            "minimum": 0
        }, 
        "timeTo": {
            "type": "number", 
            "description": "The end time, in seconds, of the section of the audio source for which peaks are required. This number must be larger than timeFrom.", 
            "minimum": 0
        }, 
        "numPeaks": {
            "type": "integer", 
            "description": "The number of peaks that are required (minimum 1).", 
            "minimum": 1, 
            "maximum": 4294967295
        }, 
        "getCrossChannelPeaks": {
            "type": "boolean", 
            "description": "When true, peaks will be calculated globally across channels, instead of per channel."
        }
    }, 
    "additionalProperties": false, 
    "required": [
        "object", 
        "timeFrom", 
        "timeTo", 
        "numPeaks"
    ]
}

Options :

{
    "type": "object", 
    "properties": {}, 
    "additionalProperties": false
}

Response :

{
    "type": "object", 
    "properties": {
        "peaksBinaryStrings": {
            "type": "array", 
            "items": {
                "type": "string"
            }, 
            "description": "An array of binary strings. Each binary string represents one channel of min max peaks data. When getCrossChannelPeaks is true there will only be one binary string in this array, representing the min max peaks across all channels."
        }, 
        "numChannels": {
            "type": "number", 
            "description": "The number of channels of peak data (i.e. the number of strings in peaksBinaryStrings). This will be 1 if getCrossChannelPeaks is true."
        }, 
        "maxAbsValue": {
            "type": "number", 
            "description": "The maximum value that a peak can take. This can be used to normalize the peaks in the array (between -1, 1), by dividing each by this number."
        }, 
        "peaksArrayLength": {
            "type": "number", 
            "description": "The number of peaks in the returned min max channel arrays. If peaksArrayLength is less than the numPeaks input argument, this indicates fewer samples were available than numPeaks requested. In this case, the arrays contain all of the sample values within the requested time window."
        }, 
        "peaksDataSize": {
            "type": "number", 
            "description": "The size of the data in the peaks min max arrays. This can be used (in conjunction with peaksArrayLength) to decode the peaksBinaryStrings to 16 bit integer arrays"
        }
    }, 
    "additionalProperties": false
}

Document version : 1

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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요