CreateSound: Difference between revisions

From Onset Developer Wiki
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{Info|Function|Client|1.0}}
{{Info|Function|Client|1.0}}


{{FuncDescription|Plays a local audio file or over http. Also supports playing .pls network streams.}}
{{FuncDescription|Plays a local audio file or over http. Also supports playing .pls network streams.
 
See [[packages]] what audio file types are supported.}}


{{FuncSyntax|CreateSound(SoundFile [, bLooping])}}
{{FuncSyntax|CreateSound(SoundFile [, bLooping])}}
Line 14: Line 16:
<syntaxhighlight lang="Lua">
<syntaxhighlight lang="Lua">
-- Load sound from some package
-- Load sound from some package
CreateSound("package/sounds/mysound.mp3")
CreateSound("testpackage/sounds/mysound.mp3")
 
-- Load sound from current package
-- Load sound from current package
CreateSound("sounds/mysound.mp3")
CreateSound("sounds/mysound.mp3")
-- Play HTTP network stream
CreateSound("http://us4.internet-radio.com:8258/listen.pls&t=.pls")
</syntaxhighlight>
</syntaxhighlight>


{{RelatedFunctions}}
{{RelatedFunctions}}
{{SoundFunctions}}
{{SoundFunctions}}

Latest revision as of 18:50, 14 December 2020

CreateSound

Type: Function
Context: Client
Introduced: v1.0

Description

Plays a local audio file or over http. Also supports playing .pls network streams.

See packages what audio file types are supported.

Syntax

CreateSound(SoundFile [, bLooping])

Parameters

  • SoundFile
    The path to the file to play. Or a HTTP network stream or file.
  • bLooping (optional)
    Whether this sound should loop. Default: false.

Return Value

  • Returns the sound identifier. Returns false on error. Once the playback has finished the sound identifier will be destroyed automatically.

Example

-- Load sound from some package
CreateSound("testpackage/sounds/mysound.mp3")

-- Load sound from current package
CreateSound("sounds/mysound.mp3")

-- Play HTTP network stream
CreateSound("http://us4.internet-radio.com:8258/listen.pls&t=.pls")

See also