모듈 구조

namespace ModulesExample;public class Example{    private static string[] GetCheatCodes()    {        return new string[]        {            "LEAVEMEALONE",            "ASPIRINE",            "BIGBANG"        };    }    public void ChangeHaircut(string haircutName)    {    }}

Example

ChangeHaircut()

using ModulesExample;class UsageExample{    public void GameLoop()    {        Example.ChangeHaircut("buzzcut");        // Compile error "Cannot access private method 'GetCheatCodes()' here"        var cheatCodes = Example.GetCheatCodes();    }}

[CloudCodeFunction("ChangeHaircut")]

C# 프로젝트

├─ Main.csproj└─ Dependencies└─ HelloWorld.cs

Sample.sln├─ Main.csproj    └─ Dependencies    └─ HelloWorld.cs

Sample.sln├─ Main.csproj    └─ Dependencies    └─ HelloWorld.cs├─ Tests.csproj    └─ Dependencies    └─ Tests.cs├─ Other.csproj    └─ Dependencies    └─ Class1.cs

메인 프로젝트

CloudCodeFunction

CloudCodeFunction

샘플 프로젝트

Sample.sln├─ Main.csproj    └─ Dependencies    └─ HelloWorld.cs

Hello World!

Hello

using Unity.Services.CloudCode.Core;namespace Sample;public class HelloWorld{    [CloudCodeFunction("Hello")]    public string PrintHello()    {        return "Hello World!";    }}

Cloud Code NuGet 패키지

• com.Unity.Services.CloudCode.Core

  : 이 패키지에는

  CloudCodeFunction

  속성을 포함하여 Cloud Code의 핵심 기능이 포함되어 있습니다. 모든 Cloud Code 모듈에는 이 패키지가 필요합니다.

• com.Unity.Services.CloudCode.Apis

  : Cloud Code 서비스와 상호 작용하는 데 사용할 수 있는 Unity Gaming Services API가 포함된 선택적 패키지입니다. 이 패키지를 사용하여 Cloud Save 등 다른 Cloud Code SDK를 호출할 수 있습니다.

코드 구조

CloudCodeFunction 속성

CloudCodeFunction

메서드 서명

[CloudCodeFunction("FunctionName")]public async Task<ReturnType> FunctionName(IGameApiClient gameApiClient, IExecutionContext ctx, string parameter1, string parameter2){    ...}

async void

Task

Task<T>

모듈에 싱글톤 패턴 사용

IGameApiClient

IPushClient

파라미터에서 전달

기본형 및 복합형

int

string

bool

float

List<T>

Dictionary<T>

Dictionary<string, T>

string

List<string>

{  "params": {    "parameter1": "a",    "parameter2": ["b", "c"]  }}

[CloudCodeFunction("SimpleParams")]public async Task SimpleParams(IExecutionContext ctx, string parameter1, List<string> parameter2){  return parameter1 + parameter2[0] + parameter2[1];}

커스텀 유형

{  "params": {    "player": {      "name": "player",      "health": 50,      "stamina": 20,      "inventory": {        "count": 5,        "weight": 20      }    }  }}

Player

Inventory

public class Player{    public string Name { get; set; }    public int Health { get; set; }    public int Stamina { get; set; }    public Inventory Inventory { get; set; }}public class Inventory{    public int Count { get; set; }    public int Weight { get; set; }}[CloudCodeFunction("CustomParams")]public async Task<string> CustomParams(IExecutionContext ctx, Player player){    return $"{player.Name} has {player.Health} health and {player.Stamina} stamina and {player.Inventory.Count} items in their inventory with a total weight of {player.Inventory.Weight}";}

가용 인터페이스

IGameApiClient

IAdminApiClient

IPushClient

IExecutionContext

ICloudCodeSetup

IGameApiClient 인터페이스

IGameApiClient

IGameApiClient

1. 다음과 같이

   ICloudCodeSetup

   인터페이스를 구현하는 클래스를 정의하고

   GameApiClient

   를 싱글톤으로 추가합니다.

    public class ModuleConfig : ICloudCodeSetup{    public void Setup(ICloudCodeConfig config)    {        config.Dependencies.AddSingleton(GameApiClient.Create());    }}

2. IGameApiClient

   인터페이스를 함수 파라미터로 모듈 함수에 전달합니다.

IAdminApiClient 인터페이스

IAdminApiClient

IAdminApiClient

1. 다음과 같이

   ICloudCodeSetup

   인터페이스를 구현하는 클래스를 정의하고

   AdminApiClient

   를 싱글톤으로 추가합니다.

    public class ModuleConfig : ICloudCodeSetup{    public void Setup(ICloudCodeConfig config)    {        config.Dependencies.AddSingleton(AdminApiClient.Create());    }}

2. IAdminApiClient

   인터페이스를 함수 파라미터로 모듈 함수에 전달합니다.

IPushClient 인터페이스

IPushClient

IPushClient

1. 다음과 같이

   ICloudCodeSetup

   인터페이스를 구현하는 클래스를 정의하고

   PushClient

   를 싱글톤으로 추가합니다.

    public class ModuleConfig : ICloudCodeSetup{    public void Setup(ICloudCodeConfig config)    {        config.Dependencies.AddSingleton(PushClient.Create());    }}

2. PushClient

   오브젝트를 함수 파라미터로 모듈 함수에 전달합니다.

IExecution 컨텍스트

IExecutionContext

• ProjectId

  : 호출자가 인증을 받은 프로젝트 ID입니다.

• PlayerId

  : 스크립트를 실행한 플레이어 ID입니다. 참고: 서비스에서 스크립트를 호출하는 경우 플레이어 ID를 사용할 수 없습니다.

• EnvironmentId

  : 모듈의 환경 ID입니다.

• EnvironmentName

  : 모듈의 환경 이름입니다.

• AccessToken

  : 플레이어가 Cloud Code에서 인증하는 데 사용한 JWT(JSON 웹 토큰) 자격 증명입니다.

• UserId

  : 서비스 계정의 사용자 ID입니다. (참고: 서비스가 스크립트를 호출하는 경우 사용자 ID를 사용할 수 없습니다.)

• Issuer

  : 발급자 또는 서비스 계정 토큰입니다. (참고: 플레이어가 스크립트를 호출하는 경우 발급자를 사용할 수 없습니다.) 예를 들어 Multiplay가 호출을 생성하는 경우 발급자는

  multiplay

  입니다.

• ServiceToken

  : Cloud Code 서비스 계정 JWT 자격 증명입니다.

• AnalyticsUserId

  : 플레이어의 Analytics 사용자 ID입니다. (참고: 서비스가 스크립트를 호출하는 경우 Analytics 사용자 ID를 사용할 수 없습니다.)

• UnityInstallationId

  : 플레이어의 Unity 디바이스 설치 ID입니다. (참고: 서비스가 스크립트를 호출하는 경우 Unity 설치 ID를 사용할 수 없습니다.)

CloudCodeFunction

using Microsoft.Extensions.DependencyInjection;using Microsoft.Extensions.Logging;using Unity.Services.CloudCode.Apis;using Unity.Services.CloudCode.Core;using Unity.Services.CloudCode.Shared;namespace Sample;public class HelloWorld{    private static ILogger<HelloWorld> _logger;    public CloudSaveSdkSample(ILogger<HelloWorld> logger)    {        _logger = logger;    }    [CloudCodeFunction("GetData")]    public async Task<object> GetData(IExecutionContext context, IGameApiClient gameApiClient, string key)    {        try        {            var result = await gameApiClient.CloudSaveData.GetItemsAsync(context, context.AccessToken,                context.ProjectId, context.PlayerId, new List<string> { key });            return result.Data.Results.First().Value;        }        catch (ApiException ex)        {            _logger.LogError("Failed to get data from Cloud Save. Error: {Error}", ex.Message);            throw new Exception($"Failed to get data for playerId {ctx.PlayerId}. Error: {e.Message}");        }    }    public class ModuleConfig : ICloudCodeSetup    {        public void Setup(ICloudCodeConfig config)        {            config.Dependencies.AddSingleton(GameApiClient.Create());        }    }}

토큰 인증

AccessToken

ServiceToken

IExecutionContext

accessToken

AccessToken

serviceToken

ServiceToken

AccessToken

AccessToken

using Microsoft.Extensions.DependencyInjection;using Unity.Services.CloudCode.Apis;using Unity.Services.CloudCode.Core;using Unity.Services.CloudCode.Shared;using Unity.Services.CloudSave.Model;namespace TokenSample;public class TokenSample{    [CloudCodeFunction("GetKeysForAuthenticatedPlayer")]    public  Task<ApiResponse<GetKeysResponse>> GetPlayerKeys(IExecutionContext ctx, IGameApiClient gameApiClient)    {        try        {            // Using ctx.AccessToken to access the data for the player calling the function            return gameApiClient.CloudSaveData.GetKeysAsync(ctx, ctx.AccessToken, ctx.ProjectId, ctx.PlayerId);        }        catch (ApiException e)        {            throw new Exception($"Failed to get keys for playerId {ctx.PlayerId}. Error: {e.Message}");        }    }    public class ModuleConfig : ICloudCodeSetup    {        public void Setup(ICloudCodeConfig config)        {            config.Dependencies.AddSingleton(GameApiClient.Create());        }    }}

ServiceToken

playerId

using Microsoft.Extensions.DependencyInjection;using Unity.Services.CloudCode.Apis;using Unity.Services.CloudCode.Core;using Unity.Services.CloudCode.Shared;using Unity.Services.CloudSave.Model;namespace TokenSample;public class TokenSample{    [CloudCodeFunction("GetKeysForAnyPlayer")]    public  Task<ApiResponse<GetKeysResponse>> GetPlayerKeys(IExecutionContext ctx, IGameApiClient gameApiClient, string playerId)    {        try        {            // Using ctx.ServiceToken to access the data for any player            return gameApiClient.CloudSaveData.GetKeysAsync(ctx, ctx.ServiceToken, ctx.ProjectId, playerId);        } catch (ApiException e)        {            throw new Exception($"Failed to get keys for playerId {ctx.PlayerId}. Error: {e.Message}");        }    }    public class ModuleConfig : ICloudCodeSetup    {        public void Setup(ICloudCodeConfig config)        {            config.Dependencies.AddSingleton(GameApiClient.Create());        }    }}

Cloud Code 모듈 메타데이터

GET

{  "name": "string",  "language": "CS",  "tags": {    "property1": "string",    "property2": "string"  },  "signedDownloadURL": "string",  "dateCreated": "2022-04-05T09:12:13Z",  "dateModified": "2022-04-05T09:12:13Z"}

태그

서명된 다운로드 URL