[适配027]成长之路，制作成就系统，增加用户留存

使用环境编辑器版本：021及以上
功能介绍
效果演示视频


能做到什么
1.可以根据游戏中玩家的进度给予一定的奖杯，通过奖杯兑换奖励
2.根据登录天数发放奖励，这里的登录天数需要在用户登录时通过代码增加
3.发放奖励是走客户端的本地接口，回传了相关配置
4.所有的UI都可以实现自定义修改，但注意现有的UI不能重命名或者删除
5.通过自定义数据来源可以实现多种成长之路
不能做到什么
1.不能同时定义多条成长之路，因为成长之路的服务端存储数据是一套
2.因为游戏中的奖励可能多种多样，成长之路不负责奖励的发放，只记录奖励的发放状态和是否可发放

一分钟快速上手
1.导入以下预制体
PassPort.zip (28.63 KB, 下载次数: 77)

2023-10-31 14:31 上传

点击文件名下载附件
2. 将预制体拖入场景
3. 在客户端运行下列代码，运行查看效果

真实的数据来源可能是导表数据或配置文件，这里只是测试数据

if (SystemUtil.isClient()) {

    //导入测试数据文件

    for (let i = 0; i < 100; i++) {

        const element = {} as any;

        //以下字段必须有，也可以扩展更多自己的字段

        element.id = i + 1;

        //大奖品图标，用作显示 

        element.icon = "94194";

        element.text = "测试奖品" + i;

        //附加奖励道具图标，用作显示              

        element.rewardIcon = "37778";

        //所需进度

        element.progress = 500 + i * 500; 

        //附加奖励道具数量，用作显示，这里为了方便直接等于所需进度              

        element.rewardCount = element.progress;

        PassPortService.addConfig(element);

    }

  //注册奖励回调



PassPortService.setRewardCallback((cfg) => {

        console.log("发放奖励", JSON.stringify(cfg));

});

}

进阶用法
API列表
- 增加奖杯数量
PassPortService.addProgress(300);
- 获取奖杯数量
PassPortService.getProgress();
- 打开成长之路-仅客户端可用
PassPortService.show();
- 关闭成长之路-仅客户端可用
PassPortService.close();


修改外观
1. 修改背景
  打开PassPort预制体，可以看到里面有很多场景节点，这些场景会被当做成长之路的背景，你可以给背景增加自己喜欢的元素，甚至增加脚本写一些小动画

2. 修改UI
PassPort/UI文件夹下面有4个UI
PassPortBackUI：用来贴到场景上当作3D背景，对应背景上的浅蓝色部分
PassPortEntrance：功能入口按钮
PassPortMainUI：主界面，包含退出按钮和成长之路列表容器以及当前奖杯显示
PassPortItemUI：单个成长之路的格子UI，一个成长之路由多个格子拼接而成

你可以随意修改UI上的内容，自定义显示形式，但注意不可删除现有UI，只能在现有UI的基础上增加或改变UI图片

这个背景好炫

空伊伊 发表于 2023-2-21 15:00
这个背景好炫

超酷炫，我要窃过来用