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> |
