保利威文档中心

幫助中心

reward-receive 獎品領取

更新時間:2025-07-03 14:46:06

一、介紹

獎品領取元件用於直播間的獎品領取功能,支援各種互動功能的獎品領取流程。元件提供獎品資訊展示、領取表單填寫、提交等完整功能。

元件提供一個主要入口元件:

  • RewardReceivePopup - 獎品領取彈窗元件

二、引入

2.1 UMD 方式

<script src="https://websdk.videocc.net/iar-reward-receive-ui/rc-20250612/reward-receive-popup.umd.js"></script>

<script>
const { RewardReceivePopup } = window.PolyvIarRewardReceiveUi;
</script>

2.2 NPM 方式

// 安装依赖
pnpm add @polyv/iar-reward-receive-ui

// 引入组件
import { RewardReceivePopup } from '@polyv/iar-reward-receive-ui';

三、程式碼範例

<template>
  <div>
    <!-- 奖品领取弹窗 -->
    <RewardReceivePopup
      ref="rewardReceiveRef"
      :reward-data="rewardData"
      show-popup
      @to-show="onToShow"
      @to-hide="onToHide"
      @submit-success="onSubmitSuccess"
    />
  </div>
</template>

<script setup>
import { RewardReceivePopup } from '@polyv/iar-reward-receive-ui';

// 奖品数据
const rewardData = ref({
  prizeInfo: {
    prize: '奖品名称',
    thumbnail: 'https://example.com/prize.jpg'
  },
  formList: [
    {
      field: '姓名',
      formType: 'input',
      tips: '请输入您的姓名',
      required: true,
      value: null
    }
  ]
});

// 事件处理
const onToShow = () => {
  console.log('显示奖品领取弹窗');
};

const onToHide = () => {
  console.log('隐藏奖品领取弹窗');
};

const onSubmitSuccess = () => {
  console.log('奖品领取提交成功');
};
</script>

四、API

4.1 Props

參數 說明 型別 預設值 必填
rewardData 獎品領取資料 RewardReceiveData -
showPopup 是否顯示彈窗 boolean false

4.2 Events

事件名 說明 回呼參數
to-show 顯示獎品領取彈窗時觸發 () => void
to-hide 隱藏獎品領取彈窗時觸發 () => void
submit-success 獎品領取提交成功時觸發 () => void

4.3 方法

透過 ref 可以呼叫元件的方法:

方法名 說明 參數 回傳值
show 顯示獎品領取彈窗 - void
hide 隱藏獎品領取彈窗 - void
submit 提交獎品領取資訊 - Promise<void>
联系客服,在线咨询