create-player-sessions
Описание
Зарезервирует свободные слоты в игровой сессии для группы игроков. Новые игровые сессии могут быть созданы в любой игровой сессии со свободным слотом, который находится в состоянии ACTIVE и имеет политику создания игроков ACCEPT_ALL . Для добавления одного игрока в игровую сессию используйте CreatePlayerSession
Для создания игровых сессий укажите идентификатор игровой сессии и список идентификаторов игроков. Дополнительно можно указать набор данных о каждом игроке по идентификатору.
В случае успеха, для каждого игрока зарезервируется слот в игровой сессии, и будут возвращены новые объекты PlayerSession с идентификаторами игровых сессий. Каждый игрок ссылается на свой идентификатор игровой сессии при отправке запроса подключения к игровой сессии, и игровой сервер может использовать его для проверки резервирования игрока с помощью сервиса Amazon GameLift. Игровые сессии не могут быть обновлены.
Максимальное количество игроков в одной игровой сессии составляет 200. Это значение не настраивается.
Связанные действия
Все API по задачам
См. также: Документацию API AWS
Синтаксис
create-player-sessions
--game-session-id <value>
--player-ids <value>
[--player-data-map <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]
Параметры
--game-session-id (строка)
--player-ids (список)
Список уникальных идентификаторов игроков, которые будут добавлены.
(строка)
Синтаксис:
"string" "string" ...
--player-data-map (словарь)
Словарь пар строк, каждая из которых указывает идентификатор игрока и набор данных, определённых разработчиком, относящихся к игроку. Amazon GameLift не использует эти данные, поэтому их можно форматировать по мере необходимости для использования в игре. Любые данные о игроке для идентификаторов игроков, которые не включены в параметр PlayerIds, игнорируются.
ключ -> (строка)
значение -> (строка)
Сокращённый синтаксис:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "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 (булево)
Включить отладку логирования.
--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.
Вывод
PlayerSessions -> (список)
Коллекция объектов игровой сессии, созданных для добавленных игроков.
(структура)
Представляет игровую сессию. Игровые сессии создаются либо для конкретной игровой сессии, либо как часть запроса размещения или подбора игровых сессий. Игровая сессия может представлять зарезервированный игровой слот в игровой сессии (когда статус RESERVED ) или фактическую игровую активность игрока в игровой сессии (когда статус ACTIVE ). Объект игровой сессии, включая данные игрока, автоматически передаётся в игровую сессию, когда игрок подключается к игровой сессии и проходит проверку. После завершения игровой сессии информация о игровых сессиях хранится в течение 30 дней, а затем удаляется.
Связанные действия
Все API по задачам
PlayerSessionId -> (строка)
PlayerId -> (строка)
GameSessionId -> (строка)
FleetId -> (строка)
FleetArn -> (строка)
CreationTime -> (отметка времени)
"1469498468.057" ).TerminationTime -> (отметка времени)
"1469498468.057" ).Status -> (строка)
Текущий статус игровой сессии.
Возможные статусы игровой сессии:
- RESERVED – Запрос на игровой сессии получен, но игрок ещё не подключился к процессу сервера и/или не был проверен.
- ACTIVE – Игрок был проверен процессом сервера и в настоящее время подключен.
- COMPLETED – Подключение игрока было разорвано.
- TIMEDOUT – Запрос на игровой сессии был получен, но игрок не подключился и/или не был проверен в течение ограничения таймаута (60 секунд).
IpAddress -> (строка)
DnsName -> (строка)
Идентификатор DNS, назначенный экземпляру, на котором работает игровая сессия. Значения имеют следующий формат:
- Флоты с поддержкой TLS:
<unique identifier>.<region identifier>.amazongamelift.com. - Флоты без поддержки TLS:
ec2-<unique identifier>.compute.amazonaws.com. (См. Amazon EC2 Instance IP Addressing).
При подключении к игровой сессии, работающей на флоте с поддержкой TLS, необходимо использовать имя DNS, а не IP-адрес.
Port -> (целое число)
PlayerData -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.