Skip to content
Roblox API Reference

Sound

An object that emits sound. This object can be placed within a BasePart or Attachment to emit a sound from a particular position within a place or world, or it can be attached elsewhere to play the sound at a constant volume throughout the entire place.
Memory category
Internal
Own members
57
Inherited members
75
Subclasses
0
Siblings
608

Properties58

Inherited fromObject2

Property categoryData

Inherited fromInstance21

Property categoryBehavior

Property categoryData

Property categoryPermissions

Defined bySound35

Property categoryAsset

  • Sound.AudioContent: Content
    A reference to an audio asset.
    • Read capabilities: LegacySound
  • Sound.ChannelCount: number = 0
    • Hidden
    • Read only
    • Roblox script security
    • Read capabilities: LegacySound
  • Sound.IsLoaded: boolean = false
    This property is true when the Sound has loaded from Roblox servers and is ready to play.
    • Read only
    • Read capabilities: LegacySound
  • Sound.SoundId: string = ""
    Content ID of the sound file to associate with the Sound.
    • Read capabilities: LegacySound
  • Sound.TimeLength: number = 0
    The length of the Sound in seconds.
    • Read only
    • Read capabilities: LegacySound

Property categoryBehavior

Property categoryData

  • Sound.PlayingReplicator: boolean = false
    • Hidden
    • Not scriptable
    • Read capabilities: LegacySound
  • Sound.TimePositionReplicator: number = 0
    • Hidden
    • Not scriptable
    • Read capabilities: LegacySound
  • Sound.EmitterSize: number = 10
    Deprecated: This property has deprecated in favor of Sound.RollOffMinDistance and Sound.RollOffMaxDistance which should be used instead in new work.
    The minimum distance, in studs, at which a 3D Sound (direct child of a BasePart or Attachment) will begin to attenuate (decrease in volume).
    • Deprecated
    • Read capabilities: LegacySound
    • Load only

    Use RollOffMinDistance instead.

  • Sound.MaxDistance: number = 10000
    Deprecated: This property has deprecated in favor of Sound.RollOffMinDistance and Sound.RollOffMaxDistance which should be used instead in new work.
    The maximum distance, in studs, a client's listener can be from the Sound\s origin and still hear it. Only applies to Sounds parented to a Part or Attachment (3D sounds).
    • Deprecated
    • Read capabilities: LegacySound

    Use RollOffMaxDistance instead.

  • Sound.MinDistance: number = 10
    Deprecated: MinDistance has been superseded by Sound.EmitterSize, whose name better describes this properties behavior.
    The minimum distance at which a 3D Sound (direct child of a BasePart or Attachment) will begin to attenuate. Effectively, the emitter size.
    • Deprecated
    • Read capabilities: LegacySound
    • Load only

    Use RollOffMinDistance instead.

  • Sound.Pitch: number = 1
    Deprecated: This property has been deprecated in favor of Sound.PlaybackSpeed whose name suits the behavior better.
    Sets how high pitched and fast a Sound is when it is played. The greater the integer, the higher and faster the Sound is.
    • Deprecated
    • Read capabilities: LegacySound
    • Load only

    Use PlaybackSpeed instead.

  • Sound.isPlaying: boolean = false
    Deprecated: This deprecated property is a variant of Sound.IsPlaying which should be used instead.
    • Deprecated
    • Read only
    • Read capabilities: LegacySound

    Use IsPlaying instead.

  • Sound.xmlRead_MaxDistance_3: number = 10000
    • Deprecated
    • Hidden
    • Not replicated
    • Not scriptable
    • Read capabilities: LegacySound
    • Load only

    Use RollOffMaxDistance instead.

  • Sound.xmlRead_MinDistance_3: number = 10
    • Deprecated
    • Hidden
    • Not replicated
    • Not scriptable
    • Read capabilities: LegacySound
    • Load only

    Use RollOffMinDistance instead.

Property categoryEmitter

  • Sound.AcousticSimulationEnabled: boolean = true
    • Capabilities: LegacySound
  • Sound.RollOffMaxDistance: number = 10000
    The maximum distance, in studs, a client's listener can be from the sound's origin and still hear it. Only applies to Sounds parented to a BasePart or Attachment.
    • Read capabilities: LegacySound
  • Sound.RollOffMinDistance: number = 10
    The minimum distance, in studs, at which a Sound which is parented to a BasePart or Attachment will begin to attenuate (decrease in volume).
    • Read capabilities: LegacySound
  • Controls how the volume of a Sound which is parented to a BasePart or Attachment attenuates (fades out) as the distance between the listener and parent changes.
    • Read capabilities: LegacySound

