Achievement (JSON)

Achievement 对象(版本 2)。

Achievement

Achievement 对象具有以下规范。 所有成员都是必需的。

成员 类型 说明
id 字符串 资源标识符。
serviceConfigId 字符串 此资源的 SCID。 标识与此成就相关的游戏。
名称 字符串 本地化的成就名称。
titleAssociations TitleAssociation 数组 TitleAssociation 数组。
progressState ProgressState 枚举 进度的状态:
  • invalid (0):成就进度处于未知状态。
  • achieved (1):成就已解除锁定。
  • inProgress (2):成就处于锁定状态,但用户已在解除锁定方面取得了进展。
  • notStarted (3):成就处于锁定状态,且用户在解除锁定方面未取得任何进展。
progression 进度 用户在成就方面的进度。
mediaAssets MediaAsset 阵列 与成就关联的媒体资产,如图像 ID。
platform 字符串 获得成就所在的平台。
isSecret 布尔值 成就是否为机密。
description 字符串 解除锁定时的成就描述。
lockedDescription 字符串 解除锁定前的成就描述。
productId 字符串 发布成就时使用的产品 ID。
achievementType AchievementType 枚举 成就类型(与传统成就的之前类型不同):
  • invalid (0):未知且不受支持的成就类型。
  • persistent (1):没有结束日期且随时可解除锁定的成就。
  • challenge (2):可在特定时间范围内解除锁定的成就。
participationType ParticipationType 枚举 成就的参与类型。 有效值为“个人”或“组”。
timeWindow TimeWindow 可对成就解除锁定的时间范围。 只适用于 challenge 类型的成就。
rewards Reward 数组 解除锁定时赢得的奖励集合。
estimatedTime TimeSpan 预计获得成就所要花费的时间。
deeplink 字符串 游戏的深层链接。
isRevoked 布尔值 是否强制撤消成就。

示例 JSON 语法

{
        "id":"3",
        "serviceConfigId":"b5dd9daf-0000-0000-0000-000000000000",
        "name":"Default NameString for Microsoft Achievements Sample Achievement 3",
        "titleAssociations":
        [{
                "name":"Microsoft Achievements Sample",
                "id":3051199919,
                "version":"abc"
        }],
        "progressState":"Achieved",
        "progression":
        {
          "requirements":
          [{
            "id":"12345678-1234-1234-1234-123456789012",
            "current":null,
            "target":"100"
          }],
          "timeUnlocked":"2013-01-17T03:19:00.3087016Z",
        },
        "mediaAssets":
        [{
                "name":"Icon Name",
                "type":"Icon",
                "url":"http://www.xbox.com"
        }],
        "platform":"D",
        "isSecret":true,
        "description":"Default DescriptionString for Microsoft Achievements Sample Achievement 3",
        "lockedDescription":"Default UnachievedString for Microsoft Achievements Sample Achievement 3",
        "productId":"12345678-1234-1234-1234-123456789012",
        "achievementType":"Challenge",
        "participationType":"Individual",
        "timeWindow":
        {
                "startDate":"2013-02-01T00:00:00Z",
                "endDate":"2100-07-01T00:00:00Z"
        },
        "rewards":
        [{
                "name":null,
                "description":null,
                "value":"10",
                "type":"Gamerscore",
                "valueType":"Int"
        },
        {
                "name":"Default Name for InAppReward for Microsoft Achievements Sample Achievement 3",
                "description":"Default Description for InAppReward for Microsoft Achievements Sample Achievement 3",
                "value":"1",
                "type":"InApp",
                "valueType":"String"
        }],
        "estimatedTime":"06:12:14",
        "deeplink":"aWFtYWRlZXBsaW5r",
        "isRevoked":false
    }

另请参阅

父级

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