@minecraft
    Preparing search index...

    Class SoundInstance

    Represents a handle to a sound that has been played. The handle is required to control the sound while it is playing (for example, to call stop, setVolume, setPitch, fade, or seekTo). Infinitely-looping sounds (started with loop: -1) stop automatically when the last SoundInstance reference is dropped; retain the handle for as long as the sound should keep playing.

    Index

    Properties

    durationInfo? id recipient? soundEventId

    Methods

    fade pause resume seekTo setPitch setVolume stop

    Properties

    durationInfo?: SoundDurationInfo

    Gets duration and playback information for this sound.

    id: string

    Unique identifier of this sound instance.

    recipient?: Player

    Gets the player this sound was played for.

    soundEventId: string

    Gets the identifier of the sound event this instance was started with.

    Methods

    • Beta World mutation

      Parameters

      • duration: number

        Duration of the fade in seconds. Must be non-negative. Minimum value: 0

      • targetVolume: number

        Volume to fade to. Must be non-negative. Minimum value: 0

      Returns void

      Fades this sound instance from its current volume to the target volume over the specified duration. To fade in from silence, call setVolume(0.0) first; to fade out, pass a target volume of 0.0.

    • Beta World mutation

      Parameters

      • seconds: number

        Position to seek to in seconds. Must be non-negative. Bounds: [0, 107374184]

      Returns void

      Sets the playback position of this sound instance.

      Throws if seconds is negative, or if the sound has a known duration and seconds is greater than that duration.

      ArgumentOutOfBoundsError

    • Beta World mutation

      Parameters

      • pitch: number

        Pitch multiplier between 0.01 and 10.0. A value of 1.0 is normal pitch. Bounds: [0.009999999776482582, 10]

      Returns void

      Sets the pitch of this sound instance.

    • Beta World mutation

      Parameters

      • volume: number

        Volume level between 0.0 and 10.0. Bounds: [0, 10]

      Returns void

      Sets the volume of this sound instance.

    Settings

    Member Visibility

    On This Page

    Properties
    Methods