年会抽奖系统👋

项目介绍

年会快到了,参与到了设计抽奖系统T-T,本项目基于THREEJS+webpack+HTML实现一个配置化的抽奖页面,所有的配置都是基于JSON配置，喜欢本作品就来个🌟吧。

页面预览

浏览地址

web浏览地址

启动项目

安装依赖

yarn intall 安装依赖...

启动项目

yarn dev  启动项目...

项目打包

yarn build 项目打包..

node版本

    //推荐版本  12.11.0

目录结构

Lottery-web
  ├── src
  │   ├── lottery
  |   |   ├── mock.js
  │   │   └── index.js
  │   ├── lib
  │   ├── img
  │   ├── css
  │   └── data
  ├── package.json
  └── webpack.config.js

Mock中

参数	值类型	描述
user	Array[Info]	奖品类型，唯一标识，0 是默认特别奖的占位符，其它奖品不可使用
COMPANY	string	公司名
prizes	Array[Gift]	奖品信息
luckyData	{type:Array[Info]}	中奖名单 type为奖品类型
leftUsers	Array[Info]	当前奖池可以抽取人员
excludeUser	Array[Info]	排除奖池人员述
atmosphereGroupCard	String	气氛组卡片
background	String	背景图片
EACH_COUNT	Array[Number]	抽奖次序默认有个隐藏顺序
width	string	渲染抽奖墙宽度比例 最好按照原比例去做
height	string	渲染抽奖墙长度比例 最好按照原比例去做
bgVideo	string	可以放动态渲染图(mp4类型这种) 使用时会自动覆盖背景不用时请注释或者null该属性

Gift详情

/**
 * 奖品设置
 * type: 唯一标识，0是默认特别奖的占位符，其它奖品不可使用
 * count: 奖品数量
 * title: 奖品描述
 * text: 奖品标题
 * img: 图片地址
 * ROTATE_TIME:转的球速度越大越慢
 * circle:旋转圈数最好8*x倍数
 * enter: //抽奖进行时音乐
 * awards: //颁奖音乐
 */
   {
    type: 1,
    count: 1,
    text: "一等奖 ",
    title: "价值5999元",
    img: "./img/huawei.png",
    enter: "1st-lottery",//抽奖进行时音乐
    awards: "1st-BJ-BGM",//颁奖音乐
    ROTATE_TIME: 20000,
    circle: 8 * 6

  },

内置方法

插入抽奖前的方法

/**
 * @description: 不能说的秘密
 * @param {*} nowItem 当前奖品
 * @param {*} basicData 当前奖池人员
 * @return {*}
 * @Date: 2022-01-13 15:13:31
 */
function setSecret(nowItem,basicData) {
  if (nowItem.type != 4) {
    const excludeId = excludeUser.map(item => item[0])
    basicData.leftUsers = basicData.leftUsers.filter(human => !excludeId.includes(human[0]))
    // console.log(basicData.leftUsers);
  }
}

背景音乐说明

方法在index.js replaceMusic('enter-BGM')进行场景音乐替换(默认格式为m4a)

参数	描述
enter-BGM	进场音乐
other-BJ-BGM	抽奖颁奖音乐
other-lottery	抽奖进行时音乐
1st-BJ-BGM	抽奖颁奖音乐
1st-lottery	抽奖进行时音乐
shenchou	备用

动态壁纸和静态壁纸

新加入的动态属性会初始化时候判断是否设置了动态壁纸URL,这里推荐在线地址,本地路径请用相对路径去导入,如不适用动态壁纸请把属性设置为null

Store（缓存）

当页面刷新了怎么办,别担心这里做了页面数据缓存 所有数据都优先读取缓存中数据,当页面刷新时自动读取,如果没有缓存自动初始化话数据

页面逻辑

• 抽奖=>对奖池人进行当前奖品抽奖,当再次进行抽奖时会保存上次抽奖结果到缓存中并更新luckUser和leftUser
• 重新抽奖=>将当前抽中的人员扔回leftUser中(这里和原作者不同,原作者是直接删除了提出了刚才重抽之前人员),进行重新抽奖仍有可能抽中点重抽之前的人(当前轮)
• 颁奖模式=>进行当前奖品的颁奖模式bgm
• 重置=>无视一切条件进行页面重置（与原作不同）
• 奖池每次重置都会被打乱池子顺序,优化随机算法

自行修改(需要自己二次开发)

1. 卡片显示编号和名字(index.js)
2. 选中颜色（index.css）
3. 卡片背景 (index.css)
4. 不能说的秘密逻辑自定义开发(mock.js)

更新日志

• 增加分支feat-manual，用于手动停球，有这个功能需求的小伙伴可以下载该分支开发
• 删除package中多余的第三方库

鸣谢

本项目是基于@moshang-xc大佬写的作品很炫酷,于是本人就二次开发了下大佬的作品,实现脱离后台前端mock分离版本,喜欢的可以给@moshang-xc点个Star