기술 자료

지원

Multiplay Hosting

Multiplay Hosting

할당 페이로드

Learn how allocation payloads pass game-specific data to your servers during allocation.
읽는 시간 1분최근 업데이트: 2일 전
경고
2026년 3월 31일부터 Unity _Multiplay Game Server Hosting 서비스_에 대한 직접 지원이 종료되었습니다. 라이브 타이틀의 연속성을 보장하기 위해 우리는 우리의 Multiplay Game Server Hosting 소프트웨어를 Rocket Science Group에 라이센스를 부여했습니다. 자세한 내용은 여기에서 확인하십시오.
할당 페이로드 기능을 사용하면 서버 할당을 요청할 때 파일을 페이로드로 전송할 수 있으며, 이를 통해 매치별로 게임을 구성할 수 있습니다. 페이로드가 ProcessAllocation V1 엔드포인트를 통해 업로드되면 게임 프로세스에서 페이로드를 가져올 수 있습니다. 할당이 종료되면 해당 할당과 연계된 페이로드를 더 이상 사용할 수 없습니다. 페이로드 라이프사이클을 참조하십시오.

제한 사항

할당 페이로드 기능의 제한 사항은 다음과 같습니다.
  • 페이로드는 30KB를 초과할 수 없습니다. 엔드포인트는 크기 제한보다 큰 페이로드가 포함된 할당을 거부하고 이를 400이라는 상태로 나타냅니다.
  • Multiplay ProcessAllocation V1 엔드포인트에서 할당의 일부로 페이로드를 포함할 수 있습니다.
  • ProcessDeallocation V1 엔드포인트를 사용하여 페이로드를 제거할 수 있습니다.

페이로드 라이프사이클

페이로드는 특정 할당과 연계된 세션 기반의 임시 데이터입니다. 페이로드가 연결된 할당이 해제되면 해당 페이로드는 더 이상 사용할 수 없습니다. 다음 조건 중에서 하나라도 만족하면 페이로드를 가져올 수 없습니다.
  • 게임 서버가 할당 해제 엔드포인트를 통해 할당이 해제됩니다. 할당의 라이프사이클이 완료되면 Multiplay Hosting이 할당 UUID와 관련된 모든 데이터를 삭제합니다.
  • 페이로드가 TTL(Time to Live)에 도달합니다. 플릿 스케일링 설정의 할당 타임아웃 값이 페이로드 TTL을 설정하며, 플릿 레벨에서 이 값을 설정하지 않으면 기본값은 1시간입니다.

페이로드 전송

페이로드 값을 보내려면 
payload
문자열 값을 요청 본문에 포함해야 하며, 페이로드는 할당의 전체 라이프사이클 동안 사용 가능합니다.
참고
Multiplay API URL:
https://multiplay.services.api.unity.com

요청 예시

curl --location --request POST 'https://multiplay.services.api.unity.com/v1/allocations/projects/<projectid>/environments/<environmentid>/fleets/<fleetid>/allocations' \--header 'Authorization: Basic YOUR_AUTH_CREDENTIALS' \--header 'Content-Type: application/json' \--data-raw '{  allocationId: "<allocation_uuid>"",  buildConfigurationId: <build_config_id>,  regionId: "<region_id>"",  payload: "this can be anything"}'

응답 예시

{  "allocationId": "<allocation_uuid>",  "href": "string"}

페이로드 가져오기

할당 요청이 완료되면 게임 서버에서 페이로드에 액세스할 수 있습니다. 게임 서버 머신에서 로컬로 사용 가능한 페이로드 프록시로 요청을 전송하여 게임 서버에서 페이로드 파일을 가져옵니다. 페이로드 프록시는 포트 
8086
에서 서비스에 액세스할 수 있으며, 게임 서버와 함께 위치합니다. 이 프록시는 할당 엔드포인트를 통해 업로드된 페이로드를 검색합니다.
참고
server.json 파일을 사용해 서버의 할당 UUID를 가져오십시오.

요청 예시

curl -X GET http://localhost:8086/payload/<allocation_uuid>

응답 예시

HTTP/1.1 200 OKDate: Mon, 26 Jul 2021 17:00:33 GMTContent-Length: 23Content-Type: text/plain; charset=utf-8This can be anything.