Sound

From ActiveWiki
Revision as of 06:35, 18 November 2014 by Dodgy (talk | contribs) (→‎Notes)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Sound
Build

N/A

Version

N/A

The sound command attaches a background sound to an object which can be a file in either the WAV, MIDI, or MP3 format.

Active Worlds only plays a single background sound at a time; so if there are multiple background sounds active in a scene the sound of the closest object plays. The volume and left/right panning of the sound are adjusted depending on the distance and direction of the object from the user.

Usage

sound url [loop OR noloop] [name=name] [global]

url

The URL can either be the name of a sound local to that world (i.e. a sound located in the "sound" folder of the world's object path) or it can be an absolute URL to a .wav, .mid, or .mp3 file on the web.

loop / noloop

The optional loop and noloop flags indicate whether the sound is played once or loops indefinitely. The default setting for WAV and MP3 files is loop while noloop' is default for MIDI files.

name

The optional name argument specifies the name of another nearby object to attach the sound to.

global

A command with the Global argument appended will cause the sound to be played for all users who have the object in view. Without the Global parameter, the sound will be played exclusively for the person who activates the trigger (bump, activate, adone).

Examples

create sound atmos1.mid

This creates an object which will play the MIDI file "atmos1.mid" whenever a user approaches it. Note that since this is a "local" sound, atmos1.mid must be present in the "sounds" directory of the world's object path as "atmos1.zip" in order to play.

Notes

  • Downloads of external audio files may be limited by the user's maximum audio file size setting in the Options dialog.
  • Although there are different check boxes for background music, sound effects, building and telegram sounds, unchecking one could affect others as all sound channels are being merged.
Object Scripting

Triggers: CreateBumpActivateAdoneAtCollideSdoneEnter ZoneExit Zone

Commands: AddforceAddtorqueAlpharefAnimateAstartAstopCameraColliderColltagColorCoronaEnviExamineFrameGroupLightLinkLockMatfxMediaMidiMoveNameNoiseOpacityPictureRotateSayScale SeqShadowShearSignSkewSkyboxSolidSoundTagTeleport / TeleportxTextureTimerURLVelocityVisibleWarpWeb nl:Commando:Sound