Steam游戏上架五：U3D连接Steamworks SDK制作成就系统

迈不过友情╰ 2023-07-07 05:56 10阅读 0赞

Steam后台会解锁以达成的成就，并弹小窗给玩家，类似这样：

![这里写图片描述][70]

实现 Steam成就系统  步骤：

1. 下载安排steamwork的SDK插件

2. 从Steam后端设置用户成就（和统计）数据API

3. 回调并迭代每项数据并初始化游戏状态

4. 解锁成就

5. 在游戏中显示成就

6. 变更统计数值并上传

下面展开步骤：

一、安装steamwork.net SDK插件  
在Github下载最新的版本：https://github.com/rlabrecque/Steamworks.NET  
将所有内容导入Assets文件夹  
启动Unity，编辑器会把steam\_appid.txt这个文件拷贝到根目录  
打开steam\_appid.txt，把480改成你的AppID（480是Steam的示例工程ID，建议没做过的人先拿480来测试，成功了再移 植到自己的游戏项目里）

更改脚本 SteamManager.cs 找到  SteamAPI.RestartAppIfNecessary(AppId\_t.Invalid)将AppId\_t.Invalid替换成(AppId\_t)480" 或者 "new AppId\_t(480)，480改成自己的APP ID如图：

![20200516093714336.png][]

重启unity，保证 steam\_appid.txt 已生效.

如何使用

1.找到[SteamManagers.cs][]

2.将SteamManager.cs脚本挂在GameObject上，steam会自动生成单例

3.完整C\#接口请点击[查看][Link 1]

**注：需要在https://partner.steamgames.com/home下载sdk，里面有提交游戏的工具，在\\sdk\\tools\\ContentBuilder\\builder  
        在https://partner.steamgames.com/home/steamworks可以查看文档  
        在http://steamworks.github.io/gettingstarted/可以查看C\#接口的使用方式**

** **

二、 从Steam后端设置用户成就（和统计）数据API

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw_size_16_color_FFFFFF_t_70][]

官方API文档说明：[https://partner.steamgames.com/doc/api/ISteamUserStats\#SetAchievement][https_partner.steamgames.com_doc_api_ISteamUserStats_SetAchievement]

解锁成就方法：

## SetAchievement ##

bool SetAchievement( const char \*pchName );

<table> 
 <tbody> 
  <tr> 
   <th>Name</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
  <tr> 
   <td><strong>pchName</strong></td> 
   <td>const char *</td> 
   <td>The 'API Name' of the Achievement to unlock.</td> 
  </tr> 
 </tbody> 
</table>

Unlocks an achievement.  
  
You must have called [RequestCurrentStats][] and it needs to return successfully via its callback prior to calling this!

You can unlock an achievement multiple times so you don't need to worry about only setting achievements that aren't already set. This call only modifies Steam's in-memory state so it is quite cheap. To send the unlock status to the server and to trigger the Steam overlay notification you must call [StoreStats][].  
 //如果成就处在解锁状态,则调用StoreStats上传解锁状态到steam页面  
**Returns:** bool  
This function returns **true** upon success if all of the following conditions are met; otherwise, **false**.

*  The specified achievement "API Name" exists in App Admin on the Steamworks website, and the changes are published.
 *  [RequestCurrentStats][] has completed and successfully returned its callback.

**See Also:** [RequestCurrentStats][], [StoreStats][], [ResetAllStats][], [GetAchievementAndUnlockTime][], [GetAchievement][]

这个是官方的示例工程，其实我只是把官方的代码精练了一遍，剔除我不需要的部分，留下主干，这样便于快速理解。官方示例的下载地址是：https://github.com/rlabrecque/Steamworks.NET

下面就是官方案例，每一个按钮被点击时，当条件触发便达成成就。比如第一次点击“Set State to Winner”即解锁ACH\_WIN\_ONE\_GAME，点击100次之后达成ACH\_WIN\_100\_GAMES. 我把这些功能剔除掉，先以“一进入游戏便达成一个成就”为目的。好吧，我们一步步来实现。

这里要提示一句，拿示例工程做测试的朋友，不要改脚本里成就的ID！ 它必须与Steam后台里被录入的API Name保持一致，不然你测试的时候成就是读取不到的。

三、 回调并迭代每项数据并初始化游戏状态

构造函数初始化游戏状态

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw_size_16_color_FFFFFF_t_70 1][]

四、解锁成就

![20200515184400842.png][]

五、上传解锁状态到steam页面

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw_size_16_color_FFFFFF_t_70 2][]

六、变更统计数值并上传

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw_size_16_color_FFFFFF_t_70 3][]

小结：

