1.0.16 • Published 4 days ago

@taojimu/mx-level-result v1.0.16

Weekly downloads
-
License
ISC
Repository
-
Last release
4 days ago

结果浮层

截图

获得优惠券、实物奖、现金红包

未获奖、已解开所有福利、未获得宝箱(无抽奖资格)

属性

属性名类型默认值描述
classNameString-自定义组件的样式
visibleBooleanfalse是否展示浮层
closableBooleantrue是否展示浮层关闭按钮
modeString'score'游戏模式,可选积分模式score 或 宝箱模式box
gapNumber0mode相关,距离下一福利还需多少分(积分模式),或待解锁宝箱还有多少个(宝箱模式)
prizeObject淘积木奖池对象。
couponsArray淘积木优惠券数据的数组。
dialogBgImgObject见下文关卡结果浮层的背景图片。尺寸要求:650x780 的 png
noPrizeBannerImgObject见下文没有中奖的情况下的 banner 头图。尺寸要求:510x174 的 png
noPrizeBannerLinkString-结果浮层中“兜底 banner”图片的跳转链接,不填写则无跳转。
dialogBtnColorArrayString['#f5515f', '#9f041b']关卡结果浮层主按钮的颜色。支持通过数组传 2 个色做从上到下的渐变色,传一个色则为纯色按钮
linkString跳转店铺首页结果浮层中“了解更多”按钮的跳转链接,不填写则默认跳转至店铺首页。
continueBtnTextString-结果浮层中“继续挑战”按钮的文字
onContinueFunction-结果浮层中“继续挑战”按钮的回调
onCancelFunction-点击遮罩层或右上角叉或下方叉或取消按钮的回调。因为是受控组件,请务必在 onCancel 中通过 setData设置 visiblefalse

dialogBgImg

属性名类型默认值描述
srcString默认图片地址关卡结果浮层的背景图片的 url
widthNumber650图片宽度
heightNumber700图片高度

noPrizeBannerImg

属性名类型默认值描述
srcString默认图片地址关卡结果浮层的背景图片的 url
widthNumber510图片宽度
heightNumber174图片高度

安装

# npm 国内用户可设置淘宝镜像
npm config set registry https://registry.npmmirror.com
npm install @taojimu/mx-level-result -S

# yarn
yarn add @taojimu/mx-level-result -S

使用

介绍

  • 点击继续挑战后(即在onContinue的回调中),开发者需要先通过 taojimu.task.queryInfo 查询任务数据,获得游戏剩余机会chance,若有游戏机会(chance > 0)则继续游戏,否则则通过控制mx-task组件的visible属性打开任务面板,通过做任务来获取游戏机会。
  • 互动的每个关卡/阶段结束后,需要抽奖时,开发者通过控制该组件的visible属性来展示浮层,通过 gapprizecoupons来控制展示不同状态的浮层。
  • 组件内置了埋点,如是否有抽奖资格、是否中奖、中的什么奖等等。
  • props 中的所有图片、优惠券、奖池等数据,请从淘积木的 compExt 中读取。
  • 浮层状态解释:

    gapprize、coupons是否中奖顶部底部
    大于 0红包、优惠券、实物奖下一福利还差 xx 分,或待解锁宝箱还有多少个
    大于 0未中奖,继续加油下一福利还差 xx 分,或待解锁宝箱还有多少个
    大于 0-再接再厉下一福利还差 xx 分,或待解锁宝箱还有多少个
    大于 0从未配置过-再接再厉就差一点点!继续挑战高分吧!
    0 或不传红包、优惠券、实物奖恭喜!福利全解锁
    0 或不传未中奖,继续加油恭喜!福利全解锁
    0 或不传-恭喜完成任务恭喜!福利全解锁
    0 或不传从未配置过-恭喜完成任务成功过关!继续挑战高分吧!

.json 示例代码

{
  "usingComponents": {
    "mx-level-result": "@taojimu/mx-level-result/es/mx-level-result"
  }
}

.axml 示例代码

<mx-level-result
  visible="{{visible}}"
  gap="{{gap}}"
  prize="{{prize}}"
  onCancel="onCancel"
  onContinue="onContinue"
>
</mx-level-result>

.js 示例代码

setEnv 介绍

const taojimu = requirePlugin('taojimu');
Page({
  data: {},
  onLoad() {
    const compExt = my.getExtConfigSync().componentTree[0].compExt;

    // 必须要设置setEnv,具体请参考上文的 setEnv介绍
    taojimu.setEnv({
      cid: 'test', // 当前游戏的唯一标志,全局唯一,应该避免和其他游戏isv商冲突。所有的cid 公用一个值即可。主要避免和其他isv重复。
      pageId: 123456, // 页面id, 由淘积木负责生成。测试时可随便制定,用于和cid 一起区分不同isv 厂商在不同页面下游戏和任务的消耗情况。
    });

    this.setData({
      gap: 300,
      visible: true,
      link: 'https://h5.m.taobao.com',
      prize: compExt.prize,
    });
  },
  onContinue() {
    this.setData({
      visible: false,
    });
  },
  onCancel() {
    this.setData({
      visible: false,
    });
  },
});

ext.json 示例代码

如何生成具体的数据请参见 meta 文档

{
  "extEnable": true,
  "ext": {
    "componentTree": [
      {
        "meta": [
          {
            "key": "prize",
            "type": "oright",
            "required": true,
            "title": "奖池配置"
          }
        ],
        "compExt": {
          "prize": {
            "poolId": 16082075,
            "creatorId": 22473103,
            "type": 3,
            "ename": "44d478d3b291d2870",
            "name": "啸棠测试新版权益发奖",
            "startTime": "2021-08-16 01:00:10",
            "endTime": "2021-09-30 00:00:00",
            "status": 1
          }
        }
      }
    ]
  }
}
1.0.16

4 days ago

1.0.15

4 days ago

1.0.14

5 days ago

1.0.13

6 days ago

1.0.13-alpha.1

8 days ago

1.0.13-alpha.0

9 days ago

1.0.11

8 months ago

1.0.12

8 months ago

1.0.10

1 year ago

1.0.9

1 year ago

1.0.8

2 years ago

1.0.7

2 years ago

1.0.6

2 years ago

1.0.5

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago

1.0.4

2 years ago

1.0.3

2 years ago

0.0.13

2 years ago

0.0.14

2 years ago

0.0.15

2 years ago

0.0.16

2 years ago

0.0.17

2 years ago

0.0.12

2 years ago

0.0.11

2 years ago

0.0.10

2 years ago

0.0.9

2 years ago

0.0.8

2 years ago

0.0.7

2 years ago

0.0.6

2 years ago

0.0.5

2 years ago

0.0.4

2 years ago

0.0.3

2 years ago

0.0.2

2 years ago