기술 자료

지원

Cloud Code

Cloud Code

Unity Cloud Dashboard

Create and manage Cloud Code scripts using the graphical interface of the Unity Dashboard.
읽는 시간 1분최근 업데이트: 14시간 전
Unity Cloud Dashboard를 사용하면 그래픽 인터페이스를 통해 스크립트를 완전히 제어할 수 있으므로 간편하게 스크립트 작업을 시작할 수 있습니다. 이 섹션에서는 스크립트를 미리 보고, 생성하고, 편집하고, 삭제하는 방법을 설명합니다.

스크립트 미리 보기

Unity Cloud Dashboard에서 환경의 모든 Cloud Code 스크립트가 나열된 목록에 액세스할 수 있습니다. 다음 단계를 따라 액세스합니다.
  1. Unity Cloud Dashboard에서 Products > Cloud Code를 선택합니다.
  2. Scripts를 선택합니다.
  3. 환경 목록에서 환경을 선택합니다.
프로젝트에 대해 선택한 환경의 모든 Cloud Code 스크립트 목록이 나타납니다. 표에는 이름, 유형, 마지막으로 퍼블리시된 날짜, 버전이 포함됩니다. 스크립트 이름순으로 표를 정렬하거나 페이지 매김을 사용하여 전체 스크립트를 볼 수 있습니다.

스크립트 생성

Unity Cloud Dashboard에서 첫 번째 스크립트를 생성하여 Cloud Code를 시작합니다.
  1. Unity Cloud Dashboard에서 Products > Cloud Code를 선택한 다음, Scripts를 선택합니다.
  2. Create your first script를 선택합니다.
  3. 다음 정보를 입력합니다.
    • Name: 스크립트를 설명하는 이름으로, Cloud Code 백엔드에서 스크립트를 식별하고 실행하는 데 사용됩니다. 스크립트 이름은 프로젝트와 환경 전체에서 고유해야 하며, 문자, 숫자, 밑줄, 대시만 사용하고 50자를 초과해서는 안 됩니다.
    • Type: 스크립트 유형입니다.
  4. Next를 선택합니다.
  5. 다음에 나타나는 창에서 선택한 스크립트 유형의 정보를 입력합니다.
다음 화면은 코드와 세부 정보를 테스트하고 편집할 수 있는 스크립트 에디터입니다.

파라미터 추가

  1. 스크립트를 추가한 다음 + Add parameter를 선택합니다. 스크립트가 게임에서 허용하는 파라미터를 지정합니다. 명명된 프로퍼티로 스크립트 코드에서 파라미터에 액세스할 수 있습니다.
  2. 다음 정보를 입력합니다.
    1. Parameter name: 트리거될 때 스크립트에서 사용할 수 있는 파라미터의 이름입니다. 파라미터 이름은 스크립트에서 고유해야 하며, 문자, 숫자, 밑줄, 대시만 사용하고 50자 미만이어야 합니다.
    2. Type: 이 필드는 Cloud Code가 각 요청에 대해 수행하는 데이터 유형 확인을 결정합니다.
    3. 다음 중 하나를 선택합니다.
      • 문자열
      • 숫자
      • 부울
      • JSON
      • 모두
    4. 필수: 이 필드를 활성화하면 요청에서 파라미터가 전달되었는지 확인할 수 있습니다. 필수 파라미터 중에서 누락된 파라미터가 있는 상태로 Cloud Code API를 통해 스크립트를 실행하면 오류가 발생합니다.
    Cloud Code는 스크립트를 실행할 때 이러한 파라미터를 확인합니다. 입력 파라미터가 유효하지 않으면 Cloud Code API 호출이 실패합니다.
  3. 이 단계를 반복하여 파라미터를 최대 10개까지 추가할 수 있습니다.
  4. Add를 선택합니다.

스크립트 에디터

