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

일반적인 워크플로

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;

CloudCodeService.Instance

CallEndpointAsync

/// <summary>/// Calls a Cloud Code function./// </summary>/// <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>public async Task<TResult> CallEndpointAsync<TResult>(string function, Dictionary<string, object> args)

function

C# Monobehaviour 스크립트를 사용한 전체 연동 예시

diceSides

RollDice

JavaScript

const _ = require("lodash-4.17");module.exports = async ({ params, context, logger }) => {  const roll = rollDice(params.diceSides);  if (roll > params.diceSides) {    // Log an error message with information about the exception    logger.error("The roll is greater than the number of sides: " + roll);    // Return an error back to the client    throw Error("Unable to roll dice!");  }  return {    sides: params.diceSides,    roll: roll,  };};function rollDice(sides) {  return _.random(1, sides);}

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 to roll the dice (use a button)    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 Roll Dice script in Cloud Code        var response = await CloudCodeService.Instance.CallEndpointAsync<ResultType>("RollDice", new Dictionary<string, object>( ) { { "diceSides", 6 } });        // Log the response of the script in console        Debug.Log($"You rolled {response.Roll} / {response.Sides}");    }}

Start()

CallMethod()

    public void Start(){    CallMethod();}