Loại giá trị

Các loại giá trị bất biến biểu thị dữ liệu Dịch vụ trò chơi.

Tóm tắt

Các phương thức truy cập trên Trình quản lý cung cấp kết quả dưới dạng một cặp <status, valuetype="">, không đồng bộ (qua lệnh gọi lại) hoặc đồng bộ (trong trường hợp trình truy cập chặn).</status,>

Các đối tượng loại giá trị có thể hợp lệ (thể hiện giá trị hợp lệ) hoặc không hợp lệ. Nếu trạng thái được trả về cùng với đối tượng loại giá trị IsSuccess(), thì giá trị được liên kết sẽ luôn hợp lệ; nếu trạng thái IsError(), thì giá trị được liên kết sẽ luôn không hợp lệ. Bạn có thể kiểm tra trực tiếp tính hợp lệ thông qua phương thứcValid() trên từng đối tượng loại giá trị. Các phương thức gọi không phải là Invalid() của đối tượng loại giá trị không hợp lệ là một lỗi và nên tránh.

Các đối tượng loại giá trị là không thể thay đổi và phản ánh chế độ xem nhất quán của dữ liệu cơ bản tại thời điểm trình truy cập đã cung cấp các đối tượng này được gọi.

Đối tượng loại giá trị có thể di chuyển và sao chép một cách hiệu quả.

Thuộc tính của các đối tượng loại giá trị phức tạp hoặc tốn kém chi phí sao chép sẽ được trả về qua tham chiếu. Thời gian tồn tại của tham chiếu được trả về bị giới hạn trong toàn thời gian của đối tượng loại giá trị.

Có các phương thức trợ giúp để chuyển đổi đối tượng loại giá trị thành chuỗi gỡ lỗi hoặc xuất chúng sang luồng gỡ lỗi. Các phần biểu diễn mà con người có thể đọc được do các phương thức này cung cấp chỉ dùng cho mục đích ghi nhật ký và gỡ lỗi và không được coi là ổn định.

Lớp
gpg::Thành tích	Một cấu trúc dữ liệu duy nhất cho phép bạn truy cập dữ liệu về trạng thái của một thành tích cụ thể.
gpg::Sự kiện	Một cấu trúc dữ liệu duy nhất chứa dữ liệu về trạng thái của một sự kiện cụ thể.
gpg::Bảng xếp hạng	Một cấu trúc dữ liệu duy nhất cho phép bạn truy cập dữ liệu về trạng thái của một bảng xếp hạng cụ thể, chẳng hạn như tên và tính hợp lệ của bảng xếp hạng đó.
gpg::MultiplayerInvitation	Cấu trúc dữ liệu chứa dữ liệu về trạng thái hiện tại của lời mời tham gia so khớp theo lượt.
gpg::MultiplayerParticipant	Cấu trúc dữ liệu chứa dữ liệu về người tham gia trong một trận đấu nhiều người chơi.
gpg::ParticipantResults	Cấu trúc dữ liệu chứa dữ liệu về kết quả của mỗi người tham gia trong TurnBasedMatch.
gpg::Người chơi	Cấu trúc dữ liệu cho phép bạn truy cập vào dữ liệu về một người chơi cụ thể.
gpg::PlayerLevel	Một cấu trúc dữ liệu duy nhất chứa dữ liệu về cấp độ của người chơi.
gpg::PlayerStats	Cấu trúc dữ liệu cho phép bạn truy cập vào dữ liệu về một người chơi cụ thể.
gpg::RealTimeRoom	Cấu trúc dữ liệu chứa trạng thái hiện tại của phòng nhiều người chơi theo thời gian thực.
gpg::RealTimeRoomConfig	Cấu trúc dữ liệu chứa dữ liệu cần thiết để tạo đối tượng RealTimeRoom.
gpg::Điểm số	Một cấu trúc dữ liệu đơn lẻ cho phép bạn xem dữ liệu về điểm số của người chơi.
gpg::ScorePage	Một cấu trúc dữ liệu duy nhất cho phép bạn truy cập vào dữ liệu điểm số.
gpg::ScorePage::Entry	Một lớp học tạo một mục nhập trên trang điểm.
gpg::ScorePage::ScorePageToken	Cấu trúc dữ liệu là một loại gần như không rõ ràng đại diện cho một truy vấn cho một ScorePage (hoặc trống).
gpg::ScoreSummary	Một cấu trúc dữ liệu duy nhất cho phép bạn xem bản tóm tắt thông tin về điểm số.
gpg::SnapshotMetadata	Một cấu trúc dữ liệu duy nhất cho phép bạn truy cập dữ liệu về trạng thái của một siêu dữ liệu tổng quan nhanh cụ thể.
gpg::SnapshotMetadataChange	Một cấu trúc dữ liệu đơn lẻ cho phép bạn truy cập vào dữ liệu về trạng thái của một ảnh chụp nhanh cụ thể.
gpg::SnapshotMetadataChange::CoverImage	Một cấu trúc dữ liệu đơn lẻ cho phép bạn truy cập vào dữ liệu về trạng thái của một ảnh bìa cụ thể.
gpg::TurnBasedMatch	Cấu trúc dữ liệu chứa dữ liệu về trạng thái hiện tại của TurnBasedMatch.
gpg::TurnBasedMatchConfig	Cấu trúc dữ liệu chứa dữ liệu cần thiết để tạo TurnBasedMatch.