브라우저 기반 스크립트 에디터는 코드의 오류를 표시하고 JavaScript 자동 완성 기능을 제공합니다. Run Code 탭에서 다음 내용을 확인할 수 있습니다.
  • Script Code 섹션에는 스크립트 코드가 포함되어 있습니다.
  • Parameters 표에는 생성한 모든 파라미터와 해당 값이 표시되며, 테스트 플레이어 ID를 생성할 수도 있습니다. 필수로 표시된 파라미터가 선택 사항 파라미터보다 먼저 표시됩니다.
  • Response/Logs/Request 탭에는 스크립트가 실행된 후의 정보가 표시됩니다.
  • Beautify 버튼을 누르면 자동으로 코드 포맷을 재구성하여 가독성을 최적화합니다.
에디터에는 다음과 같은 기능이 있습니다.
  • 단순한 JavaScript 기능을 만들 수 있는 간단한 코드 자동 완성
  • 구문 오류, 세미콜론 누락, 접근할 수 없는 코드 등 일반적인 문제에 대한 주석
  • 유형 오류, 범위 오류, 기타 발생한 오류 등 테스트 실행 중에 발생한 오류에 대한 주석
새로운 스크립트 각각에는 빠르게 시작하는 데 도움이 되도록 예시가 미리 입력되어 있습니다.

스크립트 세부 정보

Details 탭을 선택하면 다음 정보를 확인할 수 있습니다.
  • 스크립트 이름
  • 유형
  • 마지막으로 퍼블리시된 날짜
  • 마지막으로 퍼블리시된 버전
이전에 만든 스크립트 파라미터 표를 볼 수도 있습니다. 이전에 사용한 파라미터를 편집할 수도 있고 이 테이블에서 새 파라미터를 생성할 수도 있습니다.

저장 및 퍼블리싱

Run Code 탭의 Script Code 창에서 코드를 변경하면 Cloud Code에서 Save script 버튼이 활성화됩니다. Save script를 선택하여 변경 사항을 작업 중인 사본에 저장합니다. 코드가 저장되지만 아직 라이브 상태는 아니므로 게임이 중단될 위험은 없습니다. 에디터에 대기 중인 코드 변경 사항이 없다면 Cloud Code에서 Publish version 버튼이 활성화됩니다. 이 버튼을 선택하고 다이얼로그에서 스크립트를 퍼블리시하면 스크립트는 라이브 상태가 됩니다. 게임 클라이언트가 Cloud Code API를 호출하면 스크립트가 Cloud Code 백엔드에서 실행됩니다. 스크립트의 작업 중인 사본은 편집 가능한 상태로 유지되며, 플레이어의 게임 경험에는 영향을 주지 않습니다. 퍼블리시된 코드 버전은 읽기 전용이지만, 다시 퍼블리시할 수 있습니다. 작업 중인 사본은 퍼블리시된 스크립트에 예기치 않은 문제가 발생하여 제대로 작동하는 이전 스크립트 버전으로 롤백하려는 경우에 유용합니다. 이전 버전을 퍼블리시하면 새로운 버전으로 복제본이 생성됩니다. 스크립트를 퍼블리시하면 게임의 라이브 버전이 업데이트되므로, 퍼블리시하기 전에 스크립트가 의도대로 작동하는지 확인해야 합니다. 현재 액티브 상태인 스크립트 버전은 다시 퍼블리시할 수 없습니다. 즉, 선택한 스크립트 버전(작업 중인 사본 또는 이전 버전)이 게임 라이브 버전의 스크립트와 동일한 경우 Cloud Code는 둘 사이에 차이점이 생길 때까지 퍼블리시 기능을 비활성화합니다. 스크립트를 퍼블리시할 때마다 버전 번호가 높아지며, Cloud Code는 최신 10개 버전만 유지합니다.

스크립트 삭제

Unity Cloud Dashboard에서 스크립트를 삭제하려면 다음 내용을 따릅니다.
  1. Scripts 목록 페이지로 이동합니다.
  2. 휴지통 아이콘을 선택합니다. 이 스크립트를 삭제하면 실행 취소할 수 없다는 경고 다이얼로그가 표시됩니다.
  3. Delete를 선택하여 삭제를 확인합니다.