SoundDropdown

Contents

• Overview
• Fields
• Example
• Preview Behavior

Overview

SoundDropdown stores one sound value and can preview sounds through a custom resolver, custom playback function, or LibSharedMedia lookup.

Fields

Field	Type	Description
soundResolver	function	Converts stored value to playable sound.
previewSoundFunc	function	Custom preview playback.
previewTooltip	string	Tooltip text for preview button.
playbackChannel	string	Sound channel, e.g. "Master".
getPlaybackChannel	function	Dynamic channel provider.
placeholderText	string	Empty selection text.
menuHeight	number	Dropdown menu height.

Example

app:RegisterControl("sounds.alerts", {
  id = "readySound",
  key = "readySound",
  type = "sounddropdown",
  label = "Ready sound",
  placeholderText = NONE or "None",
  playbackChannel = "Master",
  previewTooltip = "Preview this sound.",
  soundResolver = function(value)
    return MyAddon.ResolveSound(value)
  end,
  previewSoundFunc = function(value)
    MyAddon.PlaySound(value)
  end,
})

Preview Behavior

The preview button tries, in order:

1. previewSoundFunc
2. soundResolver
3. LibSharedMedia-3.0 sound lookup
4. Raw stored value