> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblAchievementReward

> XblAchievementReward

# XblAchievementReward

代表與成就相關聯的獎勵。

## 語法

```cpp theme={null}
typedef struct XblAchievementReward {  
    const char* name;  
    const char* description;  
    const char* value;  
    XblAchievementRewardType rewardType;  
    const char* valueType;  
    XblAchievementMediaAsset* mediaAsset;  
} XblAchievementReward  
```

### 成員

*name*\
類型：const char\*

UTF-8 編碼的當地語系化獎勵名稱。

*description*\
類型：const char\*

獎勵的 UTF-8 編碼描述。

*value*\
類型：const char\*

由遊戲定義的 UTF-8 編碼獎勵值 (資料類型和內容依獎勵類型而異)。

*rewardType*\
類型：[XblAchievementRewardType](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementrewardtype.md)

獎勵類型。

*valueType*\
類型：const char\*

獎勵值字串的 UTF-8 編碼屬性類型。

*mediaAsset*\
類型：[XblAchievementMediaAsset\*](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset.md)

與獎勵相關聯的媒體資產。如果獎勵類型為 gamerscore，此值會是 nullptr。如果獎勵類型為 in\_app，此值會是媒體資產。如果獎勵類型為 art，此值可能是媒體資產或 nullptr。

## 隸屬於

[XblAchievement](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievement.md)

## 需求

**標頭：** achievements\_c.h

## 另請參閱

[achievements\_c](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/achievements_c_members.md)


## Related topics

- [XblAchievementRewardType](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementrewardtype.md)
- [XblAchievementMediaAsset](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset.md)
- [achievements_c](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/achievements_c_members.md)
- [XblAchievement](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievement.md)
- [Achievement (JSON)](https://docs.xbox.com/zh-TW/reference/live/rest/json/json-achievementv2.md)