ISteamUGC::RemoveItemFromFavorites：移除收藏项目

RemoveItemFromFavorites 用于将指定项目从当前用户的收藏中移除，适合游戏内收藏管理。本页面向 Steamworks 游戏和工具开发者，说明接口声明、参数、返回方式以及与工坊内容生命周期相关的注意事项。

函数声明

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

SteamAPICall_t RemoveItemFromFavorites( AppId_t nAppId, PublishedFileId_t nPublishedFileID );

参数

返回值与完成方式

返回 SteamAPICall_t；使用 UserFavoriteItemsListChanged_t 获取最终结果和移除标记。

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

调用规则与排查

传入项目所属应用的 App ID 和项目 ID，结果回调到达前应把界面显示为处理中。收藏状态与订阅状态是不同概念，移除收藏不代表取消订阅。

使用场景

例如，收藏列表允许玩家移除一个条目时，可先保留原有列表直到结果返回。检查结果及目标项目后再刷新界面；如果操作没有成功，应向玩家说明并允许其继续使用列表。订阅和下载由其他接口管理，收藏操作不会替代安装状态检查。

相关接口

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

站内字段参考

UserFavoriteItemsListChanged_t。

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