audio_play_id_for_character(human_name, audio_id[, type_name[, blocking[, variant[, voice_distance]]]]) | ||
Parameters: | ||
human_name | (string) name of character | |
audio_id | (integer) ID of sound to play | |
type_name | (string, optional) name of audio source (can be "foley", "voice", "music", or "ambient"; defaults to "foley") | |
blocking | (boolean, optional) set to true if the function should block until the sound has finished playing (defaults to false) | |
variant | (integer, optional) index of the specific variant of the voice line to play (or -1 for a random selection; defaults to -1) | |
voice_distance | (integer, optional) distance that the foley can be heard from; only used for voices (0 = short, 1 = normal, 2 = long, 3 = extreme; defaults to -1, which is normal distance for peds, and extreme distance for passengers in cars) | |
Returns: | ||
(integer) audio instance handle, or -1 on error | ||
Description: | ||
Play a 3D sound (by ID) on a character. | ||
back to index | SR3 Script Action Documentation Last updated: Tue, 09 Aug 2011 11:32:15 |