如何使用.Net C#获取PS4/PS5、Xbox等游戏主机游玩时长

Xbox 系列（Xbox One/Series X/S）对接方案 #

• 优先走微软官方Xbox Live公开API，合规性最高，不会出现接口随意失效的问题。先在Azure门户注册自己的应用，拿到ClientId、ClientSecret，配置好XboxLive.signin、XboxLive.offline_access两个权限范围即可。
• .NET 侧直接引入官方Microsoft.Graph包，配合Xbox Live的REST端点调用即可，用户走OAuth2.0流程授权登录自己的Xbox账号后，就能直接拉取账号关联的所有Xbox设备的游玩记录：包含每个游戏的累计游玩时长、最近启动时间、对应成就解锁的时间节点，返回的时长数据精确到分钟。
• 注意点：如果用户把Xbox游玩记录隐私设置为仅好友可见/私密，必须引导用户调整权限，否则接口会返回空数据；本地存授权令牌的时候建议用IDistributedCache持久化刷新令牌，避免每次启动应用都要用户重新登录授权。

PlayStation 系列（PS4/PS5）对接方案 #

索尼没有面向普通个人开发者开放公开的PSN游玩数据API，分三类方案可选：

• 方案一（合规商用优先）：申请加入PlayStation Partners开发者计划，提交应用资质走官方审核，过审后就能拿到正式PSN API的调用权限，授权逻辑和Xbox类似，用户登录自己的PSN账号后就能拉取全量历史游玩时长、奖杯数据。缺点是审核门槛不低，纯个人开发者申请通过率不高，接口还有调用频次限制。
• 方案二（个人自用/小范围工具适用）：调用社区逆向维护的PSN私有接口，.NET 侧直接用HttpClient构造请求即可，流程是先模拟账号登录拿认证令牌，再调用游玩历史端点拉取数据，返回字段包含每个游戏的总游玩时长、最近游玩时间，还能拆分统计PS4、PS5端分别的游玩时长。我自己写个人小工具的时候用过这个方案，拉取个人账号数据基本不会触发风控，缺点是没有官方合规背书，一旦索尼调整接口签名、升级风控规则，接口随时可能失效，绝对不适合拿来做大规模公网商用的应用。
• 无授权备选方案：如果不想走账号授权逻辑，可以引导用户在主机设置里开启局域网游玩状态广播，.NET 端写个UDP监听服务，同一局域网下捕获主机广播的状态包，解析当前运行的游戏ID、运行状态，本地累计计算游玩时长。这个方案完全不需要账号权限，缺点是只能统计主机和应用在同一局域网、且主机开机运行期间的数据，没法拉取历史累计时长。

.NET 侧通用实现注意事项 #

• 所有平台的API调用逻辑统一封装，用IHttpClientFactory创建HTTP客户端，配合Polly配置指数退避重试、熔断策略，处理接口限流、超时、临时不可用的问题，不要每次请求都new一个HttpClient。
• 本地用SQLite存一份游戏ID和游戏名称的映射缓存，不要每次拉取到游戏ID都调用接口查名称，尽可能减少API调用次数，降低触发平台风控的概率。
• 时长统计做双重校验：每次拉取到平台返回的累计时长后，和本地上次存储的该游戏时长做差值比对，如果差值异常（比如突然比上次记录少了几个小时，或者一次性跳涨几十上百小时）就打日志标记，避免平台统计口径调整导致本地统计数据错乱。
• 提前做统一数据模型抽象，不管是Xbox还是PS返回的原始数据，都映射到统一的PlayRecord实体，固定包含GameId、GameName、PlatformEnum、TotalPlayedMinutes、LastPlayTime这些核心字段，后续做统计报表、数据导出功能的时候不用针对每个平台单独写逻辑。

内容的提问来源于stack exchange，提问作者Anass Hadeg