ISteamUGC::AddItemToFavorites：将项目加入收藏

AddItemToFavorites 用于把指定应用的一个项目加入当前用户的收藏列表，适用于游戏内内容浏览器。本页面向 Steamworks 游戏和工具开发者，说明接口声明、参数、返回方式以及与工坊内容生命周期相关的注意事项。

函数声明

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

SteamAPICall_t AddItemToFavorites( AppId_t nAppId, PublishedFileId_t nPublishedFileID );

参数

返回值与完成方式

返回 SteamAPICall_t；通过 UserFavoriteItemsListChanged_t 读取操作结果及添加或移除标记。拿到句柄只表示异步请求已发出，最终状态以调用结果为准。

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

调用规则与排查

应用 ID 应与项目所属应用对应，项目 ID 应来自已确认的内容。界面可在结果成功后刷新收藏状态；如果操作失败，应保留用户当前界面并显示错误。

使用场景

例如，玩家在游戏内浏览项目并选择收藏后，界面可以先保持处理状态。调用结果到达时，先确认结果对应此次操作，再刷新该项目的收藏显示；失败时保留操作入口，让玩家按提示决定是否重试。收藏只是帮助用户以后找到项目，安装与否仍需另外查询。

相关接口

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

站内字段参考

UserFavoriteItemsListChanged_t。

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