Unity SKFramework框架（十二）、Score 计分模块

目录

一、配置文件

1.新建

2.编辑

3.路径

二、创建分数

1.创建单项分数

2.创建分数组合

三、获取分数

四、取消分数

五、计算总分

---

一、配置文件

1.新建

通过右键/Create/Score Profile创建一个分数配置文件

2.编辑

首先在ScoreIDConstant脚本中编写代表分数项ID的int常量

填写配置文件

ID为分数项ID，Description为分数项描述信息，Value为分数项分值。

3.路径

模块内默认的配置文件加载路径为Resources/Score Profile，也可以在代码中进行更改

//加载配置文件
Resources.Load<ScoreProfile>("Score Profile");

二、创建分数

1.创建单项分数

使用Create方法创建单项分数，参数传入分数项ID

using UnityEngine;
using SK.Framework;

public class Example : MonoBehaviour
{
    private void Start()
    {
        Score.Create(ScoreIDConstant.QUESTION_1);
    }
}

2.创建分数组合

使用CreateGroup方法创建分数组合，第一个参数传入分数组合的命名；第二个参数传入计分的方式，有两种计分方式，Additive表示分数是累加的，Mutually Exclusive表示组合内分数项之间是互斥的；后面的参数均为分数项ID，为可选参数。

using UnityEngine;
using SK.Framework;

public class Example : MonoBehaviour
{
    private void Start()
    {
        Score.CreateGroup("选择题", ValueMode.Additive,
            ScoreIDConstant.QUESTION_1, 
            ScoreIDConstant.QUESTION_2,
            ScoreIDConstant.QUESTION_3,
            ScoreIDConstant.QUESTION_4);
    }
}

三、获取分数

创建分数项时会返回对应数量的标识，通过这些标识可以获取、取消分数。

using UnityEngine;
using SK.Framework;

public class Example : MonoBehaviour
{
    private void Start()
    {
        //创建分数组合 记录标识
        string[] flags = Score.CreateGroup("选择题", ValueMode.Additive,
            ScoreIDConstant.QUESTION_1, 
            ScoreIDConstant.QUESTION_2,
            ScoreIDConstant.QUESTION_3,
            ScoreIDConstant.QUESTION_4);

        //通过标识获取分数
        Score.Obtain("选择题", flags[0]);
    }
}

 上例中表示获取"选择题"分数组合第一个分数项的分值，也就是ID为QUESTION_1的分数项的分值。

四、取消分数

假如想取消一个已经获得的分数项分值，通过Cancle方法实现

using UnityEngine;
using SK.Framework;

public class Example : MonoBehaviour
{
    private void Start()
    {
        //创建分数组合 记录标识
        string[] flags = Score.CreateGroup("选择题", ValueMode.Additive,
            ScoreIDConstant.QUESTION_1, 
            ScoreIDConstant.QUESTION_2,
            ScoreIDConstant.QUESTION_3,
            ScoreIDConstant.QUESTION_4);

        //通过标识获取分数
        Score.Obtain("选择题", flags[0]);

        //取消分数
        Score.Cancle("选择题", flags[0]);
    }
}

如图所示，Obtain获取分数后再通过Cancle取消分数，获得的分值已经取消

五、计算总分

通过GetSum方法获取已经获得的总分值

using UnityEngine;
using SK.Framework;

public class Example : MonoBehaviour
{
    private void Start()
    {
        //创建分数组合 记录标识
        string[] flags = Score.CreateGroup("选择题", ValueMode.Additive,
            ScoreIDConstant.QUESTION_1, 
            ScoreIDConstant.QUESTION_2,
            ScoreIDConstant.QUESTION_3,
            ScoreIDConstant.QUESTION_4);

        //通过标识获取分数
        Score.Obtain("选择题", flags[0]);

        //获取总分
        float sum = Score.GetSum();
    }
}

另外可以通过GetGroupSum方法获取一个分数组合中已经获得的总分值

using UnityEngine;
using SK.Framework;

public class Example : MonoBehaviour
{
    private void Start()
    {
        //创建分数组合 记录标识
        string[] flags = Score.CreateGroup("选择题", ValueMode.Additive,
            ScoreIDConstant.QUESTION_1, 
            ScoreIDConstant.QUESTION_2,
            ScoreIDConstant.QUESTION_3,
            ScoreIDConstant.QUESTION_4);

        //通过标识获取分数
        Score.Obtain("选择题", flags[0]);

        //获取一个分数组合的总分
        float sum = Score.GetGroupSum("选择题");
    }
}