--SDK调用为异步调用，用来向 Steam 请求当前用户的统计与成就。 您必须先进行此调用，才能设置统计或成就。 在构造函数内对此方法进行首次调用。 日后若需检查更新后的统计与成就，可随时调用此方法。  
    CS.Steamworks**.SteamUserStats.RequestCurrentStats();  **\--请求成就状态

CS.Steamworks**.SteamUserStats.SetStat("stat\_4", 1);**  --设置统计进度(进度条)

CS.Steamworks**.SteamUserStats.SetAchievement();  **\--解锁成就

--但凡您需要更新用户的统计信息时，应进行此调用。  
    CS.Steamworks**.SteamUserStats.StoreStats();  **\--提交成就，实时刷新，不然的话会在游戏结束才会提示成就解锁

下面是完整代码，我剔除了很多东西，别的功能你们可以自己加。

using System.Collections;  
using System.Collections.Generic;  
using UnityEngine;  
using System.ComponentModel;  
using Steamworks;

class AchievementManager : MonoBehaviour  
\{  
//成就  
private enum Achievement : int  
\{  
ACH\_WIN\_ONE\_GAME,  
//有待添加  
\};

private Achievment\_t\[\] m\_Achievements = new Achievment\_t\[\]  
\{  
    new Achievment\_t(Achievement.ACH\_WIN\_ONE\_GAME, "第一个成就","启动游戏立即获得"),  
\};

private class Achievment\_t  
\{  
    public Achievement m\_eAchievementID;  
    public string m\_strName;  
    public string m\_strDescription;  
    public bool m\_bAchieved;

public Achievment\_t(Achievement achivementID, string name, string desc)  
    \{  
        m\_eAchievementID = achivementID;  
        m\_strName = name;  
        m\_strDescription = desc;  
        m\_bAchieved = false;  
    \}  
\}

//游戏状态  
private enum GameState  
\{  
    GAME\_ACTIVE,  
    //有待添加  
\};

//GameID  
private CGameID m\_GameID;

//从Steam获取统计数据?  
private bool m\_bRequestedStats;  
private bool m\_bStatsValid;

//这一帧存储统计数据?  
private bool m\_bStoresStats;

//游戏数据  
private int m\_nTotalNumWins;

protected Callback<UserStatsReceived\_t> m\_UserStatsReceived;  
protected Callback<UserStatsStored\_t> m\_UserStatsStored;  
protected Callback<UserAchievementStored\_t> m\_UserAchievementStored;

//把回调创建放在OnEnable方法内以确保Unity加载完成后重复创建回调  
private void OnEnable()  
\{  
    if (!SteamManager.Initialized) return;

m\_GameID = new CGameID(SteamUtils.GetAppID());

m\_UserStatsReceived = Callback<UserStatsReceived\_t>.Create(OnUserStatsReceived);  
    m\_UserStatsStored = Callback<UserStatsStored\_t>.Create(OnUserStatsStored);  
    m\_UserAchievementStored = Callback<UserAchievementStored\_t>.Create(OnAchievementStored);

m\_bRequestedStats = false;  
    m\_bStatsValid = false;  
\}

private void Start()  
\{  
    m\_nTotalNumWins = 0;  
    OnGameStateChange(GameState.GAME\_ACTIVE);  
\}

private void Update()  
\{  
    if (!SteamManager.Initialized) return;

if (!m\_bRequestedStats)  
    \{  
        if (!SteamManager.Initialized)  
        \{  
            m\_bRequestedStats = true;  
            return;  
        \}  
        //从 Steam 后端调出用户的统计与成就数据  
        bool bSuccess = SteamUserStats.RequestCurrentStats();  
        m\_bRequestedStats = bSuccess;  
    \}  
    //if (!m\_bStatsValid) return;

foreach (Achievment\_t achievement in m\_Achievements)  
    \{  
        if (achievement.m\_bAchieved) continue;  
        switch (achievement.m\_eAchievementID)  
        \{  
            case Achievement.ACH\_WIN\_ONE\_GAME:  
                if (m\_nTotalNumWins !=0)  
                \{UnlockAchievement(achievement);\}  
                break;  
        \}  
    \}  
    //在游戏中的某个节点上传变更  
    if (m\_bStoresStats)  
    \{  
        SteamUserStats.SetStat("NumWins", m\_nTotalNumWins);  
        bool bSuccess = SteamUserStats.StoreStats();  
        m\_bStoresStats = !bSuccess;  
    \}

// 数据准备完成后（RequestCurrentStats），回调  
private void OnUserStatsReceived(UserStatsReceived\_t pCallback)  
\{  
    if (!SteamManager.Initialized) return;  
    if ((ulong)m\_GameID == pCallback.m\_nGameID)  
    \{  
        //加载成就  
        if (EResult.k\_EResultOK == pCallback.m\_eResult)  
        \{  
            Debug.Log("Received stats and achievements from Steam");  
            m\_bStatsValid = true;

foreach (Achievment\_t ach in m\_Achievements)  
            \{  
                //迭代每项数据并初始化游戏状态  
                bool ret = SteamUserStats.GetAchievement(ach.m\_eAchievementID.ToString(), out ach.m\_bAchieved);

if (ret)  
                \{  
                    //在游戏里显示成就的可读属性（name&des）  
                    ach.m\_strName = SteamUserStats.GetAchievementDisplayAttribute(ach.m\_eAchievementID.ToString(), "name");  
                    ach.m\_strDescription = SteamUserStats.GetAchievementDisplayAttribute(ach.m\_eAchievementID.ToString(), "desc");  
                \}  
                else  
                \{  
                    Debug.LogWarning("failed for getting achievement" + ach.m\_eAchievementID);  
                \}  
            \}

SteamUserStats.GetStat("NumWins", out m\_nTotalNumWins);  
        \}  
        else  
            Debug.Log("RequestStats - failed, " + pCallback.m\_eResult);  
    \}  
\}

//回调上传的变更（StoreStats）  
private void OnUserStatsStored(UserStatsStored\_t pCallback)  
\{  
    if ((ulong)m\_GameID == pCallback.m\_nGameID)  
    \{  
        if (EResult.k\_EResultOK == pCallback.m\_eResult)  
        \{  
            Debug.Log("StroeStats-success");  
        \}  
        else if (EResult.k\_EResultInvalidParam == pCallback.m\_eResult)  
        \{  
            Debug.Log("StoreStats-failed to validate");  
            UserStatsReceived\_t callback = new UserStatsReceived\_t();  
            callback.m\_eResult = EResult.k\_EResultOK;  
            callback.m\_nGameID = (ulong)m\_GameID;  
            OnUserStatsReceived(callback);  
        \}  
        else  
        \{  
            Debug.Log("failed-StroeStats");  
        \}  
    \}  
\}

//解锁成就  
private void UnlockAchievement(Achievment\_t achievement)  
\{  
    achievement.m\_bAchieved = true;  
    SteamUserStats.SetAchievement(achievement.m\_eAchievementID.ToString());  
    m\_bStoresStats = true;  
\}

//回调解锁的成就  
private void OnAchievementStored(UserAchievementStored\_t pCallback)  
\{  
    if ((ulong)m\_GameID == pCallback.m\_nGameID)  
    \{  
        if (0 == pCallback.m\_nMaxProgress)  
        \{  
            Debug.Log("Achievement" +pCallback.m\_rgchAchievementName+"unlocked");  
        \}  
        else  
        \{  
            Debug.Log("Achievement '" + pCallback.m\_rgchAchievementName + "' progress callback, (" + pCallback.m\_nCurProgress + "," + pCallback.m\_nMaxProgress + ")");  
        \}  
    \}  
\}

//切换游戏状态  
private void OnGameStateChange(GameState eNewState)  
\{  
    //if (!m\_bStatsValid) return;  
    if (eNewState == GameState.GAME\_ACTIVE)  
    \{  
        m\_nTotalNumWins++;  
    \}  
    m\_bStoresStats = true;  
\}

[70]: https://img-blog.csdn.net/20180828154209854?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl8zOTU5MDE2NA==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[20200516093714336.png]: https://img-blog.csdnimg.cn/20200516093714336.png
[SteamManagers.cs]: https://raw.githubusercontent.com/rlabrecque/SteamManager/master/SteamManager.cs
[Link 1]: http://steamworks.github.io/gettingstarted/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200515184602892.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw,size_16,color_FFFFFF,t_70
[https_partner.steamgames.com_doc_api_ISteamUserStats_SetAchievement]: https://partner.steamgames.com/doc/api/ISteamUserStats#SetAchievement
[RequestCurrentStats]: https://partner.steamgames.com/doc/api/ISteamUserStats#RequestCurrentStats
[StoreStats]: https://partner.steamgames.com/doc/api/ISteamUserStats#StoreStats
[ResetAllStats]: https://partner.steamgames.com/doc/api/ISteamUserStats#ResetAllStats
[GetAchievementAndUnlockTime]: https://partner.steamgames.com/doc/api/ISteamUserStats#GetAchievementAndUnlockTime
[GetAchievement]: https://partner.steamgames.com/doc/api/ISteamUserStats#GetAchievement
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200515184201965.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw,size_16,color_FFFFFF,t_70
[20200515184400842.png]: https://img-blog.csdnimg.cn/20200515184400842.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200515184641666.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20200515185045942.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNjcyNzcw,size_16,color_FFFFFF,t_70