ISteamUGC::SetSubscriptionsLoadOrder:设置订阅项目加载顺序

ISteamUGC::SetSubscriptionsLoadOrder:设置订阅项目加载顺序

SetSubscriptionsLoadOrder 用于为指定订阅项目设置本地顺序,帮助游戏提供可调整的 Mod 列表。本页面向 Steamworks 游戏和工具开发者,说明接口声明、参数、返回方式以及与工坊内容生命周期相关的注意事项。

工坊内容获取与加载流程

函数声明

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

bool SetSubscriptionsLoadOrder( PublishedFileId_t *pvecPublishedFileIDs, uint32 unNumPublishedFileIDs );

参数

参数 类型 方向与含义
pvecPublishedFileIDs PublishedFileId_t * 输入:包含要设置的项目 ID 的数组。
unNumPublishedFileIDs uint32 输入:ID 数组中的元素数量。

返回值与完成方式

返回 bool;true 表示设置成功。输入的项目 ID 数组顺序用于指定加载顺序。

调用规则与排查

未出现在提供列表中的项目按订阅时间排序。该顺序是本地设置,游戏仍需要自己检测依赖和冲突,不能假设排序自动解决内容兼容性。设置后通过 GetSubscribedItems 重新获取显示顺序。

使用场景

例如,玩家调整两个已订阅 Mod 的先后顺序后,游戏可以按界面中的顺序构造 ID 数组并提交。提交成功后再次枚举项目,核对显示顺序;对于没有包含在数组里的其他项目,应考虑它们仍会按订阅时间排列。加载冲突需要游戏另行处理。

相关接口

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

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