getAudioSpectraData

Compute and return the Audio Spectra Data from a MediaFile.

Note

If the queried endTime is greater than the length of the file, the endTime will be updated to the length of the file and returned in the parameters as in the example below.

Note

Since the returned frame data is a dictionary, sort order is not retained as in the example below.

getAudioSpectraData/{mediaFileId}/
GET
  • Parameters
    • startTime
      seconds, relative to the beginning of the file.
    • endTime
      seconds, relative to the beginning of the file. If this is greater than the length of the file, then data will be returned up until the end of the file.
    • numTimeFramesPerSecond
    • numFrequencyBands
    • dampingFactor
    • minFrequency
      (in Hz)
    • maxFrequency
      (in Hz)
  • Response
    • The JSON ‘spectraData’ object returned from the APAPT callMe() API.

Example

GET /api/v0/getAudioSpectraData/179070/?startTime=227&endTime=300&numTimeFramesPerSecond=2&numFrequencyBands=4&dampingFactor=0.02&minFrequency=20&maxFrequency=2000

HTTP 200 OK
Content-Type: application/json
Vary: Accept
Allow: OPTIONS, GET

{
    "spectraData": {
        "frames": {
            "227.0": [
                2582,
                42785,
                9456,
                9167
            ],
            "228.0": [
                131,
                282,
                622,
                891
            ],
            "227.5": [
                973,
                3303,
                1985,
                2048
            ]
        },
        "freqBands": [
            20.0,
            92.83177667225559,
            430.8869380063768,
            2000.0000000000005
        ],
        "params": {
            "minFrequency": 20.0,
            "numTimeFramesPerSecond": 2,
            "numFrequencyBands": 4,
            "maxFrequency": 2000.0,
            "dampingRatio": 0.02,
            "startTime": 227.0,
            "endTime": 228.46694,
            "mediaFileId": 179070
        }
    }
}