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

# XBOX 服務遊戲儲存空間概觀

> 了解什麼是 XBOX 服務遊戲儲存空間、其功能、儲存類型與配額、節流限制，以及雲端遊戲資料支援的資料格式。

本主題說明什麼是 XBOX 服務遊戲儲存空間、它有哪些功能，並示範如何設定這些功能。
XBOX 服務遊戲儲存空間服務為大量每位玩家或每款遊戲的資料提供雲端儲存空間。您可以用它來儲存玩家統計資料與資產。在所有 XBOX 平台上執行的遊戲都可以使用遊戲儲存空間。

<a name="ID4EW" />

## XBOX 服務遊戲儲存空間的功能

XBOX 服務遊戲儲存空間包含下列高階功能。

* 可在玩家、遊戲與各種平台之間共用

* 支援 JSON、二進位與設定檔

<a name="ID4ETB" />

## 儲存類型

| 儲存類型 | 配額 (受管理合作夥伴) | 配額 (Creators Program) | 用途 | 平台 | 玩家 |
| - | - | - | - | - | - |
| Trusted Platform | 每位玩家 256 MB | 每位玩家 64 MB | 每位玩家的資料，例如遊戲存檔，或用於遊玩/暫停/繼續的遊戲狀態。較安全，但有平台限制。 | 任何平台皆可讀取，但只有 XBOX One 系列 (或更新版本)、XBOX 360 或 Windows Phone 可以寫入。 | 可設定為公開或僅限擁有者。 |
| Universal Platform | 每位玩家 64 MB | 每位玩家 64 MB | 每位玩家的資料，例如遊戲存檔，或用於遊玩/暫停/繼續的遊戲狀態。 | 任何平台皆可讀取或寫入。 | 可設定為公開或僅限擁有者。 |
| Global | 256 MB | 256 MB | 每個人都可以讀取的資料，例如名單、地圖、挑戰或美術資源。 | 只能透過 XBOX Developer Portal 或 Partner Center 寫入，任何平台皆可讀取。 | 所有玩家皆可讀取。 |

## 節流限制

遊戲每分鐘可進行的讀取與寫入次數沒有限制，但在每個一小時的工作階段中，平均每分鐘一般不能超過一次。例如，遊戲可以在工作階段開始時進行 60 次讀取或寫入，但在該小時的剩餘時間內就不能再進行。遊戲應做好防護，以因應 XBOX 服務需要節流要求時稍後無法再發出更多呼叫的情況。

<Note>如果您的遊戲有特殊的分割需求 (例如額外的讀取或寫入)，請聯絡您的 Microsoft 代表。</Note>

<a name="ID4ECF" />

## 資料類型

本節說明三種支援的類型。

