audio_play_sound_ext

此函数使用任意参数组合播放游戏中的任何声音资源。

该函数将其参数视为结构。根据您提供的参数，该函数的行为类似于audio_play_sound、audio_play_sound_at或audio_play_sound_on。该结构中唯一严格要求的键是sound键。

完整的键值列表如下： 

• sound (Sound Asset or Audio Queue ID, required)
• priority (实数，可选)，默认为 0
• loop (布尔值，可选)，默认为false
• gain (实数，可选)，默认为 1.0
• offset (实数，可选)，默认为资源级别偏移量
• pitch (实数，可选)，默认为 1.0
• listener_mask (实数，可选)，默认为发射器级别的监听器掩码/全局监听器掩码
• emitter (音频发射器 ID，可选)，默认为 undefined
• position (结构, 可选), 默认为 undefined
  • x (实数)
  • y (实数)
  • z (实数)
  • falloff_ref (实数)
  • falloff_max (实数)
  • falloff_factor (实数)

语法:

audio_play_sound_ext(params);

返回:

Sound Instance ID

示例 1：播放基本声音 (类似于 audio_play_sound)

audio_play_sound_ext({ sound: snd_ambience });

上面的代码播放声音 "snd_ambience"。声音实例的默认优先级为 0，不会循环。所有其他声音属性都是默认的，因为结构中没有提供这些属性。

示例 2：在发射器上播放声音 (类似于 audio_play_sound_on)

var _sound_params =
{
    sound: snd_shot,
    priority: 20,
    gain: 1.2,
    pitch: 2,
    emitter: em_north_entrance
};
audio_play_sound_ext(_sound_params);

上述代码首先创建一个临时结构 _sound_params。它存储在现有发射器上播放优先级为 20、增益为 1.2、音调为 2 的声音 "snd_shot" 的设置 em_north_entrance。然后使用 audio_play_sound_ext 播放具有这些设置的声音。

示例 3：在 3D 音频空间中的给定位置播放声音 (类似于 audio_play_sound_at)

var _sound_params =
{
    sound: snd_shot,
    pitch: 1.1,
    position:
    {
        x: 100,
        y: 100,
        z: 20
    }
};
audio_play_sound_ext(_sound_params);

上面的代码创建了一个临时结构 _sound_params。该结构存储播放音调为 1.1、x 为 100、y 为 100、z 为 20 的声音 "snd_shot" 的设置。然后使用这些设置使用 audio_play_sound_ext 播放该声音。