The KUDO Widget Auto-Floor API allows a third-party platform to automatically respond when an attendee selects a language channel inside the KUDO Widget. When interpretation is active, KUDO notifies the parent platform so it can mute or lower the original floor audio. When the attendee returns to Original Audio or interpretation is not active, KUDO sends a message to restore it. This prevents both audio streams from playing at the same time.

How It Works

When an attendee selects a language channel inside the embedded KUDO Widget, KUDO sends a floorMute message to the parent platform via JavaScript's window.postMessage() method. The platform listens for that message and mutes or lowers its original audio accordingly. When the attendee selects Original Audio or interpretation is inactive, KUDO sends the message again with a value that tells the platform to restore audio.

Before You Start

Confirm the following before implementing:

• You have a KUDO client account with access to the Language Access Widget
• The KUDO Widget is embedded in a supported third-party web platform
• Your development team can update the parent page hosting the KUDO iframe
• The iframe is embedded in a single-level hierarchy
• The KUDO language access meeting is scheduled with auto-floor disabled

Implementation

Add the following listener to the parent page hosting the KUDO iframe:

window.addEventListener("message", (event) => {
  try {
    const data = JSON.parse(event.data);
    const muteFloor = data["floorMute"];
    if (muteFloor) {
      // Mute or lower the platform's original meeting audio.
    } else {
      // Unmute or restore the platform's original meeting audio.
    }
  } catch (error) {
    console.log(error);
  }
}, false);

Expected Behavior

A Few Things to Keep in Mind

KUDO sends the floorMute message one level up to the parent window only. The third-party platform is responsible for muting, lowering, or restoring its own floor audio — KUDO does not directly control the platform's audio player. This workflow is intended for embedded Widget experiences where the platform needs to manage original audio playback automatically.

Need Help?