steamworks.getUserStatValue()

概述

从用户获取一个数值统计值。请注意，统计数据在 Steamworks 网站的“统计与成就”部分下定义。统计数据用于存储开发者定义的用户游戏统计信息，例如已玩游戏数、获胜游戏数、失败游戏数等。统计与成就部分。统计数据用于存储开发者定义的用户游戏统计信息，例如已玩游戏数、获胜游戏数、失败游戏数等。

当从其他用户获取统计信息时，必须先使用该用户的 ID 调用 steamworks.requestUserProgress() 函数，并等待 userProgressUpdate 事件成功返回。

注意事项

在以下情况下，此函数将返回 nil

• 给定的 statName 无效。
• 尚未为用户设置统计值（通常是新玩家）。
• 您尝试在未先调用 steamworks.requestUserProgress() 函数的情况下从其他用户获取统计信息。
• steamworks.isLoggedOn 属性为 false，表示应用程序当前未连接到 Steam 客户端。

语法

steamworks.getUserStatValue( params )

参数参考

params 表可以包含以下内容

示例

local steamworks = require( "plugin.steamworks" )

-- Called when user achievement/stat data has been received
local function onUserProgressUpdated( event )
    -- Do not continue if fetching user progression data failed
    if ( event.isError ) then
        return
    end

    -- We're only interested in the currently logged in user's stats (ignore info from other users)
    if ( event.userSteamId ~= steamworks.userSteamId ) then
        return
    end

    -- Fetch a stat from the currently logged in user
    local params =
    {
        statName = "Games Played",
        type = "int",
    }
    local statValue = steamworks.getUserStatValue( params )

    -- If the value is "nil", this stat has not yet been set for this user
    -- This is typically the case for new players
    if ( statValue == nil ) then
        statValue = 0
    end

    -- Print the stat value to the log
    print( "Games Played: " .. tostring(statValue) )
end

-- Set up a listener to be invoked when achievement and stat data has been updated
steamworks.addEventListener( "userProgressUpdate", onUserProgressUpdated )