Class Library

java.lang.Object
com.mojang.blaze3d.audio.Library
public class Library extends Object

  • Field Details

    • LOGGER

      private static final org.slf4j.Logger LOGGER

    • NO_DEVICE

      private static final int NO_DEVICE
      See Also:

    • DEFAULT_CHANNEL_COUNT

      private static final int DEFAULT_CHANNEL_COUNT
      See Also:

    • currentDevice

      private long currentDevice

    • context

      private long context

    • supportsDisconnections

      private boolean supportsDisconnections

    • defaultDeviceName

      private @Nullable String defaultDeviceName

    • EMPTY

      private static final Library.ChannelPool EMPTY

    • staticChannels

      private Library.ChannelPool staticChannels

    • streamingChannels

      private Library.ChannelPool streamingChannels

    • listener

      private final Listener listener

  • Constructor Details

    • Library

      public Library()

  • Method Details

    • init

      public void init(@Nullable String preferredDevice, boolean useHrtf)
      Initializes the OpenAL device and context.
      Parameters:
      preferredDevice - A string specifying the name of the audio device to use, or null to use the default device.
      useHrtf - Whether to enable HRTF (head-related transfer function) for spatial audio.
      Throws:
      IllegalStateException - if an error occurs during initialization.

    • createAttributes

      private IntBuffer createAttributes(org.lwjgl.system.MemoryStack stack, boolean enableHrtf)

    • getChannelCount

      private int getChannelCount()

    • getDefaultDeviceName

      public static @Nullable String getDefaultDeviceName()

    • getCurrentDeviceName

      public String getCurrentDeviceName()

    • hasDefaultDeviceChanged

      public boolean hasDefaultDeviceChanged()

    • openDeviceOrFallback

      private static long openDeviceOrFallback(@Nullable String preferredDevice)
      Opens the specified audio device, or the default device if the specifier is null.
      Parameters:
      preferredDevice - The name of the audio device to open, or null to open the default device.
      Returns:
      The handle of the opened device.
      Throws:
      IllegalStateException - if the device cannot be opened.

    • tryOpenDevice

      private static OptionalLong tryOpenDevice(@Nullable String name)
      Attempts to open the specified audio device.
      Parameters:
      name - A string specifying the name of the audio device to open, or null to use the default device.
      Returns:
      an OptionalLong containing the handle of the opened device if successful, or empty if the device could not be opened

    • cleanup

      public void cleanup()

    • getListener

      public Listener getListener()

    • acquireChannel

      public @Nullable Channel acquireChannel(Library.Pool pool)
      Acquires a sound channel based on the given mode.

    • releaseChannel

      public void releaseChannel(Channel channel)
      Releases a channel.
      Parameters:
      channel - The channel to release.

    • getDebugString

      public String getDebugString()

    • getAvailableSoundDevices

      public List<String> getAvailableSoundDevices()

    • isCurrentDeviceDisconnected

      public boolean isCurrentDeviceDisconnected()