시작하기
Follow this workflow to create a JavaScript script that can prevent cheating and execute code asynchronously.
읽는 시간 2분최근 업데이트: 한 달 전
이 섹션에서는 JavaScript 스크립트를 생성하는 데 필요한 모든 단계를 설명합니다.
Hello World 배포
Cloud Code를 사용하면 게임의 커스텀 서버 측 코드를 실행할 수 있습니다. Cloud Code 서버에서 코드를 실행하면 부정 행위를 방지하고 서버 측 이벤트에 대한 응답으로 비동기식으로 코드를 실행할 수 있습니다. Cloud Code에서 간단한 ‘hello world’ 스크립트를 정의하여 서비스를 테스트할 수 있습니다.필수 조건
아래 스크립트를 생성하기 전에 다음 단계를 따라야 합니다.프로젝트 연결
Cloud Code 서비스를 사용하려면 UGS 프로젝트와 Unity 에디터를 연결해야 합니다. Unity Cloud Dashboard에서 UGS 프로젝트 ID를 확인할 수 있습니다.- Unity 에디터에서 Edit > Project Settings > Services를 선택합니다.
-
프로젝트를 연결합니다.
-
프로젝트에 Unity 프로젝트 ID가 없는 경우 다음 단계를 진행합니다.
- Create a Unity Project ID > Organizations를 선택한 다음 드롭다운 메뉴에서 조직을 선택합니다.
- Create project ID를 선택합니다.
-
Unity 프로젝트 ID가 있는 경우 다음 단계를 진행합니다.
- Use an existing Unity project ID를 선택합니다.
- 드롭다운 메뉴에서 조직과 프로젝트를 선택합니다.
- Link project ID를 선택합니다.
-
프로젝트에 Unity 프로젝트 ID가 없는 경우 다음 단계를 진행합니다.
UnityEditor.CloudProjectSettings.projectIdSDK 설치
다음 단계를 따라 Unity 에디터용 최신 Cloud Code 패키지를 설치합니다.- Unity 에디터에서 Window > Package Manager를 엽니다.
- Package Manager에서 Unity Registry 목록 뷰를 선택합니다.
- 를 검색하거나 목록에서 Cloud Code 패키지를 찾습니다.
com.unity.services.cloudcode - 패키지를 선택하고 Install을 클릭합니다.
SDK 설정
Authentication SDK로 로그인하면 Cloud Code SDK를 사용할 수 있습니다. Cloud Code SDK를 사용하려면 Unity Cloud Dashboard의 Cloud Code 페이지에서 하나 이상의 클라우드 스크립트를 저작(authoring)해야 합니다. 그런 다음 Cloud Code 메서드를 호출하여 데이터와 상호 작용할 수 있습니다. 다음 단계를 따라 Cloud Code SDK를 시작합니다.- Cloud Code 서비스 대시보드 페이지를 통해 서비스를 활성화합니다.
- Cloud Code와 Authentication SDK를 모두 설치합니다.
- Edit > Project Settings... > Services를 선택하여 Unity 에디터 내에서 클라우드 프로젝트에 로그인합니다.
- Unity 에디터에서 새 C# Monobehaviour 스크립트를 생성합니다. Unity 매뉴얼의 스크립트 생성 및 사용을 참고하십시오.
- 스크립트에서 await 를 사용하여 Core SDK를 초기화합니다.
UnityServices.InitializeAsync() - 스크립트에서 Authentication SDK를 초기화합니다.
C#
스크립트 설정에 관한 예시와 정보는 Unity Runtime에서 호출을 참고하십시오.await AuthenticationService.Instance.SignInAnonymouslyAsync();
인증
일반적으로 앱이 모든 상호 작용 간 보안, 일관성, 안전을 보장하며 게임 개발자와 플레이어 양측에 다양한 기능과 서비스를 제공하려면 사용자의 ID를 알아야 합니다. Cloud Code 서비스에 액세스하려면 각 플레이어에게 유효한 플레이어 ID와 액세스 토큰이 있어야 합니다. 인증을 참고하십시오.첫 번째 스크립트 작성
Unity Cloud Dashboard를 사용하여stringname변경 사항을 저장하고 스크립트를 퍼블리시합니다. 퍼블리시하고 나면 다음 예시에 나와 있는 것처럼 SDK 엔드포인트 중 하나를 사용하여 프로젝트에서 Cloud Code 스크립트를 호출할 수 있습니다. 자세한 지침은 Unity Runtime에서 호출을 확인하십시오. C#module.exports = async ({ params, logger }) => { const name = params.name; const message = `Hello, ${name}. Welcome to Cloud Code!` logger.debug(message); return { welcomeMessage: message };};
using System.Collections.Generic;using Unity.Services.Authentication;using Unity.Services.CloudCode;using Unity.Services.Core;using UnityEngine;/* * Note: You must have a published script to use the Cloud Code SDK. * You can publish a script from the Unity Cloud Dashboard - https://cloud.unity.com */public class CloudCodeExample : MonoBehaviour{ /* * CloudCodeResponse represents the response from the script, used for deserialization. * In this example, the script returns a JSON in the format * {"welcomeMessage": "Hello, arguments['name']. Welcome to Cloud Code!"} */ class CloudCodeResponse { public string welcomeMessage; } /* * Initialize all Unity Services and Sign In an anonymous player. * You can perform this operation in a more centralized spot in your project */ public async void Awake() { await UnityServices.InitializeAsync(); await AuthenticationService.Instance.SignInAnonymouslyAsync(); } /* * Populate a Dictionary<string,object> with the arguments and invoke the script. * Deserialize the response into a CloudCodeResponse object */ public async void OnClick() { var arguments = new Dictionary<string, object> { { "name", "Unity" } }; var response = await CloudCodeService.Instance.CallEndpointAsync<CloudCodeResponse>("hello-world", arguments); }}
Cloud Code 스크립트 배포
스크립트 엔드포인트에서 게임 클라이언트에 액세스할 수 있도록 하려면 Cloud Code 서비스에 스크립트를 배포해야 합니다. 스크립트 배포에 관해 자세히 알아보려면 스크립트 작성을 참고하십시오.UGS CLI 구성
다음 단계를 따라 UGS CLI를 시작합니다.- UGS CLI를 설치합니다.
-
다음과 같이 프로젝트 ID와 환경을 구성합니다.
ugs config set project-id <your-project-id>
ugs config set environment-name <your-environment-name> - Cloud Code와 환경 관리에 필요한 역할을 사용하여 서비스 계정을 구성합니다. 인증 받기를 참고하십시오.
스크립트 배포
다음 커맨드를 실행합니다.ugs deploy <path-to-js-file>다음 단계
첫 번째 스크립트를 배포한 후 다음 단계를 따릅니다.주제 | 설명 |
|---|---|
| 스크립트 실행 테스트 | 변경 사항을 게임 클라이언트에 퍼블리시하기 전에 스크립트를 테스트합니다. |
| 스크립트 구조 | 스크립트 구조를 익힙니다. |
| CI/CD와 연동 | 스크립트를 CI/CD 파이프라인과 연동합니다. |
연동
다른 서비스와 결합하면 Cloud Code가 더 강력해집니다.주제 | 설명 |
|---|---|
| 다른 Unity 서비스와 연동 | 다른 Unity 서비스를 호출하는 Cloud Code 스크립트를 작성합니다. |
| Cloud Code 서비스 SDK 기술 자료 | 스크립트에서 다른 Unity Gaming Services를 사용합니다. |
| 외부 서비스와 연동 | 공개 인터넷 엔드포인트를 호출합니다. |
| 사용 가능한 라이브러리 | Cloud Code 스크립트에서 사용할 수 있는 라이브러리를 확인합니다. |
| 사용 사례 | Cloud Code를 다른 서비스와 연동하기 위한 사용 사례 샘플을 참고합니다. |