# 抽奖系统
# 一、介绍
该模块提供游戏抽奖功能,可用于发起抽奖、查看可用抽奖配置等。使用该模块请先配置抽奖配置,随机池配置,以及限制配置
抽奖配置用于配置总共有多少个奖励池,每个奖励池对应一个限制配置,用于配置每月可抽奖多少次。每个奖励池对应一个随机池配置,随机池配置用于配置一个池子有多少奖品。
同时我们还提供一个特殊随机池,用于配置用户在抽奖多少次之后,必得什么奖品,一个特殊随机池其实也是一个随机池,一个随机池配置一个奖品,可保证该奖品必得。
# 二、使用
1. 获取抽奖信息列表
// 导入模块
import { lotterySystem } from "@timi/mogs-sdk";
...
// 获取抽奖信息列表
const lotteries = await lotterySystem.lotteries;
1
2
3
4
5
2
3
4
5
2. 抽奖
lotterySystem
在获取到抽奖列表之后,使用lotterySystem.drawLottery
进行抽奖,id
为上面获取抽奖列表接口返回的其中一个抽奖配置的id。
// 头部引入signInSystem
import mogs, { lotterySystem } from "@timi/mogs-sdk";
...
// 调用签到
try {
result = await lotterySystem.drawLottery({
lotteryId: lotteryId, // id从`lotterySystem.lotteries`获取列表中获得
count: 1,
});
console.log("result:", result);
}catch (error) {
mogs.showToast({
icon: "none",
title: error.message || "抽奖错误",
});
this.isOn = false;
return;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
TIP
更多排行榜模块的api请参考抽奖系统