值類型

代表遊戲服務資料的不可變更值類型。

摘要

管理員上的存取子方法會以 <status, valuetype=""> 配對提供結果，可以是非同步 (透過回呼) 或同步 (若為封鎖存取子)。</status,>

值類型物件可以是有效值 (代表有效值) 或無效。如果傳回的狀態和值類型物件 IsSuccess()，則相關聯的值一律會有效；如果 IsError() 狀態，則相關聯的值一律無效。您可以透過每個值類型物件的 Valid() 方法直接測試有效性。無效值類型物件的 Valid() 以外的呼叫方法均有誤，應避免使用。

值類型物件不可變更，並且反映了提供物件存取子當時基礎資料的一致的檢視畫面。

值類型物件是可移動且有效率地複製。

值類型物件的屬性如果複雜或耗費太多時間，系統就會透過參照傳回。傳回的參照生命週期僅限於值類型物件的生命週期。

可使用輔助方法，將值類型物件轉換為偵錯字串，或將字串輸出至偵錯串流。這些方法提供的人類可讀形式表示法僅供記錄和偵錯用途，不應視為穩定。

類別
gpg：成就	單一資料結構可讓您存取特定關卡的狀態相關資料。
gpg::事件	包含特定事件狀態相關資料的單一資料結構。
gpg::排行榜	單一資料結構可讓您存取特定排行榜的狀態資料，例如名稱和有效性。
gpg：Multiplayer 邀請	資料結構包含回合製對戰邀請的目前狀態相關資料。
gpg：多人對戰遊戲參與者	包含多人對戰遊戲參與者資料的資料結構。
gpg::ParticipantResults	包含 TurnBasedMatch 每位參與者結果的資料結構。
gpg::Player	一種資料結構，可讓您存取特定玩家的相關資料。
gpg::PlayerLevel	單一資料結構包含玩家關卡資料，
gpg::PlayerStats	一種資料結構，可讓您存取特定玩家的相關資料。
gpg：RealTimeRoom	包含即時多人遊戲會議室目前狀態的資料結構。
gpg::RealTimeRoomConfig	包含建立 RealTimeRoom 物件所需資料的資料結構。
gpg:: 分數	單一資料結構可讓您存取玩家分數相關資料。
gpg：ScorePage	單一資料結構可讓您存取分數資料。
gpg::ScorePage::Entry	可在得分頁面上建立項目的類別。
gpg::ScorePage::ScorePageToken	近乎不透明類型的資料結構，代表 ScorePage 的查詢 (或空白)。
gpg：ScoreSummary	單一資料結構可讓您存取分數資訊的摘要，
gpg::SnapshotMetadata	單一資料結構，可讓您存取特定快照中繼資料的狀態相關資料。
gpg::SnapshotMetadata 變更	單一資料結構可讓您存取特定快照狀態的相關資料。
gpg::SnapshotMetadataChange::CoverImage	單一資料結構，可讓您存取特定封面圖片的狀態資料。
gpg：TurnBasedMatch	包含 TurnBasedMatch 目前狀態相關資料的資料結構。
gpg::TurnBasedMatchConfig	資料結構包含建立 TurnBasedMatch 所需的資料。