# getSoundWaveData (Cliente)

> Devuelve la forma de onda de lo que el sonido acaba de reproducir, para dibujar osciloscopios.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Sonido
- **URL**: https://wiki.mymp.gg/es/getSoundWaveData

## Sintaxis

```lua
table|false getSoundWaveData(sound sound, int samples)
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `sound` | `sound` | El elemento `sound`, o un elemento `dui` para el sonido del navegador. |
| `samples` | `int` | Cuántos valores devolver: una potencia de 2 entre 128 y 16384. |

## Retorno

Una tabla con `samples` valores de -1 a 1, alternando canal izquierdo y derecho, o `false` si `samples` no es válido o el sonido está en pausa, terminado o fuera de alcance.

## Ejemplo

```lua
addEventHandler("onClientRender", root, function()
    local wave = getSoundWaveData(music, 512)
    if not wave then return end
    for i = 0, 510, 2 do
        dxDrawLine(i, 300 + wave[i] * 100, i + 2, 300 + wave[i + 2] * 100, tocolor(255, 255, 255))
    end
end)
```

### Atención

La tabla empieza en el índice 0.

## Ver también

- [getSoundFFTData (Cliente)](https://wiki.mymp.gg/es/getSoundFFTData.md): Devuelve el espectro de frecuencias de lo que el sonido está reproduciendo ahora, para hacer visualizadores.
- [getSoundLevelData (Cliente)](https://wiki.mymp.gg/es/getSoundLevelData.md): Devuelve el pico de volumen de cada canal en los últimos 20 ms del sonido.