ResourceImporterWAV
Hereda: ResourceImporter < RefCounted < Object
Importa un archivo de audio WAV para su reproducción.
Descripción
WAV es un formato sin comprimir, que puede proporcionar mayor calidad en comparación con Ogg Vorbis y MP3. También tiene el costo de CPU más bajo para decodificar. Esto significa que se pueden reproducir grandes cantidades de sonidos WAV al mismo tiempo, incluso en dispositivos de gama baja.
De forma predeterminada, Godot importa archivos WAV utilizando la compresión con pérdida Quite OK Audio. Puedes cambiar esto configurando la propiedad compress/mode.
Tutoriales
Propiedades
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Descripciones de Propiedades
El modo de compresión a utilizar al importar.
PCM (Sin comprimir): Importa datos de audio sin ninguna forma de compresión, preservando la mayor calidad posible. Tiene el menor costo de CPU, pero el mayor uso de memoria.
IMA ADPCM: Aplica una compresión rápida con pérdida durante la importación, disminuyendo notablemente la calidad, pero con un bajo costo de CPU y uso de memoria. No soporta la búsqueda y solo se soporta el modo de bucle Forward.
`Quite OK Audio <https://qoaformat.org/>`__: También aplica compresión con pérdida al importar, teniendo un costo de CPU ligeramente superior al de IMA ADPCM, pero una calidad mucho mayor y el menor uso de memoria.
El punto de inicio del bucle a usar cuando edit/loop_mode es Forward, Ping-Pong o Backward. Esto se establece en muestras después del comienzo del archivo de audio.
El punto final del bucle a usar cuando edit/loop_mode es Forward, Ping-Pong o Backward. Esto se establece en muestras después del comienzo del archivo de audio. Un valor de -1 usa el final del archivo de audio como el punto final del bucle.
Controla cómo se debe repetir el audio.
Detectar desde WAV: Utiliza la información de bucle de los metadatos WAV.
Deshabilitado: No repetir el audio, incluso si los metadatos indican que la reproducción del archivo debe repetirse.
Adelante: Bucle de audio estándar. Reproduce el audio hacia adelante desde el principio hasta edit/loop_end, luego regresa a edit/loop_begin y se repite.
Ping-Pong: Reproduce el audio hacia adelante hasta edit/loop_end, luego hacia atrás hasta edit/loop_begin, repitiendo este ciclo.
Atrás: Reproduce el audio hacia atrás desde edit/loop_end hasta edit/loop_begin, luego se repite.
Nota: En AudioStreamPlayer, la señal AudioStreamPlayer.finished no se emitirá para el audio en bucle cuando llegue al final del archivo de audio, ya que el audio seguirá reproduciéndose indefinidamente.
Si es true, normaliza el volumen del audio para que su volumen máximo sea igual a 0 dB. Cuando está habilitado, la normalización hará que el audio suene más fuerte dependiendo de su volumen máximo original.
Si es true, recorta automáticamente el principio y el final del audio si es inferior a -50 dB después de la normalización (véase edit/normalize). Esto evita tener archivos con silencio al principio o al final, lo que aumenta su tamaño innecesariamente y agrega latencia al momento en que se reproducen. También se utiliza un período de fundido de entrada/salida de 500 muestras durante el recorte para evitar chasquidos audibles.
Si es true, fuerza al audio importado a usar una cuantificación de 8 bits si el archivo de origen es de 16 bits o superior.
Generalmente no se recomienda habilitar esto, ya que la cuantificación de 8 bits disminuye significativamente la calidad del audio. Si necesitas tamaños de archivo más pequeños, considera usar audio Ogg Vorbis o MP3 en su lugar.
Si se establece en un valor mayor que 0, fuerza a que la frecuencia de muestreo del audio se reduzca a un valor inferior o igual al valor especificado en force/max_rate_hz.
Esto puede disminuir notablemente el tamaño del archivo en ciertos sonidos, sin afectar la calidad dependiendo del contenido real del sonido. Consulta Buenas prácticas para obtener más información.
float force/max_rate_hz = 44100 🔗
La frecuencia a la que se limitará la muestra de audio importada (en Hz). Solo es efectivo si force/max_rate es true.
Si es true, fuerza a que el audio importado sea mono si el archivo de origen es estéreo. Esto disminuye el tamaño del archivo en un 50% al fusionar los dos canales en uno.