ISteamUGC::StopPlaytimeTracking：停止跟踪指定项目

StopPlaytimeTracking 用于当一组工坊内容不再参与游戏时，停止其游戏时间跟踪。本页面向 Steamworks 游戏和工具开发者，说明接口声明、参数、返回方式以及与工坊内容生命周期相关的注意事项。

函数声明

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

SteamAPICall_t StopPlaytimeTracking( PublishedFileId_t *pvecPublishedFileID, uint32 unNumPublishedFileIDs );

参数

返回值与完成方式

返回 SteamAPICall_t；使用 StopPlaytimeTrackingResult_t 检查操作结果。每次输入的项目数组最多 100 项。

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

调用规则与排查

提供要停止的项目 ID 及对应数量。停止跟踪会使相应项目的游戏时间会话计数增加；应用关闭时也会停止跟踪。若需一次结束所有项目的跟踪，可使用 StopPlaytimeTrackingForAllItems。

使用场景

例如，一局游戏结束时，可以收集本局实际使用且仍在跟踪的项目 ID，调用此方法停止并等待结果。若还有其他内容继续参与下一局，不必把它们与已退出使用的内容混为一组；关闭整个应用时 Steam 也会自动结束跟踪。

相关接口

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

站内字段参考

StopPlaytimeTrackingResult_t。

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