achievementImageUpdate

概述

当首次加载成就图像或图像更改时，会发生此事件。

可以通过使用 侦听器 通过 steamworks.addEventListener() 函数将其添加到插件来接收这些事件。

需要注意的问题

• 如果你调用 steamworks.getAchievementImageInfo() 函数，它返回 nil，则 Steam 将自动异步获取成就图像——假设它给出了一个有效的成就名称——并分派此事件。

• 在应用启动时首次调用 steamworks.getAchievementImageInfo() 函数通常会返回 nil，但 Steam 客户端随后会缓存请求的成就图像，并在后续应用启动时立即使其可用，直到 Steam 客户端退出。也就是说，退出 Steam 客户端会清除其缓存的图像，迫使其重新下载在重新启动时成像。

属性

示例

local steamworks = require( "plugin.steamworks" )

-- Called when an achievement image has been changed/loaded
local function onAchievementImageUpdated( event )
    -- Fetch information about the achievement
    local achievementInfo = steamworks.getAchievementInfo( event.achievementName )

    -- Print the achievement's image info to the log
    print( "Achievement Image Updated" )
    print( "  Localized Name: " .. achievementInfo.localizedName )
    print( "  Is Unlocked Image: " .. tostring(event.unlocked) )
    print( "  Image Pixel Width: " .. tostring(event.imageInfo.pixelWidth) )
    print( "  Image Pixel Height: " .. tostring(event.imageInfo.pixelHeight) )
end

-- Set up a listener to be invoked when an achievement image has been changed/loaded
steamworks.addEventListener( "achievementImageUpdate", onAchievementImageUpdated )