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 日。