> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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](/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementrewardtype)

獎勵類型。

*valueType*\
類型：const char\*

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

*mediaAsset*\
類型：[XblAchievementMediaAsset\*](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset)

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

## 隸屬於

[XblAchievement](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievement)

## 需求

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

## 另請參閱

[achievements\_c](/zh-TW/reference/live/xsapi-c/achievements_c/achievements_c_members)


## Related topics

- [XblAchievementRewardType](/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementrewardtype.md)
- [XblAchievementMediaAsset](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset.md)
- [XblAchievement](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievement.md)
- [Reward Ad Activity](/api-reference/advertising/reward-ad-activity.md)
- [XblAchievementsResultGetAchievements](/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements.md)