Guides

payload Definition

In the Bridge Guide, when a case is added, the parameter object payload can be received via communication.
You can apply it by adding the required values per case to the addEventListener.

sauceflexEnter

Join Broadcast – Called automatically upon entering the page; sends an empty payload.

PayloadType
nullVoid

sauceflexBroadcastStatus

Broadcast Status Change – Sends the configured value when the broadcast status changes (automatically called upon status change).

PayloadTypedescription
broadcastStateCodeBroadcastStateCodeBroadcast Status

sauceflexMoveBanner

Banner Click – Sends the configured value when a banner is clicked.

PayloadTypedescription
linkUrlStringBanner link infromation
broadcastIdxStringBroadcast ID
bannerIdStringBanner ID

sauceflexMoveExit

Leave Broadcast – Called when the leave button is clicked; sends an empty payload.

PayloadType
nullVoid

Login Button Click – Called when the login button is clicked; sends an empty payload.

PayloadType
nullVoid

Product Click – Sends the configured value when a product is clicked.

PayloadTypedescription
linkUrlStringProduct link information
broadcastIdxStringBroadcast ID
priceString | NumberProduct price
externalProductIdString | nullProduct code
isSoldoutBooleanSold Out Status

sauceflexOnShare

Share Broadcast Click – Sends the configured value when the share button is clicked.

PayloadTypedescription
linkUrlStringBroadcast Link
shortUrlString | NullBroadcast short Link

sauceflexPictureInPicture

PIP Button Click (WebView only) – Hides the player’s button UI when the PIP button is clicked. (Note: PIP functionality requires separate development.)

PayloadType
nullVoid

sauceflexSendPlayTime

Live/VOD Switching – Continuously sends values when the broadcast switches between live and VOD segments.

PayloadTypedescription
positionNumberCurrent Playback Position

Reward Button Click – Sends the configured value when a button appears after a reward is achieved.

PayloadTypedescription
broadcastIdxStringBroadcast ID
linkUrlStringReward set URL

Coupon Button Click – Sends the configured value when a coupon button is clicked.

PayloadTypedescription
broadcastIdxStringBroadcast ID
couponCodeString | NullCoupon code
couponIdString | NullRegistered Coupon ID
couponNameString | NullRegistered Coupon Name
couponType'link' | 'newWindow' | 'download' | 'custom'Coupon Type
linkUrlString | NullRedirect URL
metadataString | NullCustom Data Passed on Click Event

Usage Example

(You can insert your code snippet or reference to an example here.)

window.addEventListener("message", (e) => {
  if (typeof e.data !== "string") return;

  let jsonData = JSON.parse(e.data);

  switch (jsonData.key) {
    case "sauceflexEnter":
      console.log("Join Broadcast", jsonData.params);
      break;

    case "sauceflexBroadcastStatus":
      console.log("Broadcast Status ", jsonData.params.broadcastStateCode);
      break;

    case "sauceflexMoveExit":
      console.log("Close Broadcast");
      break;

    case "sauceflexMoveBanner":
      console.log("Banner Data – Link Reference", jsonData.params.linkUrl);
      console.log("Banner Data – Broadcast Reference", jsonData.params.broadcastIdx);
      console.log("Banner Data – Banner ID", jsonData.params.bannerId);
      break;

    case "sauceflexMoveLogin":
      console.log("Broadcast Login");
      break;

    case "sauceflexMoveProduct":
      console.log("Product Data – Link Reference", jsonData.params.linkUrl);
      console.log("Product Data – Broadcast Reference", jsonData.params.broadcastIdx);
      break;

    case "sauceflexOnShare":
      console.log("Share Link", jsonData.params.linkUrl);
      console.log("Share ShortLink", jsonData.params.shortUrl);
      break;

    case "sauceflexPictureInPicture":
      console.log("PIP");
      break;

    case "sauceflexSendPlayTime":
      console.log("Current Broadcast Position", jsonData.params.position);
      break;

    case "sauceflexMoveReward":
      console.log("Reward Achievement Link Data", jsonData.params.linkUrl);
      break;

    case "sauceflexMoveCoupon":
      console.log("Coupon Link Data", jsonData.params.linkUrl);
      break;

  }
});