Property categoryPlayback

  • Sound.IsPaused: boolean = true
    Read-only property which returns true when the Sound is not playing.
    • Hidden
    • Read only
    • Read capabilities: LegacySound
  • Sound.IsPlaying: boolean = false
    Read-only property which returns true when the Sound is playing.
    • Hidden
    • Read only
    • Read capabilities: LegacySound
  • Sound.Looped: boolean = false
    Sets whether or not the Sound repeats once it has finished playing.
    • Read capabilities: LegacySound
  • Sound.PlaybackLoudness: number = 0
    A number between 0 and 1000 indicating how loud the Sound is currently playing back.
    • Read only
    • Read capabilities: LegacySound
  • Sound.PlaybackRegionsEnabled: boolean = false
    If true, this property gives your Sound access to the PlaybackRegion and LoopRegion properties which can more-accurately control its playback.
    • Read capabilities: LegacySound
  • Sound.PlaybackSpeed: number = 1
    Determines the speed at which a Sound will play, with higher values causing the sound to play faster and at a higher pitch.
    • Not replicated
    • Read capabilities: LegacySound
  • Sound.Playing: boolean = false
    Indicates whether the Sound is currently playing.
    • Not replicated
    • Read capabilities: LegacySound
  • Sound.RollOffGain: number = 1
    • Hidden
    • Read only
    • Roblox script security
    • Read capabilities: LegacySound
  • Sound.TimePosition: number = 0
    Progress of the Sound in seconds. Can be changed to move the playback position of the Sound both before and during playback.
    • Not replicated
    • Read capabilities: LegacySound
  • Sound.Volume: number = 0.5
    The volume of the Sound.
    • Read capabilities: LegacySound

Property categoryRegions

  • Sound.LoopRegion: NumberRange = NumberRange.new(0, 60000)
    A range denoting a desired loop start and loop end within the PlaybackRegion, in seconds.
    • Read capabilities: LegacySound
  • Sound.PlaybackRegion: NumberRange = NumberRange.new(0, 60000)
    A range denoting a desired start and stop time within the TimeLength, in seconds.
    • Read capabilities: LegacySound

Property categoryRouting

Methods52

Inherited fromObject3
  • Get an event that fires when a given property of the object changes.
    Parameters
    ParameterDescription
    property: string
    The property to connect to.
    Returns
    TypeDescription
    RBXScriptSignal
    A signal that fires whenever the property changes.
  • Object:IsA(className: string): boolean
    Returns true if an object's class matches or inherits from a given class.
    • Custom Lua state
    • Thread safe
    Parameters
    ParameterDescription
    className: string
    The class against which the Object's class will be checked. Case-sensitive.
    Returns
    TypeDescription
    boolean
    Describes whether the Object's class matched or is a subclass of the given class.
  • Object:isA(className: string): boolean
    Deprecated: This deprecated function is a variant of Object:IsA() which should be used instead.
    • Deprecated
    • Custom Lua state
    Parameters
    Parameter
    className: string
    Returns
    Type
    boolean

    Use IsA instead.

Inherited fromInstance39
Defined bySound10
  • Sound:GetPlaybackState(): string
    • Roblox script security
    • Capabilities: LegacySound
    Returns
    Type
    string
  • Sound:GetUnderlyingAudioPlayer(): AudioPlayer
    • Roblox script security
    • Capabilities: LegacySound
    Returns
    Type
    AudioPlayer
  • Sound:GetWorldCFrame(): CFrame?
    • Roblox script security
    • Capabilities: LegacySound
    Returns
    Type
    CFrame?
  • Sound:Pause()
    Pauses playback of the Sound if it is playing.
    • Capabilities: LegacySound
  • Sound:Play()
    Plays the Sound.
    • Capabilities: LegacySound
  • Sound:Resume()
    Resumes the Sound.
    • Capabilities: LegacySound
  • Sound:Stop()
    Stops the Sound.
    • Capabilities: LegacySound
  • Sound:pause()
    Deprecated: This deprecated function is a variant of Sound:Pause() which should be used instead.
    • Deprecated
    • Capabilities: LegacySound

    Use Pause instead.

  • Sound:play()
    Deprecated: This deprecated function is a variant of Sound:Play() which should be used instead.
    • Deprecated
    • Capabilities: LegacySound

    Use Play instead.

  • Sound:stop()
    Deprecated: This deprecated function is a variant of Sound:Stop() which should be used instead.
    • Deprecated
    • Capabilities: LegacySound

    Use Stop instead.

Events22

Inherited fromObject1
Inherited fromInstance9
Defined bySound12