> ## 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.

# XStorePrice

> XStorePrice

# XStorePrice

商店價格資訊。

## 語法

```cpp theme={null}
typedef struct XStorePrice {  
    float basePrice;  
    float price;  
    float recurrencePrice;  
    const char* currencyCode;  
    char formattedBasePrice[PRICE_MAX_SIZE];  
    char formattedPrice[PRICE_MAX_SIZE];  
    char formattedRecurrencePrice[PRICE_MAX_SIZE];  
    bool isOnSale;  
    time_t saleEndDate;  
} XStorePrice  
```

### 成員

*basePrice*\
類型：float

產品的一般非促銷價格或建議零售價 (MSRP)。

*price*\
類型：float

使用者購買此項目時實際支付的價格。

*recurrencePrice*\
類型：float

週期性價格。

*currencyCode*\
類型：const char\*

價格的貨幣代碼。

*formattedBasePrice*\
類型：char\[PRICE\_MAX\_SIZE]

可在遊戲 UI 中顯示的格式化 basePrice。

*formattedPrice*\
類型：char\[PRICE\_MAX\_SIZE]

應在您的 UI 中用來宣傳產品的格式化價格。

*formattedRecurrencePrice*\
類型：char\[PRICE\_MAX\_SIZE]

格式化的週期性價格。

*isOnSale*\
類型：bool

指出產品是否正在特價。

*saleEndDate*\
類型：time\_t

特價的結束日期。

## 備註

*basePrice* 不一定是應該宣傳的價格。您一律應在 UI 中宣傳 price 變數中的值，而不是 basePrice 變數中的值。您可以使用 basePrice 變數來判斷特價期間提供多少折扣。接著，您可以在 UI 中的 price 變數旁邊，以刪除線文字顯示 basePrice，協助使用者了解價值和節省的金額。

**XStorePrice** 是 [XStoreAvailability](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoreavailability.md) 結構的成員。**XStorePrice** 是 [XStoreProduct](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoreproduct.md) 結構的成員。**XStorePrice** 是 [XStoreSku](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoresku.md) 結構的成員。

## 需求

**標頭：** XStore.h (包含在 XGameRuntime.h 中)

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XStore](https://docs.xbox.com/zh-TW/reference/system/xstore/xstore_members.md)\
[XStoreAvailability](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoreavailability.md)\
[XStoreProduct](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoreproduct.md)\
[XStoreSku](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoresku.md)


## Related topics

- [XStoreAvailability](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoreavailability.md)
- [XStore (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xstore/xstore_members.md)
- [XStoreSku](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoresku.md)
- [XStoreProduct](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoreproduct.md)
- [PFCatalogRealMoneyPriceDetails](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfcatalogtypes/structs/pfcatalogrealmoneypricedetails.md)