Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
gpg::TurnBasedMatchConfig::Builder
#include <turn_based_match_config_builder.h>
Tạo một hoặc nhiều đối tượng TurnBasedMatchConfig.
Tóm tắt
Hàm công khai
AddAllPlayersToInvite
Builder & AddAllPlayersToInvite(
const std::vector< std::string > & player_ids
)
Thêm nhiều người chơi vào danh sách người chơi để mời tham gia trận đấu.
Theo mặc định, không có người chơi nào được thêm vào.
AddPlayerToInvite
Builder & AddPlayerToInvite(
const std::string & player_id
)
Thêm người chơi vào danh sách người chơi để mời tham gia trận đấu.
Theo mặc định, không có người chơi nào được thêm vào trận đấu. Trình tạo không thể tạo trận đấu cho đến khi người chơi được thêm vào.
Trình tạo
Builder()
PopulateFromPlayerSelectUIResponse
Builder & PopulateFromPlayerSelectUIResponse(
const TurnBasedMultiplayerManager::PlayerSelectUIResponse & response
)
Điền các giá trị từ TurnBasedMultiplayerManager::ShowPlayerSelectUIResponse.
Xin lưu ý rằng thao tác này không điền biến thể hoặc mặt nạ bit độc quyền.
SetExclusiveBitMask
Builder & SetExclusiveBitMask(
uint64_t exclusive_bit_mask
)
Một mặt nạ bit cho biết vai trò độc quyền của người chơi.
(Ví dụ: Nếu một người chơi là kẻ tấn công, thì người còn lại phải là người bảo vệ.) Để tự động ghép nối thành công, tích logic (AND) của mặt nạ bit của bất kỳ trình phát ghép nối nào cũng bằng 0. Giá trị mặc định là: 0
SetMaximumAutomatchingPlayers
Builder & SetMaximumAutomatchingPlayers(
uint32_t maximum_automatching_players
)
Số người chơi được tự động kết hợp tối đa có thể tham gia trận đấu.
Nếu không chỉ định, giá trị mặc định sẽ bằng với số người chơi tự động ghép đôi tối thiểu.
SetMinimumAutomatchingPlayers
Builder & SetMinimumAutomatchingPlayers(
uint32_t minimum_automatching_players
)
Số người chơi được tự động ghép tối thiểu có thể tham gia trận đấu.
Giá trị mặc định là 0 khi không chỉ định. Bạn phải thêm ít nhất một người chơi hoặc mã nhận dạng người chơi tự động so khớp.
SetVariant
Builder & SetVariant(
uint32_t variant
)
Giá trị dành riêng cho nhà phát triển được dùng để biểu thị kiểu hoặc chế độ so khớp.
Chỉ những người chơi sử dụng cùng một biến thể mới có thể tự động so khớp. Giá trị mặc định là -1 khi bạn không chỉ định.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],null,["# gpg::TurnBasedMatchConfig::Builder Class Reference\n\ngpg::TurnBasedMatchConfig::Builder\n==================================\n\n`#include \u003cturn_based_match_config_builder.h\u003e`\n\nBuilds one or more [TurnBasedMatchConfig](/games/services/cpp/api/class/gpg/turn-based-match-config#classgpg_1_1_turn_based_match_config) objects.\n\nSummary\n-------\n\n| ### Constructors and Destructors ||\n|---|---|\n| [Builder](#classgpg_1_1_turn_based_match_config_1_1_builder_1affc108da6d6df5b6b93a430eb1cdce62)`()` ||\n\n| ### Public functions ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [AddAllPlayersToInvite](#classgpg_1_1_turn_based_match_config_1_1_builder_1a1cc8b2b8ed3c4f61c73693a2deb3d5b8)`(const std::vector\u003c std::string \u003e & player_ids)` | [Builder](/games/services/cpp/api/class/gpg/turn-based-match-config/builder#classgpg_1_1_turn_based_match_config_1_1_builder)` &` Adds multiple players to the list of players to invite to the match. |\n| [AddPlayerToInvite](#classgpg_1_1_turn_based_match_config_1_1_builder_1af1d5ed0388dd5b7ad55981ba2cd9bba8)`(const std::string & player_id)` | [Builder](/games/services/cpp/api/class/gpg/turn-based-match-config/builder#classgpg_1_1_turn_based_match_config_1_1_builder)` &` Adds a player to the list of players to invite to the match. |\n| [Create](#classgpg_1_1_turn_based_match_config_1_1_builder_1af2aee232c43b6812e1698009623e5e0d)`() const ` | [TurnBasedMatchConfig](/games/services/cpp/api/class/gpg/turn-based-match-config#classgpg_1_1_turn_based_match_config) Creates a [TurnBasedMatchConfig](/games/services/cpp/api/class/gpg/turn-based-match-config#classgpg_1_1_turn_based_match_config) object. |\n| [PopulateFromPlayerSelectUIResponse](#classgpg_1_1_turn_based_match_config_1_1_builder_1a536f6294640adcece2ffe2fda600bdf7)`(const `[TurnBasedMultiplayerManager::PlayerSelectUIResponse](/games/services/cpp/api/struct/gpg/turn-based-multiplayer-manager/player-select-u-i-response#structgpg_1_1_turn_based_multiplayer_manager_1_1_player_select_u_i_response)` & response)` | [Builder](/games/services/cpp/api/class/gpg/turn-based-match-config/builder#classgpg_1_1_turn_based_match_config_1_1_builder)` &` Populates values from a `TurnBasedMultiplayerManager::ShowPlayerSelectUIResponse`. |\n| [SetExclusiveBitMask](#classgpg_1_1_turn_based_match_config_1_1_builder_1adda30366347a5880b899bebfc1ef3ef5)`(uint64_t exclusive_bit_mask)` | [Builder](/games/services/cpp/api/class/gpg/turn-based-match-config/builder#classgpg_1_1_turn_based_match_config_1_1_builder)` &` A bit mask indicating exclusive roles for players. |\n| [SetMaximumAutomatchingPlayers](#classgpg_1_1_turn_based_match_config_1_1_builder_1a9e43ded51cea29a4c75e0558d261e9b5)`(uint32_t maximum_automatching_players)` | [Builder](/games/services/cpp/api/class/gpg/turn-based-match-config/builder#classgpg_1_1_turn_based_match_config_1_1_builder)` &` The maximum number of auto-matched players who can join the match. |\n| [SetMinimumAutomatchingPlayers](#classgpg_1_1_turn_based_match_config_1_1_builder_1ad78accb39872ad02d911f4a0ff274553)`(uint32_t minimum_automatching_players)` | [Builder](/games/services/cpp/api/class/gpg/turn-based-match-config/builder#classgpg_1_1_turn_based_match_config_1_1_builder)` &` The minimum number of auto-matched players who can join the match. |\n| [SetVariant](#classgpg_1_1_turn_based_match_config_1_1_builder_1a16a8d9b77b16c3dc7bb723e4f5048987)`(uint32_t variant)` | [Builder](/games/services/cpp/api/class/gpg/turn-based-match-config/builder#classgpg_1_1_turn_based_match_config_1_1_builder)` &` A developer-specific value used to indicate match type or mode. |\n\nPublic functions\n----------------\n\n### AddAllPlayersToInvite\n\n```c++\nBuilder & AddAllPlayersToInvite(\n const std::vector\u003c std::string \u003e & player_ids\n)\n``` \nAdds multiple players to the list of players to invite to the match.\n\nBy default, no players are added. \n\n### AddPlayerToInvite\n\n```c++\nBuilder & AddPlayerToInvite(\n const std::string & player_id\n)\n``` \nAdds a player to the list of players to invite to the match.\n\nBy default, no players are added to the match. The builder cannot create a match until players are added. \n\n### Builder\n\n```c++\n Builder()\n``` \n\n### Create\n\n```c++\nTurnBasedMatchConfig Create() const \n``` \nCreates a [TurnBasedMatchConfig](/games/services/cpp/api/class/gpg/turn-based-match-config#classgpg_1_1_turn_based_match_config) object. \n\n### PopulateFromPlayerSelectUIResponse\n\n```c++\nBuilder & PopulateFromPlayerSelectUIResponse(\n const TurnBasedMultiplayerManager::PlayerSelectUIResponse & response\n)\n``` \nPopulates values from a `TurnBasedMultiplayerManager::ShowPlayerSelectUIResponse`.\n\nNote that this does not populate the variant or the exclusive bit mask. \n\n### SetExclusiveBitMask\n\n```c++\nBuilder & SetExclusiveBitMask(\n uint64_t exclusive_bit_mask\n)\n``` \nA bit mask indicating exclusive roles for players.\n\n(E.g. For example, if one player is the attacker, the other must be the defender.) Successful auto-matching requires that the logical product (AND) of the bit mask of any pairing players equals zero. Defaults to 0. \n\n### SetMaximumAutomatchingPlayers\n\n```c++\nBuilder & SetMaximumAutomatchingPlayers(\n uint32_t maximum_automatching_players\n)\n``` \nThe maximum number of auto-matched players who can join the match.\n\nLeft unspecified, defaults to a value equal to the minimum number of auto-matching players. \n\n### SetMinimumAutomatchingPlayers\n\n```c++\nBuilder & SetMinimumAutomatchingPlayers(\n uint32_t minimum_automatching_players\n)\n``` \nThe minimum number of auto-matched players who can join the match.\n\nDefaults to 0 when left unspecified. At least one auto-matching player or player id must be added. \n\n### SetVariant\n\n```c++\nBuilder & SetVariant(\n uint32_t variant\n)\n``` \nA developer-specific value used to indicate match type or mode.\n\nOnly players using the same variant can auto-match. Defaults to -1 when left unspecified."]]
