1.0.19 • Published 3 days ago

@taojimu/mx-home v1.0.19

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

首页

截图

首页

互动规则浮层、我的奖励浮层

属性

属性介绍

属性名类型默认值描述
classNameString-自定义组件的样式
showDialogString-展示奖励浮层或规则浮层,可选值:ruleprize
dialogBgColorString#F67F7F互动规则、我的奖励浮层的背景色
isFullScreenBooleanfalse互动是否全屏展示。为 false 时,互动高度以 gameBgImg(宽度换算为 750)的高度为准。为 true 时,互动高度为屏幕高度
gameBgImgObject见下文小程序首页互动区域的背景图。尺寸要求:750x1624 的 png
isShowHomeBooleantrue整个组件区域是否展示。为 false 时,整个组件区域不展示,但可以单独通过传showDialog来展示浮层
isShowGameMainBooleantrue中心卡片区域及动态互动介绍区域是否展示。为 false 时,中心卡片区域gameMainImg及动态互动介绍区域gameIntro均不展示
isShowStartBtnBooleantrue“开始按钮”是否展示。为 false 时,“开始按钮”不展示
gameMainImgObject见下文中心卡片区域。尺寸要求:680x950 的 png
gameIntroObject见下文动态互动介绍区域的介绍,支持格式: mp4、mov、gif、apng(apng 格式的图片后缀建议为 apng,否则没有动画效果),尺寸要求:600x480
startBtnImgObject见下文开始按钮的图片。尺寸要求:530x100 的 png
ruleBtnImgObject见下文点击查看互动规则按钮的图片。尺寸要求:80x80 的正方形 png
prizeBtnImgObject见下文点击查看我的奖励按钮的图片。尺寸要求:80x80 的正方形 png
dialogHeaderImgObject见下文规则浮层和奖励浮层共用的头部背景图片,不包括文字。尺寸要求:750x200 的 png。注意,若传入该值,则 prizeDialogHeaderImg 和 ruleDialogHeaderImg 将不再生效
prizeDialogHeaderImgObject见下文点击查看互动规则浮层头部的图片。尺寸要求:750x200 的 png
ruleDialogHeaderImgObject见下文点击查看我的奖励浮层头部的图片。尺寸要求:750x200 的 png
prizeDialogNoPrizeImgObject见下文我的奖励浮层中,没有任何奖励时的兜底图片。尺寸要求:300x300 的 png
onGameStartFunction-点击开始按钮的回调
onShowRuleFunction-点击查看互动规则按钮的回调
onShowPrizeFunction-点击查看我的奖励按钮的回调
onCancelFunction-点击互动规则、我的奖励的浮层或遮罩层的回调。因为是受控组件,请务必在使用 showDialog 时,在 onCancel 中通过 setData设置 showDialog''

gameBgImg

属性名类型默认值描述
srcString默认图片地址图片的 url
widthNumber750图片宽度
heightNumber1624图片高度

gameMainImg

属性名类型默认值描述
srcString默认图片地址图片的 url
widthNumber680图片宽度
heightNumber950图片高度

gameIntro

属性名类型默认值描述
srcString-资源的 url
posterString-视频格式的互动介绍资源的封面图。若互动介绍资源为视频格式,则为必传项。
durationString-视频格式的互动介绍资源的时长,单位秒。若互动介绍资源为视频格式,则为必传项。
widthNumber600资源宽度
heightNumber480资源高度

startBtnImg

属性名类型默认值描述
srcString默认图片地址图片的 url
widthNumber530图片宽度
heightNumber100图片高度

ruleBtnImg | prizeBtnImg

属性名类型默认值描述
srcString规则按钮默认图片奖励按钮默认图片图片的 url
widthNumber750图片宽度
heightNumber200图片高度

dialogHeaderImg

属性名类型默认值描述
srcString头图背景图片的 url
widthNumber750图片宽度
heightNumber200图片高度

prizeDialogHeaderImg | ruleDialogHeaderImg

属性名类型默认值描述
srcString奖励头图规则头图图片的 url
widthNumber750图片宽度
heightNumber200图片高度

prizeDialogNoPrizeImg

属性名类型默认值描述
srcString默认图片地址图片的 url
widthNumber300图片宽度
heightNumber300图片高度

插槽介绍

插槽名描述
rule互动规则的内容
prize我的奖品的列表,或是奖品为空或拉取奖品出错的兜底状态

安装

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

# yarn
yarn add @taojimu/mx-home -S

使用

