保利威文档中心

帮助中心

lottery 抽奖

更新时间:2025-07-03 14:46:06

一、介绍

抽奖组件用于直播间的抽奖功能,支持多种抽奖类型和场景。组件包含抽奖详情、抽奖结果、中奖记录、奖品领取等完整的抽奖流程功能。

组件提供多种不同的入口组件:

  • LotteryDetail - 抽奖详情组件
  • LotteryResult - 抽奖结果组件
  • LotteryRecord - 中奖记录组件
  • LotteryReceive - 奖品领取组件
  • LotteryPendant - 抽奖挂件组件
  • LotteryDialog - 抽奖弹窗组件
  • LotteryAnimation - 抽奖动画组件
  • LotteryAnswerQuestion - 答题抽奖组件
  • LotteryWinners - 中奖名单组件

二、引入

2.1 UMD 方式

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

<script>
const { LotteryDetail, LotteryResult, LotteryRecord, LotteryReceive } = window.PolyvIarLotteryUi;
</script>

2.2 NPM 方式

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

// 引入组件
import {
  LotteryDetail,
  LotteryResult,
  LotteryRecord,
  LotteryReceive,
  LotteryPendant,
  LotteryDialog
} from '@polyv/iar-lottery-ui';

三、代码示例

<template>
  <div>
    <!-- 抽奖详情 -->
    <LotteryDetail
      ref="lotteryDetailRef"
      :lottery-target="lotterySDK"
      :lottery-config="lotteryConfig"
      @to-show="onToShow"
      @to-hide="onToHide"
    />

    <!-- 抽奖结果 -->
    <LotteryResult
      ref="lotteryResultRef"
      :lottery-target="lotterySDK"
      :lottery-config="lotteryConfig"
      @to-show="onToShow"
      @to-hide="onToHide"
    />
  </div>
</template>

<script setup>
import { LotteryDetail, LotteryResult } from '@polyv/iar-lottery-ui';
import { Lottery } from '@polyv/iar-lottery-sdk';

// 初始化抽奖 SDK
const lotterySDK = new Lottery(iarCore);

// 抽奖配置
const lotteryConfig = {
  enableSoundEffects: true,
  showParticipants: true
};

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

const onToHide = () => {
  console.log('隐藏抽奖弹窗');
};
</script>

四、API

4.1 Props

参数 说明 类型 默认值 必填
lotteryTarget 抽奖 SDK 实例 Lottery -
lotteryConfig 抽奖配置选项 LotteryConfig {}

4.2 Events

事件名 说明 回调参数
to-show 显示抽奖弹窗时触发 () => void
to-hide 隐藏抽奖弹窗时触发 () => void

4.3 方法

通过 ref 可以调用组件的方法:

方法名 说明 参数 返回值
show 显示组件 - void
hide 隐藏组件 - void
refresh 刷新抽奖数据 - Promise<void>
联系客服,在线咨询