создать-конфигурацию-подбора-соперников
Описание
Определяет новую конфигурацию подбора игроков для использования с FlexMatch. Независимо от того, используете ли вы FlexMatch с хостингом Amazon GameLift или в качестве отдельной службы подбора, конфигурация подбора устанавливает правила для подбора игроков и формирования команд. Если вы также используете хостинг Amazon GameLift, она определяет, как запускать игровые сессии для каждого матча. Ваша система подбора может использовать несколько конфигураций для обработки различных игровых сценариев. Все запросы подбора идентифицируют используемую конфигурацию подбора и предоставляют атрибуты игроков, согласующиеся с этой конфигурацией.
Для создания конфигурации подбора необходимо предоставить следующее: имя конфигурации и режим FlexMatch (с хостингом Amazon GameLift или без него); набор правил, определяющих, как оценивать игроков и находить подходящие матчи; требуется ли подтверждение игроков; и максимальное время, разрешённое для попытки подбора. При использовании FlexMatch с хостингом Amazon GameLift также необходимо указать очередь игровых сессий, используемую при запуске игровой сессии для матча.
Кроме того, необходимо настроить тему Amazon Simple Notification Service для получения уведомлений о подборе. Укажите ARN темы в конфигурации подбора.
Узнать больше
Разработка подборщика FlexMatch
Настройка уведомлений о событиях FlexMatch
См. также: Документация API AWS
Краткое описание
create-matchmaking-configuration
--name <value>
[--description <value>]
[--game-session-queue-arns <value>]
--request-timeout-seconds <value>
[--acceptance-timeout-seconds <value>]
--acceptance-required | --no-acceptance-required
--rule-set-name <value>
[--notification-target <value>]
[--additional-player-count <value>]
[--custom-event-data <value>]
[--game-properties <value>]
[--game-session-data <value>]
[--backfill-mode <value>]
[--flex-match-mode <value>]
[--tags <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--name (строка)
--description (строка)
--game-session-queue-arns (список)
Amazon Resource Name (ARN) ресурса очереди игровых сессий Amazon GameLift, уникально его идентифицирующий. ARN уникальны в каждом регионе. Формат: arn:aws:gamelift:<region>::gamesessionqueue/<queue name> . Очереди могут быть расположены в любом регионе. Очереди используются для запуска новых игровых сессий Amazon GameLift для матчей, созданных с помощью этой конфигурации подбора. Если FlexMatchMode установлено в STANDALONE, не устанавливайте этот параметр.
(строка)
Синтаксис:
"string" "string" ...
--request-timeout-seconds (целое число)
--acceptance-timeout-seconds (целое число)
--acceptance-required | --no-acceptance-required (булево)
TRUE. При включенном этом параметре тикеты подбора используют состояние REQUIRES_ACCEPTANCE, чтобы указать, когда завершённый потенциальный матч ожидает подтверждения игроков.--rule-set-name (строка)
--notification-target (строка)
--additional-player-count (целое число)
FlexMatchMode установлено в STANDALONE.--custom-event-data (строка)
--game-properties (список)
Набор пар «ключ-значение», которые могут хранить пользовательские данные в игровой сессии. Например: {"Key": "difficulty", "Value": "novice"}. Эта информация добавляется к новому объекту GameSession, созданному для успешного матча. Этот параметр не используется, если FlexMatchMode установлено в STANDALONE.
(структура)
Эта пара «ключ-значение» может хранить пользовательские данные об игровой сессии. Например, вы можете использовать GameProperty для отслеживания карты игровой сессии, уровня сложности или оставшегося времени. Уровень сложности можно указать так: {"Key": "difficulty", "Value":"Novice"}.
Вы можете установить свойства игры при создании игровой сессии. Вы также можете изменить свойства игры активной игровой сессии. При поиске игровых сессий можно фильтровать по ключам и значениям свойств игры. Свойства игры нельзя удалить из игровой сессии.
Примеры работы со свойствами игры см. в Создать игровую сессию со свойствами.
Ключ -> (строка)
Значение -> (строка)
Упрощённый синтаксис:
Key=string,Value=string ...
JSON-синтаксис:
[
{
"Key": "string",
"Value": "string"
}
...
]
--game-session-data (строка)
GameSession, созданному для успешного матча. Этот параметр не используется, если FlexMatchMode установлено в STANDALONE.--backfill-mode (строка)
Метод, используемый для заполнения игровых сессий, созданных с этой конфигурацией подбора. Укажите MANUAL, когда ваша игра управляет запросами заполнения вручную или не использует функцию заполнения матча. Укажите AUTOMATIC, чтобы Amazon GameLift создавал запрос заполнения всякий раз, когда игровая сессия имеет один или несколько открытых слотов. Узнайте больше о ручном и автоматическом заполнении в Заполнение существующих игр с помощью FlexMatch. Автоматическое заполнение недоступно, если FlexMatchMode установлено в STANDALONE.
Возможные значения:
AUTOMATICMANUAL
--flex-match-mode (строка)
Указывает, используется ли эта конфигурация подбора с хостингом Amazon GameLift или как самостоятельное решение подбора.
- STANDALONE - FlexMatch формирует матчи и возвращает информацию о матче, включая игроков и распределение по командам, в событии MatchmakingSucceeded.
- WITH_QUEUE - FlexMatch формирует матчи и использует указанную очередь Amazon GameLift для запуска игровой сессии для матча.
Возможные значения:
STANDALONEWITH_QUEUE
--tags (список)
Список меток, которые необходимо назначить новому ресурсу конфигурации подбора. Метки — это определяемые разработчиками пары «ключ-значение». Использование меток ресурсов Amazon Web Services полезно для управления ресурсами, управления доступом и распределения затрат. Дополнительную информацию см. в разделе Метки ресурсов Amazon Web Services в справке Amazon Web Services.
(структура)
Метка, которую можно назначить ресурсу Amazon GameLift.
Узнать больше
Метки ресурсов Amazon Web Services в справке Amazon Web Services
Стратегии метки Amazon Web Services
Связанные действия
Все API по задачам
Ключ -> (строка)
Значение -> (строка)
Упрощённый синтаксис:
Key=string,Value=string ...
JSON-синтаксис:
[
{
"Key": "string",
"Value": "string"
}
...
]
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, указанному в --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного в JSON, поскольку строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено без значения или со значением input, выводит пример входного JSON, который можно использовать как аргумент для --cli-input-json. Аналогично, если предоставлено значение yaml-input, будет напечатан пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, проверяются входные данные команды и возвращается пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (boolean)
Включить отладочную запись.
--endpoint-url (string)
Переопределить URL команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команд.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определенный профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (string)
Файл с набором сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаут. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаут. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображается как двоичный блок fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить кли-пейджер для вывода.
--cli-auto-prompt (boolean)
Автоматически запросить параметры ввода для CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода для CLI.
Вывод
Конфигурация -> (структура)
Объект, описывающий недавно созданную конфигурацию для подбора.
Имя -> (строка)
ConfigurationArn -> (строка)
arn:aws:gamelift:<region>::matchmakingconfiguration/<matchmaking configuration name> . В ARN конфигурации Amazon GameLift идентификатор ресурса соответствует значению Имя.Описание -> (строка)
GameSessionQueueArns -> (список)
Amazon Resource Name (ARN) присваивается ресурсу очереди игровых сессий Amazon GameLift и однозначно его идентифицирует. ARNs уникальны во всех регионах. Формат arn:aws:gamelift:<region>::gamesessionqueue/<queue name> . Очереди могут находиться в любом регионе. Очереди используются для запуска новых игровых сессий Amazon GameLift для матчей, созданных с помощью этой конфигурации подбора. Это свойство не устанавливается, когда FlexMatchMode установлено в STANDALONE.
(строка)
RequestTimeoutSeconds -> (целое число)
AcceptanceTimeoutSeconds -> (целое число)
AcceptanceRequired -> (логическое значение)
REQUIRES_ACCEPTANCE для указания того, когда ожидаемый завершенный матч ожидает принятия игрока.RuleSetName -> (строка)
RuleSetArn -> (строка)
NotificationTarget -> (строка)
AdditionalPlayerCount -> (целое число)
FlexMatchMode установлено в STANDALONE.CustomEventData -> (строка)
CreationTime -> (метка времени)
"1469498468.057").GameProperties -> (список)
Набор пар ключ-значение, которые могут хранить пользовательские данные в игровой сессии. Например: {"Key": "difficulty", "Value": "novice"}. Эта информация добавляется к новому объекту GameSession, созданному для успешного матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE.
(структура)
Эта пара ключ-значение может хранить пользовательские данные об игровой сессии. Например, вы можете использовать GameProperty для отслеживания карты игровой сессии, уровня сложности или оставшегося времени. Уровень сложности можно указать следующим образом: {"Key": "difficulty", "Value":"Novice"}.
Вы можете установить свойства игры при создании игровой сессии. Вы также можете изменить свойства активной игровой сессии. При поиске игровых сессий вы можете фильтровать по ключам и значениям свойств игры. Удалять свойства игры из игровой сессии нельзя.
Примеры работы со свойствами игры см. в Create a game session with properties.
Ключ -> (строка)
Значение -> (строка)
GameSessionData -> (строка)
GameSession, созданному для успешного матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE.BackfillMode -> (строка)
FlexMatchMode установлено в STANDALONE.FlexMatchMode -> (строка)
Указывает, используется ли эта конфигурация подбора с Amazon GameLift-хостингом или как автономное решение для подбора.
- STANDALONE - FlexMatch формирует матчи и возвращает информацию о матчах, включая игроков и распределение команд, в событии MatchmakingSucceeded.
- WITH_QUEUE - FlexMatch формирует матчи и использует указанную очередь Amazon GameLift для запуска игровой сессии для матча.
© Copyright 2025, Amazon Web Services. Created using Sphinx.