ISteamUGC::StopPlaytimeTrackingForAllItems:停止所有项目的游戏时间跟踪

ISteamUGC::StopPlaytimeTrackingForAllItems:停止所有项目的游戏时间跟踪

StopPlaytimeTrackingForAllItems 用于结束当前应用中正在进行的所有工坊项目使用时间跟踪,适合退出游戏会话时调用。本页面向 Steamworks 游戏和工具开发者,说明接口声明、参数、返回方式以及与工坊内容生命周期相关的注意事项。

工坊内容获取与加载流程

函数声明

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

SteamAPICall_t StopPlaytimeTrackingForAllItems();

参数

此函数没有参数;它使用当前应用和当前 Steam 上下文。

返回值与完成方式

返回 SteamAPICall_t;通过 StopPlaytimeTrackingResult_t 检查异步操作的结果。此方法没有数组参数。

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

调用规则与排查

停止跟踪会为相关项目增加一次游戏时间会话计数;应用关闭时也会自动停止。官方页面出现关于数组指针及数量无效的说明,但该声明并无这些参数,不能直接用于此函数的参数验证;请以 SDK 定义为准。

使用场景

例如,游戏从内容使用会话返回主菜单且所有工坊内容均已退出使用时,可以统一停止全部跟踪。调用后应等待结果,再更新应用内部记录。应用关闭也会自动停止,但仍应根据真实使用边界管理跟踪,避免把无关的空闲时间算入使用时长。

相关接口

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

站内字段参考

StopPlaytimeTrackingResult_t。

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