Unity Runtime에서 호출

필수 조건

프로젝트 연결

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. 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를 초기화합니다.

일반적인 워크플로

1. Unity 엔진 내에서 C#

   MonoBehaviour

   스크립트를 생성합니다. Unity - 매뉴얼: 스크립트 생성 및 사용을 참고하십시오.

2. MonoBehaviour

   스크립트 내에서 Unity Authentication 서비스를 구성합니다.

3. MonoBehaviour

   스크립트 내에서 Cloud Code SDK에 호출을 추가합니다.
4. 게임 오브젝트에

   MonoBehaviour

   스크립트를 연결합니다. 에디터 스크립팅을 참고하십시오.
5. 플레이 버튼을 선택하고 프로젝트를 실행하여 Cloud Code가 작동하는지 확인합니다.

Authentication

await AuthenticationService.Instance.SignInAnonymouslyAsync();

using Unity.Services.Authentication;using System.Threading.Tasks;using Unity.Services.Core;using UnityEngine;public class AuthenticationExample : MonoBehaviour{    internal async Task Awake()    {        await UnityServices.InitializeAsync();        await SignInAnonymously();    }    private async Task SignInAnonymously()    {        AuthenticationService.Instance.SignedIn += () =>        {            var playerId = AuthenticationService.Instance.PlayerId;            Debug.Log("Signed in as: " + playerId);        };        AuthenticationService.Instance.SignInFailed += s =>        {            // Take some action here...            Debug.Log(s);        };        await AuthenticationService.Instance.SignInAnonymouslyAsync();    }}

Cloud Code 모듈 엔드포인트 호출

Using Unity.Services.CloudCode;

RollDice

HelloWorld

using System;using System.Threading.Tasks;using Unity.Services.CloudCode.Core;namespace HelloWorld;public class HelloWorld{    public class Response    {        public Response(int roll, int sides)        {            Roll = roll;            Sides = sides;        }        public int Roll { get; set; }        public int Sides { get; set; }    }    [CloudCodeFunction("RollDice")]    public async Task<Response> RollDice(int diceSides)    {        var random = new Random();        var roll = random.Next(1, diceSides);        return new Response(roll, diceSides);    }}

에디터 바인딩 사용

RollDiceExample

using Unity.Services.Authentication;using Unity.Services.CloudCode;using Unity.Services.CloudCode.GeneratedBindings;using Unity.Services.Core;using UnityEngine;public class RollDiceExample : 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            var module = new HelloWorldBindings(CloudCodeService.Instance);            var result = await module.RollDice(6);            Debug.Log($"You've rolled {result.Roll}/{result.Sides}");        }        catch (CloudCodeException exception)        {            Debug.LogException(exception);        }    }}

CallModuleEndpointAsync

CloudCodeService.Instance

CallModuleEndpointAsync

        /// <summary>        /// Calls a Cloud Code function.        /// </summary>        /// <param name="module">Cloud Code Module to call</param>        /// <param name="function">Cloud Code function to call.</param>        /// <param name="args">Arguments for the cloud code function. Will be serialized to JSON.</param>        /// <typeparam name="TResult">Serialized from JSON returned by Cloud Code.</typeparam>        /// <returns>Serialized output from the called function.</returns>        /// <exception cref="CloudCodeException">Thrown if request is unsuccessful.</exception>        /// <exception cref="CloudCodeRateLimitedException">Thrown if the service returned rate limited error.</exception>        Task<TResult> CallModuleEndpointAsync<TResult>(string module, string function, Dictionary<string, object> args = null);

• module

  파라미터는 모듈의 이름입니다.

• function

  파라미터는 모듈 엔드포인트의 이름으로,

  CloudCodeFunction

  속성으로 레이블을 지정한 것입니다.

• args

  파라미터는 모듈 엔드포인트에 전달할 파라미터의 딕셔너리입니다.

RollDiceExample

using System.Collections.Generic;using UnityEngine;using Unity.Services.Authentication;using Unity.Services.CloudCode;using Unity.Services.Core;public class RollDiceExample : MonoBehaviour{    // ResultType structure is the serialized response from the RollDice script in Cloud Code    private class ResultType    {        public int Roll;        public int Sides;    }    // Call this method    public async void CallMethod()    {        await UnityServices.InitializeAsync();        // Sign in anonymously into the Authentication service        if (!AuthenticationService.Instance.IsSignedIn) await AuthenticationService.Instance.SignInAnonymouslyAsync();        // Call out to the RollDice endpoint in the HelloWorld module in Cloud Code        var response = await CloudCodeService.Instance.CallModuleEndpointAsync<ResultType>("HelloWorld", "RollDice", new Dictionary<string, object>( ) { { "diceSides", 6 } });        // Log the response of the module endpoint in console        Debug.Log($"You rolled {response.Roll} / {response.Sides}");    }}

스크립트 실행

Start()

CallMethod()

    public void Start()    {        CallMethod();    }