PresenceRecord (JSON)

有关单个用户在线状态的数据。

PresenceRecord

PresenceRecord 对象具有以下规范。

成员	类型	说明
xuid	字符串	目标用户的 Xbox 用户 ID (XUID)。 所提供的状态数据针对此用户。
设备	DeviceRecord 的数组	用户的设备记录的列表。
state	字符串	用户在 Xbox LIVE 上的活动。 可能值： 在线：用户至少有一个设备记录。 离开：用户已登录到 Xbox LIVE，但未在任何一个游戏中处于活动状态。 离线：用户不在任何设备上。
lastSeen	LastSeenRecord	最后看到的信息仅在用户没有有效的 DeviceRecord 时可用。 如果对象被从缓存中删除，其数据可能不会返回，因为没有持久存储。

示例 JSON 语法

{
  xuid:"0123456789",
  state:"online",
  devices:
  [{
    type:"D",
    titles:
    [{
      id:"12341234",
      name:"Contoso 5",
      state:"active",
      placement:"fill",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Team Deathmatch on Nirvana"
      }
    },
    {
      id:"12341235",
      name:"Contoso Waypoint",
      timestamp:"2012-09-17T07:15:23.4930000",
      placement:"snapped",
      state:"active",
      activity:
      {
        richPresence:"Using radar"
      }
    }]
  },
  {
    type:"W8",
    titles:
    [{
      id:"23452345",
      name:"Contoso Gamehelp",
      state:"active",
      placement:"full",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Nirvana page"
      }
    }]
  }]
}

另请参阅

父级

JavaScript 对象表示法 (JSON) 对象参考

参考

POST (/users/batch)

获取 (/users/me)

DELETE (/users/xuid({xuid})/devices/current/titles/current)

GET (/users/xuid({xuid}))