mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
183 lines
10 KiB
ReStructuredText
183 lines
10 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. _class_ResourceImporterOggVorbis:
|
|
|
|
ResourceImporterOggVorbis
|
|
=========================
|
|
|
|
**Hereda:** :ref:`ResourceImporter<class_ResourceImporter>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
|
|
|
Importa un archivo de audio Ogg Vorbis para reproducción.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Descripción
|
|
----------------------
|
|
|
|
Ogg Vorbis es un formato de audio con pérdida, con mejor calidad de audio en comparación con :ref:`ResourceImporterMP3<class_ResourceImporterMP3>` a una tasa de bits dada.
|
|
|
|
En la mayoría de los casos, se recomienda usar Ogg Vorbis sobre MP3. Sin embargo, si estás utilizando una fuente de sonido MP3 sin una fuente de mayor calidad disponible, entonces se recomienda usar el archivo MP3 directamente para evitar la doble compresión con pérdida.
|
|
|
|
Ogg Vorbis requiere más CPU para decodificar que :ref:`ResourceImporterWAV<class_ResourceImporterWAV>`. Si necesitas reproducir muchos sonidos simultáneos, se recomienda usar WAV para esos sonidos en su lugar, especialmente si se apunta a dispositivos de gama baja.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Tutoriales
|
|
--------------------
|
|
|
|
- :doc:`Importar muestras de audio <../tutorials/assets_pipeline/importing_audio_samples>`
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Propiedades
|
|
----------------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+---------------------------+--------------------------------------------------------------------------+-----------+
|
|
| :ref:`int<class_int>` | :ref:`bar_beats<class_ResourceImporterOggVorbis_property_bar_beats>` | ``4`` |
|
|
+---------------------------+--------------------------------------------------------------------------+-----------+
|
|
| :ref:`int<class_int>` | :ref:`beat_count<class_ResourceImporterOggVorbis_property_beat_count>` | ``0`` |
|
|
+---------------------------+--------------------------------------------------------------------------+-----------+
|
|
| :ref:`float<class_float>` | :ref:`bpm<class_ResourceImporterOggVorbis_property_bpm>` | ``0`` |
|
|
+---------------------------+--------------------------------------------------------------------------+-----------+
|
|
| :ref:`bool<class_bool>` | :ref:`loop<class_ResourceImporterOggVorbis_property_loop>` | ``false`` |
|
|
+---------------------------+--------------------------------------------------------------------------+-----------+
|
|
| :ref:`float<class_float>` | :ref:`loop_offset<class_ResourceImporterOggVorbis_property_loop_offset>` | ``0`` |
|
|
+---------------------------+--------------------------------------------------------------------------+-----------+
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Métodos
|
|
--------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+---------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`AudioStreamOggVorbis<class_AudioStreamOggVorbis>` | :ref:`load_from_buffer<class_ResourceImporterOggVorbis_method_load_from_buffer>`\ (\ stream_data\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) |static| |
|
|
+---------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`AudioStreamOggVorbis<class_AudioStreamOggVorbis>` | :ref:`load_from_file<class_ResourceImporterOggVorbis_method_load_from_file>`\ (\ path\: :ref:`String<class_String>`\ ) |static| |
|
|
+---------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de Propiedades
|
|
--------------------------------------------------------
|
|
|
|
.. _class_ResourceImporterOggVorbis_property_bar_beats:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`int<class_int>` **bar_beats** = ``4`` :ref:`🔗<class_ResourceImporterOggVorbis_property_bar_beats>`
|
|
|
|
El número de compases dentro de un solo tiempo en la pista de audio. Esto solo es relevante para la música que desee hacer uso de la música interactiva funcionalidad, no efectos de sonido.
|
|
|
|
Un editor más conveniente para :ref:`bar_beats<class_ResourceImporterOggVorbis_property_bar_beats>` se proporciona en el diálogo **Configuración avanzada de importación**, ya que te permite previsualizar tus cambios sin tener que volver a importar el audio.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ResourceImporterOggVorbis_property_beat_count:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`int<class_int>` **beat_count** = ``0`` :ref:`🔗<class_ResourceImporterOggVorbis_property_beat_count>`
|
|
|
|
El conteo de tiempos de la pista de audio. Esto solo es relevante para la música que desee hacer uso de la funcionalidad de música interactiva, no efectos de sonido.
|
|
|
|
Un editor más conveniente para :ref:`beat_count<class_ResourceImporterOggVorbis_property_beat_count>` se proporciona en el diálogo **Configuración avanzada de importación**, ya que te permite previsualizar tus cambios sin tener que volver a importar el audio.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ResourceImporterOggVorbis_property_bpm:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`float<class_float>` **bpm** = ``0`` :ref:`🔗<class_ResourceImporterOggVorbis_property_bpm>`
|
|
|
|
Los tiempos por minuto de la pista de audio. Esto debería coincidir con la medida de BPM que se utilizó para componer la pista. Esto solo es relevante para la música que desee hacer uso de la funcionalidad de música interactiva, no efectos de sonido.
|
|
|
|
Un editor más conveniente para :ref:`bpm<class_ResourceImporterOggVorbis_property_bpm>` se proporciona en el **Avanzado Configuración de importación** diálogo, ya que te permite previsualizar tus cambios sin tener que volver a importar el audio.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ResourceImporterOggVorbis_property_loop:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **loop** = ``false`` :ref:`🔗<class_ResourceImporterOggVorbis_property_loop>`
|
|
|
|
Si está habilitado, el audio comenzará a reproducirse al principio después de que la reproducción termine al llegar al final del audio.
|
|
|
|
\ **Nota:** En :ref:`AudioStreamPlayer<class_AudioStreamPlayer>`, la señal :ref:`AudioStreamPlayer.finished<class_AudioStreamPlayer_signal_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.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ResourceImporterOggVorbis_property_loop_offset:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`float<class_float>` **loop_offset** = ``0`` :ref:`🔗<class_ResourceImporterOggVorbis_property_loop_offset>`
|
|
|
|
Determina dónde comenzará a repetirse el audio después de que la reproducción llegue al final del audio. Esto se puede usar para solo repetir una parte del archivo de audio, lo cual es útil para algunos sonidos o música ambientales. El valor se determina en segundos en relación con el principio del audio. Un valor de ``0.0`` repetirá todo el archivo de audio.
|
|
|
|
Solo tiene efecto si :ref:`loop<class_ResourceImporterOggVorbis_property_loop>` es ``true``.
|
|
|
|
Un editor más conveniente para :ref:`loop_offset<class_ResourceImporterOggVorbis_property_loop_offset>` se proporciona en el diálogo **Configuración avanzada de importación**, ya que te permite previsualizar tus cambios sin tener que volver a importar el audio.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de Métodos
|
|
------------------------------------------------
|
|
|
|
.. _class_ResourceImporterOggVorbis_method_load_from_buffer:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`AudioStreamOggVorbis<class_AudioStreamOggVorbis>` **load_from_buffer**\ (\ stream_data\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) |static| :ref:`🔗<class_ResourceImporterOggVorbis_method_load_from_buffer>`
|
|
|
|
**Obsoleto:** Use :ref:`AudioStreamOggVorbis.load_from_buffer()<class_AudioStreamOggVorbis_method_load_from_buffer>` instead.
|
|
|
|
Crea una nueva instancia de :ref:`AudioStreamOggVorbis<class_AudioStreamOggVorbis>` a partir del búfer especificado. El búfer debe contener datos Ogg Vorbis.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ResourceImporterOggVorbis_method_load_from_file:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`AudioStreamOggVorbis<class_AudioStreamOggVorbis>` **load_from_file**\ (\ path\: :ref:`String<class_String>`\ ) |static| :ref:`🔗<class_ResourceImporterOggVorbis_method_load_from_file>`
|
|
|
|
**Obsoleto:** Use :ref:`AudioStreamOggVorbis.load_from_file()<class_AudioStreamOggVorbis_method_load_from_file>` instead.
|
|
|
|
Crea una nueva instancia de :ref:`AudioStreamOggVorbis<class_AudioStreamOggVorbis>` a partir de la ruta de archivo indicada. El archivo debe estar en formato Ogg Vorbis.
|
|
|
|
.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)`
|
|
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
|
.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)`
|
|
.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)`
|
|
.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)`
|
|
.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)`
|
|
.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)`
|
|
.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)`
|
|
.. |void| replace:: :abbr:`void (Sin valor de retorno.)`
|