* [二進位資訊](#ID4ENF)
* [JSON 資訊](#ID4EUF)
* [設定資訊](#ID4ECAAC)

<a name="ID4ENF" />

#### 二進位資訊

二進位資訊包括影像、聲音與自訂資料等。由於資料必須透過 HTTP 傳輸，因此二進位資料必須編碼為 HTTP 接受的字元。例如，您可以將資料轉換為十六進位字串，或使用 base64 編碼。遊戲儲存空間不會處理已編碼的資料，因此您的遊戲在讀取與寫入遊戲儲存空間時，必須使用相同的配置來編碼與解碼資料。

<a name="ID4EUF" />

#### JSON 資訊

JSON 資訊包括結構化資料 (索引鍵/值組)。您可以在支援 JSON 物件的語言 (例如 JavaScript) 中使用它們。從 JSON 檔案擷取資料時，遊戲可以提供 `selectQuery` 參數，以傳回結構中的特定項目。例如，您可以使用包含下列資訊的 JSON 檔案。

```json theme={null}
{
"difficulty" : 1,
"level" :
    [
        { "number" : "1", "quest" : "swords" },
        { "number" : "2", "quest" : "iron" },
        { "number" : "3", "quest" : "gold" },
        { "number" : "4", "quest" : "queen" }
        ],
"weapon" :
    {
            "name" : "poison",
            "timeleft" : "2mins"
    }
}
```

<Note>基於安全性考量，JSON 資料的第一個元素不得為陣列。服務會拒絕根層級為陣列的 JSON 資料。</Note>

您的遊戲可以選取 JSON 結構的部分內容作為 `selectQuery` (例如 `weapon.name`)，然後會收到下列內容：

```json theme={null}
{
    "name" : "poison"
}
```

<a name="ID4ECAAC" />

#### 設定資訊

設定 Blob 是儲存在全域遊戲儲存空間中的資料結構。設定 Blob 的格式類似於 JSON 物件。設定 Blob 可以包含虛擬節點，從可能的選項清單中傳回一個設定。虛擬節點適合用來為特定情況 (例如特定遊戲或地區設定) 提供設定。虛擬節點包含數個可能的設定，以及值和從這些值中選取的條件。在下列範例中，`defaultCardDesign` 設定可以是虛擬節點中的其中一個值。

```json theme={null}
{
    "defaultCardDesign":
    {
    "_virtualNode":
    {
        "_selectBy":"titleId",
        "_sourceNodes":
        [
        {"_selector":"123456799", "_data":"RobotUnicornCard.png,binary"},
        {"_selector":"default", "_data":"StandardCard.png,binary"}
        ]
    }
    },
}
```

當遊戲讀取此檔案時，系統會從 `\_sourceNodes` 陣列中選取其中一個值。在此案例中，項目是根據遊戲的遊戲 ID 選取的。例如，玩遊戲 `12456799` 的玩家會看到下列內容：

```json theme={null}
{
    "defaultCardDesign":"RobotUnicornCard.png,binary",
    "_sourceNodes":["defaultCardDesign:titleID:1234567899"]
}
```

未玩該遊戲的玩家會看到下列內容：

```json theme={null}
{
    "defaultCardDesign":"StandardCard.png,binary",
    "_sourceNodes":["defaultCardDesign:titleID:default"]
}
```

遊戲可以定義與要求中參數相符的自訂選取器。例如，請參考此設定 Blob 中的下列 JSON 物件。

```json theme={null}
{
    "defaultCardDesign":
    {
        "_virtualNode":
        {
            "_selectBy":"custom:gameMode",
            "_sourceNodes":
            [
                {"_selector":"silly", "_data":"RobotUnicornCard.png,binary"},
                {"_selector":"serious", "_data":"SeriousCard.png,binary"},
                {"_selector":"default", "_data":"StandardCard.png,binary"}
                ]
        }
    },
    "backgroundColor":"green",
    "dealerHitsOnSoft17":true
}
```

遊戲會在 `customSelector` 參數中傳遞字串，以選取要傳回的項目。例如，若要取得第二個選項，遊戲會以 `gameMode.serious` 作為 `selectQuery` 發出要求。

<a name="ID4E5EAC" />

## 開始使用 XBOX 服務遊戲儲存空間

1. 決定您要儲存哪種資料。範例包括遊戲存檔、遊戲狀態、每日挑戰、遊戲地圖與美術資源。

2. 決定哪些遊戲與平台需要存取該資料。遊戲儲存空間支援從單一平台上的單一遊戲，以及從多個平台上的多個遊戲存取雲端資料。


## Related topics

- [遊戲儲存空間](/zh-TW/services/xbox-services/storage/title-storage/live-title-storage-nav.md)
- [取得遊戲儲存空間服務設定的配額資訊](/zh-TW/services/xbox-services/storage/title-storage/how-to/live-getting-title-storage-quota-info.md)
- [遊戲儲存空間範例程式碼](/zh-TW/services/xbox-services/storage/title-storage/how-to/live-title-storage-howto-nav.md)
- [從遊戲儲存空間下載 Blob](/zh-TW/services/xbox-services/storage/title-storage/how-to/live-downloading-title-storage-blob.md)
- [從遊戲儲存空間刪除 Blob](/zh-TW/services/xbox-services/storage/title-storage/how-to/live-deleting-title-storage-blob.md)