수동 워크플로

1. .NET 프로젝트 생성: Cloud Code 모듈은 게임 클라이언트가 호출할 수 있는 엔드포인트를 공개하는 단순한 .NET 프로젝트입니다.
2. Cloud Code Authoring 패키지 임포트: Cloud Code Authoring 패키지를 설치하여 호출 가능한 엔드포인트를 만듭니다.
3. 프로젝트 내부에 모듈 엔드포인트 생성: 게임 클라이언트에서 호출할 수 있는 게임 로직을 정의합니다.
4. 코드 패키징: 프로젝트용 어셈블리를 생성하고 아카이브로 패키징합니다.
5. 프로젝트 배포: Cloud Code 서비스에 아카이브를 배포합니다.
6. 모듈 엔드포인트 호출: 게임 클라이언트에서 모듈 엔드포인트를 호출합니다.

.NET 프로젝트 생성

JetBrains Rider

1. File > New를 선택합니다.
2. Class Library로 .NET Core 또는 .NET Framework를 선택합니다.
3. 모듈의 이름을 지정합니다.
4. Create를 선택합니다.

Microsoft Visual Studio

1. File > New Solution을 선택합니다.
2. .Net Class Library를 선택합니다.
3. Next를 선택합니다.
4. 모듈의 이름을 지정합니다.
5. Create를 선택합니다.

Cloud Code Authoring 패키지 임포트

JetBrains Rider

1. Tools > NuGet > Show NuGet Packages를 선택합니다.

2. Com.Unity.Services.CloudCode.Core

   를 검색합니다.
3. 최신 버전을 프로젝트에 설치합니다.

Microsoft Visual Studio

1. 프로젝트를 오른쪽 클릭하고 Manage NuGet Packages를 선택합니다.

2. Com.Unity.Services.CloudCode.Core

   를 검색합니다.
3. Add Package를 선택합니다.

모듈 엔드포인트 생성

CloudCodeFunction

name

SayHello

using Unity.Services.CloudCode.Core;namespace ExampleModule;public class MyModule{    [CloudCodeFunction("SayHello")]    public string Hello(string name)    {        return $"Hello, {name}!";    }}

코드 패키징

linux-x64

ReadyToRun

• 어셈블리 생성 방법에 관한 자세한 내용은 코드 패키징을 참고하십시오.
• 이 프로세스를 자동화하는 방법에 관한 자세한 내용은 로컬 배포 자동화를 확인하시기 바랍니다.

JetBrains Rider

1. Run > Edit Configurations를 선택합니다.
2. + 를 선택합니다.
3. Publish to folder를 선택합니다.
4. 구성의 이름을 지정합니다.
5. Target location을 빌드 출력을 저장할 위치로 설정합니다.
6. Release | Any CPU 구성을 선택합니다.
7. linux-x64 타겟 런타임을 선택합니다.
8. (선택 사항) Enable ReadyToRun compilation을 활성화합니다.
9. Apply를 선택합니다.

Microsoft Visual Studio

1. 솔루션을 오른쪽 클릭한 다음 Publish를 선택합니다.
2. 화면에 표시된 단계에 따라 파일을 로컬에 저장합니다.
3. Show All Settings를 선택합니다.
4. 타겟 런타임을 linux-x64로 설정합니다.
5. Save를 선택합니다.
6. Publish를 선택합니다.

어셈블리 압축

bin/Release/net6.0/linux-x64/publish

zip ExampleModule.ccm *

zip -r ExampleModule.ccm path/to/your/project/bin/Release/net6.0/linux-x64/publish/*

모듈 프로젝트 배포

UGS CLI 구성

1. UGS CLI를 설치합니다.
2. 다음 커맨드를 사용하여 프로젝트 ID와 환경을 구성합니다.
   

   ugs config set project-id <your-project-id>

   
   

   ugs config set environment-name <your-environment-name>

3. Cloud Code와 환경 관리에 필요한 역할을 사용하여 서비스 계정을 구성합니다. 인증 받기를 참고하십시오.

모듈 배포

ugs deploy <path-to-ccm-file>

게임에서 모듈 함수 호출

필수 조건

프로젝트 연결

1. Unity 에디터에서 Edit > Project Settings > Services를 선택합니다.
2. 프로젝트를 연결합니다.
   프로젝트에 Unity 프로젝트 ID가 없는 경우 다음 단계를 진행합니다.
   1. Create a Unity Project ID > Organizations를 선택한 다음 드롭다운에서 조직을 선택합니다.
   2. Create project ID를 선택합니다.
   
   Unity 프로젝트 ID가 있는 경우 다음 단계를 진행합니다.
   1. Use an existing Unity project ID를 선택합니다.
   2. 드롭다운에서 조직과 프로젝트를 선택합니다.
   3. Link project ID를 선택합니다.

UnityEditor.CloudProjectSettings.projectId

SDK 설치

1. Unity 에디터에서 Window > Package Manager를 엽니다.
2. Package Manager에서 Unity Registry 목록 뷰를 선택합니다.

3. com.unity.services.cloudcode

   를 검색하거나 목록에서 Cloud Code 패키지를 찾습니다.
4. 패키지를 선택하고 Install을 클릭합니다.

SDK 설정

1. Unity Dashboard의 Cloud Code 페이지를 통해 서비스를 활성화합니다.
2. Cloud Code와 Authentication SDK를 모두 설치합니다.
3. Edit > Project Settings > Services를 선택하여 Unity 에디터 내에서 클라우드 프로젝트에 로그인합니다.
4. Unity 에디터에서 새 C# Monobehaviour 스크립트를 생성합니다. Unity 매뉴얼의 스크립트 생성 및 사용을 참고하십시오.
5. 스크립트에서 await

   UnityServices.InitializeAsync()

   를 사용하여 Core SDK를 초기화합니다.
6. 스크립트에서 Authentication SDK를 초기화합니다.

await AuthenticationService.Instance.SignInAnonymouslyAsync();

모듈 함수 호출

1. Services Core SDK를 초기화합니다. Cloud Code를 호출하기 전에 Services Core 네임스페이스(

   Unity.Services.Core

   )를 임포트하여 게임 코드에서 Unity 서비스를 초기화한 다음

   InitializeAsync

   메서드를 호출합니다.
2. 호출을 인증합니다. Cloud Code 서비스에 액세스하려면 Cloud Code에 대한 각 호출을 인증해야 하며 플레이어에게 유효한 플레이어 ID와 액세스 토큰이 있어야 합니다. 인증을 참고하십시오.

   SignInAnonymouslyAsync

   메서드를 호출하여 익명 인증으로 시작하는 것이 좋습니다.
3. 모듈 함수를 호출합니다. Cloud Code SDK를 통해

   CallEndpointModuleAsync

   메서드를 사용하여 모듈 함수를 호출합니다.

CallEndpointModuleAsync

연동 샘플

ExampleModule

SayHello

using System.Collections.Generic;using Unity.Services.Authentication;using Unity.Services.CloudCode;using Unity.Services.Core;using UnityEngine;public class TestModule : MonoBehaviour{    private async void Start()    {        // Initialize the Unity Services Core SDK        await UnityServices.InitializeAsync();        // Authenticate by logging into an anonymous account        await AuthenticationService.Instance.SignInAnonymouslyAsync();        try        {            // Call the function within the module and provide the parameters we defined in there            string result = await CloudCodeService.Instance.CallModuleEndpointAsync("ExampleModule", "SayHello", new Dictionary<string, object> {{"name", "World"}});            Debug.Log(result);        }        catch (CloudCodeException exception)        {            Debug.LogException(exception);        }    }}

Hello, World!