start-match-backfill

Описание

Ищет новых игроков для заполнения свободных мест в текущих игровых сессиях. Процесс подбора игроков для заполнения (backfill) принципиально идентичен процессу создания новых матчей. Запросы на заполнение используют ту же систему подбора, которая была использована для первоначального формирования матча, и предоставляют данные о соответствии для всех игроков, которые в настоящее время находятся в игровой сессии. FlexMatch использует эту информацию, чтобы выбрать новых игроков таким образом, чтобы заполненное соответствие продолжало удовлетворять первоначальным требованиям соответствия.

При использовании FlexMatch с управляемым хостингом Amazon GameLift вы можете запросить матч для заполнения (backfill) из службы клиента, вызвав эту операцию с GameSessions идентификатором. У вас также есть возможность делать запросы на заполнение (backfill) напрямую с вашего игрового сервера. В ответ на запрос FlexMatch создает игровые сессии для новых игроков, обновляет GameSession ресурс и отправляет обновлённые данные о соответствии игровому серверу. Вы можете запросить матч для заполнения (backfill) в любой момент после начала игровой сессии. Каждая игровая сессия может иметь только один активный запрос на заполнение (backfill) одновременно; последующий запрос автоматически заменяет предыдущий запрос.

При использовании FlexMatch как самостоятельного компонента запросите матч для заполнения (backfill), вызвав эту операцию без идентификатора игровой сессии. Как и в случае с вновь созданными матчами, результаты подбора возвращаются в событии подбора, чтобы ваша игра могла обновить заполняемую игровую сессию.

Чтобы запросить матч для заполнения (backfill), укажите уникальный идентификатор тикета, исходную конфигурацию подбора и данные о соответствии для всех текущих игроков в заполняемой игровой сессии. Необязательно, укажите GameSession ARN. При успехе создаётся билет для заполнения матча (match backfill ticket) и возвращается со статусом QUEUED. Отслеживайте статус билетов для заполнения (backfill) тем же способом, что и билеты для новых матчей.

Только игровые сессии, созданные FlexMatch, поддерживаются для заполнения матчей.

См. также: Документация AWS API

Синтаксис

  start-match-backfill
[--ticket-id <value>]
--configuration-name <value>
[--game-session-arn <value>]
--players <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]

Параметры

--ticket-id (строка)

--configuration-name (строка)

--game-session-arn (строка)

--players (список)

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

PlayerId=string,PlayerAttributes={KeyName1={S=string,N=double,SL=[string,string],SDM={KeyName1=double,KeyName2=double}},KeyName2={S=string,N=double,SL=[string,string],SDM={KeyName1=double,KeyName2=double}}},Team=string,LatencyInMs={KeyName1=integer,KeyName2=integer} ...

Синтаксис JSON:

[
  {
    "PlayerId": "string",
    "PlayerAttributes": {"string": {
          "S": "string",
          "N": double,
          "SL": ["string", ...],
          "SDM": {"string": double
            ...}
        }
      ...},
    "Team": "string",
    "LatencyInMs": {"string": integer
      ...}
  }
  ...
]

--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 (булево)

Включить отладку.

--endpoint-url (строка)

Переопределить URL по умолчанию для команды на указанный URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI проверит сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования выходных данных команды.

• json
• text
• таблица
• yaml
• yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определённого профиля из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Показать версию этого инструмента.

--color (строка)

Включение/выключение цветного вывода.

• вкл
• выкл
• авто

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл сертификата CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения к сокету в секундах. Если значение равно 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. По умолчанию формат — 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 (булево)

Отключить страницу cli для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы параметров CLI.

Вывод

MatchmakingTicket -> (структура)