ISteamUGC::SetUserItemVote：提交项目投票

SetUserItemVote 用于让当前用户对指定工坊项目提交赞或踩，适用于游戏中的项目评价界面。本页面向 Steamworks 游戏和工具开发者，说明接口声明、参数、返回方式以及与工坊内容生命周期相关的注意事项。

函数声明

客户端通过初始化成功后的 SteamUGC() 接口访问；游戏服务器使用服务器上下文的 SteamGameServerUGC()。以下声明按本次核对的官方接口整理，编译时应以项目实际使用的 SDK 头文件为准。

SteamAPICall_t SetUserItemVote( PublishedFileId_t nPublishedFileID, bool bVoteUp );

参数

返回值与完成方式

返回 SteamAPICall_t；通过 SetUserItemVoteResult_t 检查结果、项目及投票方向。

调用结果由 Steam 异步交付。应在对象有效期间保存对应的结果处理器，并持续运行 Steam 回调；还要区分传输失败与结果结构中的操作失败。

调用规则与排查

bVoteUp 为 true 表示赞，false 表示踩。界面可以暂时显示正在提交，确认调用结果后再更新投票状态；如果需要重读当前用户的选择，可调用 GetUserItemVote。

使用场景

例如，玩家在工坊详情中点击赞后，游戏发起投票并显示处理中。收到结果后确认目标项目与操作结果，再更新按钮状态；失败时保留重试入口。如果玩家在等待期间打开另一条内容，应避免将先前项目的结果应用到新页面。

相关接口

GetUserItemVote。回调、状态与类型参考整理了相关结构体和枚举，适合在处理结果时对照使用。

站内字段参考

SetUserItemVoteResult_t。

资料依据：Steamworks ISteamUGC：SetUserItemVote。资料核对日期：2026 年 11 月 4 日。