기술 자료

지원

Multiplay Hosting

Multiplay Hosting

빌드 업로드 워크플로

Follow this workflow to upload and manage builds using the API.
읽는 시간 2분최근 업데이트: 10시간 전
빌드 워크플로에는 바이너리 빌드, 빌드 가져오거나 만들기, 빌드 파일 목록 만들기, 빌드 파일 업로드, 빌드 버전 만들기, 빌드 동기화 대기가 포함됩니다. 빌드 워크플로를 사용하기 전에 CCD API 키와 더불어 다음 역할이 부여된 UGS 서비스 계정이 있어야 합니다.
  • Multiplay API 조회자
  • Multiplay API 편집자
프로젝트 역할과 서비스 계정 인증을 참조하십시오. 다음 다이어그램은 간소화된 버전의 워크플로를 보여 줍니다.
빌드 워크플로 다이어그램

빌드 워크플로 다이어그램

바이너리 빌드

새로운 빌드를 만들려는 경우 나머지 빌드 워크플로를 계속 진행하기 전에 게임 바이너리를 빌드해야 합니다. 사용할 빌드를 이미 보유하고 있는 경우 이 단계를 건너뛰고 기존 빌드 가져오기부터 진행해도 됩니다. 게임 바이너리를 빌드하는 프로세스는 게임에서 사용하는 게임 엔진과 기술 스택에 따라 달라집니다. Unity 엔진을 사용하는 경우 빌드 퍼블리싱과 빌드 만들기를 참고하십시오.

빌드 가져오기

빌드를 가져오는 프로세스는 기존 빌드를 사용할지 혹은 새 빌드를 만들지에 따라 달라집니다.

이름을 기준으로 기존 빌드 가져오기

빌드 나열 API를 사용하여 이름을 기준으로 기존 빌드 ID를 가져올 수 있습니다. 빌드 ID를 이미 알고 있는 경우, 빌드에서 파일 목록 만들기로 계속 진행합니다. 빌드 나열 API의 응답 본문에는 빌드별로 
ccd.bucketID
필드에 각 빌드의 CCD 버킷 ID가 포함됩니다. 사용할 빌드의 
buildID
와 
ccd.bucketID
필드 값을 기록해 두십시오. 다음 코드 샘플은 curl을 사용하여 이름을 기준으로 기존 빌드를 가져오는 방법을 보여 줍니다. 
curl -X GET -H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" https://services.api.unity.com/multiplay/builds/v1/projects/{projectId}/environments/{environmentId}/builds
응답 본문 예시와 파라미터는 API 기술 자료를 참조하십시오.

새 빌드 만들기

빌드 만들기 API를 사용하여 새 빌드를 만들 수 있습니다. 빌드 만들기 API의 응답 본문에는 
ccd.bucketID
필드에 생성한 빌드의 CCD 버킷 ID가 포함됩니다. 
buildID
와 
ccd.bucketID
필드 값을 기록해 두십시오. 다음 코드 샘플은 curl을 사용하여 새 빌드를 만드는 방법을 보여 줍니다. 
curl -X POST -H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" -H "Content-Type: application/json" \-d '{"buildName":"Dev Build A", "ccd": {}, "osFamily": "LINUX"}' \https://services.api.unity.com/multiplay/builds/v1/projects/{projectId}/environments/{environmentId}/builds
응답 본문 예시와 파라미터는 빌드 만들기 API 기술 자료를 참조하십시오.

빌드에 파일 목록 만들기

빌드에 파일 업로드

목록에 있는 파일별로 CCD 생성 또는 경로를 기준으로 엔트리 업데이트 API를 사용하여 빌드에 파일을 업로드할 수 있습니다.
  1. 엔트리를 만듭니다. 다음 코드 샘플은 curl을 사용하여 엔트리를 만드는 방법을 보여 줍니다.
curl -X POST -H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" -H "Content-Type: application/json" \-d '{"content_type": "<FILE_CONTENT_TYPE>", "signed_url": true}' \https://content-api.cloud.unity.com/api/v1/environments/{environmentid}/buckets/{bucketid}/entry_by_path/?path=path/to/file
  1. 응답에서 
    signed_url
    을 캡처합니다. 그러면 파일 콘텐츠를 이 URL로 업로드할 수 있습니다. 다음 코드 샘플은 curl을 사용하여 파일을 업로드하는 방법을 보여 줍니다.
curl -X PUT -H "Content-Type: <FILE_CONTENT_TYPE>" --upload-file path/to/file \<signed_url>
응답 본문 예시와 파라미터는 CCD 생성 또는 경로를 기준으로 엔트리 업데이트 API 기술 자료를 참조하십시오.

빌드 버전 만들기

새 빌드 버전 만들기 API를 사용하여 빌드 버전을 만들 수 있습니다. 
ccd.bucketID
필드를 앞에서 기록해 둔 CCD 버킷 ID로 설정해야 합니다. 다음 코드 샘플은 curl을 사용하여 빌드 버전을 만드는 방법을 보여 줍니다. 
curl -X POST -H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" -H "Content-Type: application/json" \-d '{"ccd": { "bucketID": "<CCD_BUCKET_ID>" }, "forceRollout": false}' \https://services.api.unity.com/multiplay/builds/v1/projects/{projectId}/environments/{environmentId}/builds/{buildId}/versions
응답 본문 예시와 파라미터는 새 빌드 버전 만들기 API 기술 자료를 참조하십시오.

빌드 동기화 대기

syncStatus
필드가 
SYNCED
가 될 때까지 단일 빌드 가져오기 API를 연결하여 빌드 동기화가 완료되는 시점을 파악할 수 있습니다. 다음 코드 샘플은 curl을 사용하여 빌드가 동기화된 시점을 알아보는 방법을 보여 줍니다. 
curl -X GET -H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" https://services.api.unity.com/multiplay/builds/v1/projects/{projectId}/environments/{environmentId}/builds/{buildId}
응답 본문 예시와 파라미터는 단일 빌드 가져오기 API 기술 자료를 참조하십시오.