기술 자료

지원

Cloud Code

Cloud Code

Cloud Code API 호출

Invoke module endpoints using HTTP requests to the Cloud Code REST API.
읽는 시간 1분최근 업데이트: 한 달 전
모듈 엔드포인트를 실행하려면 Cloud Code API를 호출합니다. 자세한 내용은 Cloud Code API 기술 자료를 참고하십시오.

Authentication

서비스 계정이나 상태 비보존 토큰을 사용하여 플레이어 또는 신뢰할 수 있는 클라이언트로 인증하려면 인증을 참고하십시오. 받은 토큰을 요청 헤더에서 HTTP 인증을 위한 bearer 토큰으로 사용합니다. 
Authorization: Bearer <BEARER_TOKEN>

모듈 엔드포인트 요청 실행

POST 요청을 다음으로 보내 Cloud Code API를 호출합니다. 
https://cloud-code.services.api.unity.com/v1/projects/<PROJECT_ID>/modules/<MODULE_NAME>/<FUNCTION_NAME>
다음과 같이 경로 파라미터를 정의합니다. 
  • PROJECT_ID
    - 프로젝트 ID입니다.
  • MODULE_NAME
    - 모듈 이름입니다.
  • FUNCTION_NAME
    - 모듈 엔드포인트 이름으로, 코드에서 정의한 
    CloudCodeFunction
    입니다.
간단한 cURL 커맨드는 다음과 같습니다. 
curl --request POST 'https://cloud-code.services.api.unity.com/v1/projects/<PROJECT_ID>/modules/<MODULE_NAME>/<FUNCTION_NAME>' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer <BEARER_TOKEN>'

요청 페이로드

메서드 서명 내의 모듈 함수에서 파라미터를 정의할 수 있습니다. 모듈 함수의 구조를 만드는 방법은 모듈 구조를 참고하십시오. 예를 들어 다음 메서드는 문자열 파라미터 weapon과 bodyPart를 정의합니다. 
[CloudCodeFunction("IntroduceGuard")]public string IntroduceGuard(string weapon, string bodyPart){return $"I used to be an adventurer like you. Then I took an ${weapon} to the ${bodyPart}.";}
이 파라미터는 엔드포인트를 호출할 때 요청 본문에서 JSON으로 전달됩니다. 파라미터의 대소문자는 메서드 서명과 일치해야 합니다. 
{  "params": {    "weapon": "arrow",    "bodyPart": "knee"  }}
완전한 cURL 커맨드는 다음과 같습니다. 
curl --request POST 'https://cloud-code.services.api.unity.com/v1/projects/<PROJECT_ID>/modules/<MODULE_NAME>/<FUNCTION_NAME>' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer <BEARER_TOKEN>' \--data-raw '{  "params": {    "weapon": "arrow",    "bodyPart": "knee"  }}'

샘플 출력

다음은 모듈 출력 예시입니다. 
{    "output": "I used to be an adventurer like you. Then I took an arrow to the knee."}