介绍

  • 点击开始游戏后(即在onGameStart的回调中),开发者需要先通过 taojimu.task.queryInfo 查询任务数据,获得游戏剩余机会chance,若有游戏机会(chance > 0)则去游戏,否则则通过控制mx-task组件的visible属性打开任务面板,通过做任务来获取游戏机会。
  • props 中的所有图片、视频数据对象,请从淘积木的 compExt 中读取。
  • 首页的互动任务浮标需要自己实现,方案请点击查看 互动任务浮标的文档
  • 我的奖品列表上线后方可测试。我的奖品列表会查询淘积木页面 id 中所有历史奖池的中奖奖品并汇总,因此页面 id 要真实存在,且页面 id 要跟奖池进行绑定(即在淘积木编辑器选择页面用到的奖池,然后发布页面)。

.json 示例代码

{
  "usingComponents": {
    "mx-home": "@taojimu/mx-home/es/mx-home"
  }
}

.axml 示例代码

<mx-home
  onGameStart="onGameStart"
  onShowRule="onShowRule"
  onShowPrize="onShowPrize"
  gameIntro="{{gameIntro}}"
>
  <view class="home-rule" slot="rule">
    <view class="title">1.玩法说明</view>
    <view class="info"
      >活动期间,用户通过每日到访活动页面签到,完成规定的连续签到任务,即可获得“1分钱兑换商品”资格+0.01元零钱(以下简称“1分兑”资格);用户需要进入页面开启签到进度。</view
    >
    <view class="title">2.游戏次数获取</view>
    <view class="info"
      >活动期间,符合条件的用户通过手机淘宝客户端,进入活动页面,即可根据页面提示参与活动。淘宝或天猫在支付宝等渠道发布的小程序无法参与本活动。</view
    >
    <view class="title">3.奖励说明</view>
    <view class="info"
      >活动期间,符合条件的用户通过手机淘宝客户端,进入活动页面,即可根据页面提示参与活动。淘宝或天猫在支付宝等渠道发布的小程序无法参与本活动。</view
    >
    <view class="title">4.活动时间</view>
    <view class="info">2021年3月8日00:00:00——2022年4月30日23:59:59</view>
  </view>
</mx-home>

.js 示例代码

const taojimu = requirePlugin('taojimu');

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

    this.setData({
      gameIntro: compExt.video_gameIntro,
    });
  },
  onGameStart() {},
  onShowRule() {},
  onShowPrize() {},
});

ext.json 示例代码

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

{
  "extEnable": true,
  "ext": {
    "componentTree": [
      {
        "meta": [
          {
            "title": "视频选择",
            "extension": { "recsize": 0.5 },
            "key": "video_gameIntro",
            "type": "video_unify"
          }
        ],
        "compExt": {
          "video_gameIntro": {
            "duration": 3,
            "url": "https://a1.alibabausercontent.com/prod/feupload/user/qr/c3e1a9a0-2b10-11ec-baf0-fff1de6c9a40.mp4_.mp4",
            "width": 800,
            "height": 800,
            "snapshot": "https://a1.alibabausercontent.com/prod/feupload/user/qr/c3e1a9a0-2b10-11ec-baf0-fff1de6c9a40.mp4_.mp4?x-oss-process=video/snapshot,t_0,w_800,h_800",
            "poster": "https://a1.alibabausercontent.com/prod/feupload/user/qr/c3e1a9a0-2b10-11ec-baf0-fff1de6c9a40.mp4_.mp4?x-oss-process=video/snapshot,t_0,w_800,h_800",
            "name": "8WUelvWCo9MVQW2AAh5.mp4"
          }
        },
        "version": "0.0.1"
      }
    ]
  }
}
1.0.19

3 days ago

1.0.18

4 days ago

1.0.17

4 days ago

1.0.16

4 days ago

1.0.15

6 days ago

1.0.15-alpha.1

8 days ago

1.0.15-alpha.0

8 days ago

1.0.14

8 months ago

1.0.13

1 year ago

1.0.12

1 year ago

1.0.11

1 year ago

1.0.10

2 years ago

1.0.9

2 years ago

1.0.8

2 years ago

1.0.7

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago

0.0.23

2 years ago

1.0.6

2 years ago

1.0.5

2 years ago

1.0.4

2 years ago

1.0.3

2 years ago

0.0.20

2 years ago

0.0.21

2 years ago

0.0.22

2 years ago

0.0.17

2 years ago

0.0.18

2 years ago

0.0.19

2 years ago

0.0.14

2 years ago

0.0.15

2 years ago

0.0.16

2 years ago

0.0.13

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

0.0.1

2 years ago