@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
    durationInfo? id recipient? soundEventId
    fade pause resume seekTo setPitch setVolume stop
    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.

    • Preview World mutation

      Parameters

      • duration: number

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

      • targetVolume: number

        Volume multiplier to fade to, relative to the selected sound variant's volume. Must be non-negative. Minimum value: 0

      Returns void

      Fades this sound instance from its current volume multiplier to the target multiplier over the specified duration. Volume multipliers are relative to the selected sound variant's volume. To fade in from silence, call setVolume(0.0) first; to fade out, pass a target volume of 0.0.

    • Preview 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

    • Preview 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.

    • Preview World mutation

      Parameters

      • volume: number

        Volume multiplier between 0.0 and 10.0. A value of 1.0 uses the selected sound variant's volume. Bounds: [0, 10]

      Returns void

      Sets the volume multiplier of this sound instance relative to the volume of the selected sound variant.

    Settings
    Member Visibility

    On This Page
    Properties
    Methods