تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
gpg::TurnBasedMatchConfig::Builder
#include <turn_based_match_config_builder.h>
تنشئ عنصرًا واحدًا أو أكثر من عناصر TurnBasedMatchConfig.
ملخّص
الشركات المصنّعة والمُصنّعة
|
Builder()
|
وظائف عامة
AddAllPlayersToInvite
Builder & AddAllPlayersToInvite(
const std::vector< std::string > & player_ids
)
إضافة عدة لاعبين إلى قائمة اللاعبين لدعوتهم إلى المباراة.
لا تتم إضافة أي لاعبين بشكل تلقائي.
AddPlayerToInvite
Builder & AddPlayerToInvite(
const std::string & player_id
)
لإضافة لاعب إلى قائمة اللاعبين لدعوته إلى المباراة.
لا تتم إضافة أي لاعب إلى المباراة بشكل تلقائي. ولا يمكن لأداة الإنشاء إنشاء مباراة إلا بعد أن تتم إضافة لاعبين إليها.
عامل بناء
Builder()
PopulateFromPlayerSelectUIResponse
Builder & PopulateFromPlayerSelectUIResponse(
const TurnBasedMultiplayerManager::PlayerSelectUIResponse & response
)
لتعبئة القيم من TurnBasedMultiplayerManager::ShowPlayerSelectUIResponse.
يُرجى العِلم أنّ هذا الإجراء لا يؤدي إلى تعبئة الصيغة أو قناع البت الحصري.
SetExclusiveBitMask
Builder & SetExclusiveBitMask(
uint64_t exclusive_bit_mask
)
قناع صغير يشير إلى الأدوار الحصرية للّاعبين
(على سبيل المثال، إذا كان أحد اللاعبين هو المهاجم، يجب أن يكون الآخر مدافعًا). تتطلب المطابقة التلقائية الناجحة أن يكون الناتج المنطقي (و) لقناع البت لأي لاعب إقراني يساوي صفرًا. وتكون القيم التلقائية 0.
SetMaximumAutomatchingPlayers
Builder & SetMaximumAutomatchingPlayers(
uint32_t maximum_automatching_players
)
الحد الأقصى لعدد اللاعبين الذين يمكنهم المطابقة تلقائيًا ويمكنهم الانضمام إلى المباراة
في حال عدم تحديد الخيار، يتم ضبط القيمة التلقائية على قيمة تساوي الحد الأدنى لعدد اللاعبين الذين تتطابق إعداداتهم تلقائيًا.
SetMinimumAutomatchingPlayers
Builder & SetMinimumAutomatchingPlayers(
uint32_t minimum_automatching_players
)
الحدّ الأدنى لعدد اللاعبين الذين يمكنهم المطابقة تلقائيًا ويمكنهم الانضمام إلى المباراة
ويتم ضبط القيمة التلقائية على 0 عند عدم تحديد ذلك. يجب إضافة مشغّل واحد على الأقل أو رقم تعريف لاعب واحد للمطابقة التلقائية.
SetVariant
Builder & SetVariant(
uint32_t variant
)
قيمة خاصة بالمطوِّر تُستخدَم للإشارة إلى نوع المطابقة أو نمطه
يمكن فقط للّاعبين الذين يستخدمون الإصدار نفسه إجراء المطابقة التلقائية. يتم ضبط الإعدادات التلقائية على -1 عند عدم تحديد ذلك.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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."]]
