Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

создать-конфигурацию-подбора-соперников

Описание

Определяет новую конфигурацию подбора игроков для использования с 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 (строка)

Уникальный идентификатор набора правил подбора, используемого в этой конфигурации. Можно использовать либо имя набора правил, либо значение ARN. Конфигурация подбора может использовать только наборы правил, определённые в том же регионе.

--notification-target (строка)

ARN темы SNS, настроенной для получения уведомлений о подборе. См. Настройка уведомлений для подбора для получения дополнительной информации.

--additional-player-count (целое число)

Количество игровых слотов в матче, которые нужно оставить открытыми для будущих игроков. Например, если набор правил конфигурации определяет матч для одной команды из 12 человек, а количество дополнительных игроков установлено в 2, только 10 игроков выбираются для матча. Этот параметр не используется, если 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.

Возможные значения:

  • AUTOMATIC
  • MANUAL

--flex-match-mode (строка)

Указывает, используется ли эта конфигурация подбора с хостингом Amazon GameLift или как самостоятельное решение подбора.

  • STANDALONE - FlexMatch формирует матчи и возвращает информацию о матче, включая игроков и распределение по командам, в событии MatchmakingSucceeded.
  • WITH_QUEUE - FlexMatch формирует матчи и использует указанную очередь Amazon GameLift для запуска игровой сессии для матча.

Возможные значения:

  • STANDALONE
  • WITH_QUEUE

--tags (список)

Список меток, которые необходимо назначить новому ресурсу конфигурации подбора. Метки — это определяемые разработчиками пары «ключ-значение». Использование меток ресурсов Amazon Web Services полезно для управления ресурсами, управления доступом и распределения затрат. Дополнительную информацию см. в разделе Метки ресурсов Amazon Web Services в справке Amazon Web Services.

(структура)

Метка, которую можно назначить ресурсу Amazon GameLift.

Узнать больше

Метки ресурсов Amazon Web Services в справке Amazon Web Services

Стратегии метки Amazon Web Services

Связанные действия

Все API по задачам

Ключ -> (строка)

Ключ для пары «ключ-значение», определяемой разработчиком, для метки ресурса Amazon Web Services.

Значение -> (строка)

Значение для пары «ключ-значение», определяемой разработчиком, для метки ресурса Amazon Web Services.

Упрощённый синтаксис:

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 -> (строка)

Amazon Resource Name (ARN) присваивается ресурсу конфигурации подбора Amazon GameLift и однозначно его идентифицирует. ARNs уникальны во всех регионах. Формат 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 -> (логическое значение)

Флаг, указывающий, должен ли матч, созданный с помощью этой конфигурации, быть принят сопоставленными игроками. Для требования принятия установить в TRUE. При включении этого параметра билеты подбора используют статус REQUIRES_ACCEPTANCE для указания того, когда ожидаемый завершенный матч ожидает принятия игрока.

RuleSetName -> (строка)

Уникальный идентификатор набора правил подбора, используемого с этой конфигурацией. Конфигурация подбора может использовать только наборы правил, определенные в одном и том же регионе.

RuleSetArn -> (строка)

Amazon Resource Name (ARN), связанный с ресурсом набора правил подбора Amazon GameLift, используемым этой конфигурацией.

NotificationTarget -> (строка)

ARN темы SNS, настроенной для получения уведомлений о подборе.

AdditionalPlayerCount -> (целое число)

Количество игровых слотов в матче, которые необходимо оставить открытыми для будущих игроков. Например, если набор правил конфигурации определяет матч для одной команды из 12 человек, а дополнительное количество игроков установлено в 2, только 10 игроков выбираются для матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE.

CustomEventData -> (строка)

Информация, которая добавляется ко всем событиям, связанным с конфигурацией подбора.

CreationTime -> (метка времени)

Маркер времени, указывающий, когда был создан этот объект данных. Формат — число, выраженное в unix-времени в миллисекундах (например, "1469498468.057").

GameProperties -> (список)

Набор пар ключ-значение, которые могут хранить пользовательские данные в игровой сессии. Например: {"Key": "difficulty", "Value": "novice"}. Эта информация добавляется к новому объекту GameSession, созданному для успешного матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE.

(структура)

Эта пара ключ-значение может хранить пользовательские данные об игровой сессии. Например, вы можете использовать GameProperty для отслеживания карты игровой сессии, уровня сложности или оставшегося времени. Уровень сложности можно указать следующим образом: {"Key": "difficulty", "Value":"Novice"}.

Вы можете установить свойства игры при создании игровой сессии. Вы также можете изменить свойства активной игровой сессии. При поиске игровых сессий вы можете фильтровать по ключам и значениям свойств игры. Удалять свойства игры из игровой сессии нельзя.

Примеры работы со свойствами игры см. в Create a game session with properties.

Ключ -> (строка)

Идентификатор свойства игры.

Значение -> (строка)

Значение свойства игры.

GameSessionData -> (строка)

Набор пользовательских свойств игровой сессии, отформатированных как одно строковое значение. Эти данные передаются в процесс сервера игры с запросом на запуск новой игровой сессии. Дополнительная информация представлена в Start a game session. Эта информация добавляется к новому объекту GameSession, созданному для успешного матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE.

BackfillMode -> (строка)

Метод, используемый для заполнения игровых сессий, созданных с помощью этой конфигурации подбора. MANUAL указывает, что игра выполняет запросы заполнения или не использует функцию заполнения матча. AUTOMATIC указывает, что GameLift создает запросы заполнения всякий раз, когда игровая сессия имеет один или несколько открытых слотов. Узнайте больше о ручном и автоматическом заполнении в Backfill existing games with FlexMatch. Автоматическое заполнение недоступно, когда FlexMatchMode установлено в STANDALONE.

FlexMatchMode -> (строка)

Указывает, используется ли эта конфигурация подбора с Amazon GameLift-хостингом или как автономное решение для подбора.

  • STANDALONE - FlexMatch формирует матчи и возвращает информацию о матчах, включая игроков и распределение команд, в событии MatchmakingSucceeded.
  • WITH_QUEUE - FlexMatch формирует матчи и использует указанную очередь Amazon GameLift для запуска игровой сессии для матча.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API