다른 Unity 서비스와 연동
Integrate Cloud Code with various Unity Gaming Services using C# Software Development Kits or REST APIs.
읽는 시간 2분최근 업데이트: 한 달 전
Cloud Code를 최대한 활용할 수 있도록 C# Service SDK나 REST API를 사용하여 다양한 Unity Gaming Services와 원활하게 연동시킬 수 있습니다. C# SDK는 Unity Gaming Services에 편하게 액세스하도록 지원하여 간단하고 더 일관성 있는 경험을 제공합니다. 사용하려는 Unity Gaming Services에 이미 Cloud Code C# SDK가 있으면 이를 활용하여 더 원활하게 연동할 수 있습니다. 하지만 특정 UGS 서비스에 Cloud Code C# SDK가 없는 경우 REST API를 통해 직접 연결하는 방법도 유연하게 제공됩니다.
UGS SDK를 통해 UGS에 연결
NuGet에서 Cloud Code C# 서비스 SDK에 액세스하려면 Com.Unity.Services.CloudCode.Apis를 검색하십시오. 패키지를 설치하면 C# 모듈 내에서 패키지를 사용하여 다른 Unity 서비스와 간편하게 연결할 수 있습니다.참고
참고: Cloud Code C# SDK 관련 기술 자료는 아직 완성되지 않았습니다. 자세한 내용은 구조가 유사한 JavaScript 기술 자료를 참고하십시오. IDE의 자동 완성 및 IntelliSense 기능도 함께 활용하십시오.
API 클라이언트
GameApiClientAdminApiClientGameApiClient 클래스 사용
GameApiClientGameApiClientICloudCodeSetupGameApiClientpublic class ModuleConfig : ICloudCodeSetup{ public void Setup(ICloudCodeConfig config) { config.Dependencies.AddSingleton(GameApiClient.Create()); }}
사용 예시
CloudCodeFunctionGameApiClientGameApiClientIGameApiClientusing Microsoft.Extensions.DependencyInjection;using Microsoft.Extensions.Logging;using Unity.Services.CloudCode.Apis;using Unity.Services.CloudCode.Core;using Unity.Services.CloudCode.Shared;using Unity.Services.CloudSave.Model;namespace ExampleModule;public class CloudSaveSdkSample{ private static ILogger<CloudSaveSdkSample> _logger; public CloudSaveSdkSample(ILogger<CloudSaveSdkSample> logger) { _logger = logger; } [CloudCodeFunction("SaveData")] public async Task SaveData(IExecutionContext context, IGameApiClient gameApiClient, string key, object value) { try { await gameApiClient.CloudSaveData.SetItemAsync(context, context.AccessToken, context.ProjectId, context.PlayerId, new SetItemBody(key, value)); } catch (ApiException ex) { _logger.LogError("Failed to save data. Error: {Error}", ex.Message); throw new Exception($"Failed to save data for playerId {context.PlayerId}. Error: {ex.Message}"); } } [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. Error: {Error}", ex.Message); throw new Exception($"Failed to get data for playerId {context.PlayerId}. Error: {ex.Message}"); } } public class ModuleConfig : ICloudCodeSetup { public void Setup(ICloudCodeConfig config) { config.Dependencies.AddSingleton(GameApiClient.Create()); } }}
AdminApiClient 클래스 사용
AdminApiClientAdminApiClientICloudCodeSetupAdminApiClientpublic class ModuleConfig : ICloudCodeSetup{ public void Setup(ICloudCodeConfig config) { config.Dependencies.AddSingleton(AdminApiClient.Create()); }}
사용 예시
GameApiClientAdminApiClientAdminApiClientIAdminApiClient참고
참고: Admin SDK로 관리자 기능을 사용하려면 프로젝트 역할을 갖춘 유효한 서비스 계정 자격 증명이 있어야 합니다. 서비스 계정을 만들려면 관리자 인증을 참고하십시오.
Leaderboards Admin중요
주의: Cloud Code 예시는 하드 코딩된 플레인 텍스트 서비스 계정 자격 증명 사용에 관해 보여 줍니다. 보안 암호가 있는 자격 증명과 코드를 다룰 때는 주의를 기울여 사용하십시오. 보안을 강화하려면 버전 관리에 보안 암호를 커밋하지 않는 것을 권장합니다. 자격 증명이 손상된 경우 즉시 서비스 계정 자격 증명을 재생성할 수 있습니다. Cloud Code에 자격 증명을 저장하는 보다 안전한 방법을 개발하고 있습니다.
using Microsoft.Extensions.DependencyInjection;using Microsoft.Extensions.Logging;using Unity.Services.CloudCode.Apis;using Unity.Services.CloudCode.Apis.Admin;using Unity.Services.CloudCode.Core;using Unity.Services.CloudCode.Shared;using Unity.Services.Leaderboards.Admin.Model;namespace ExampleModule;public class ModuleMain{ private static ILogger<ModuleMain> _logger; public ModuleMain(ILogger<ModuleMain> logger) { _logger = logger; } [CloudCodeFunction("CreateLeaderboard")] public async Task CreateLeaderboard(IExecutionContext context, IAdminApiClient adminApiClient) { try { await adminApiClient.Leaderboards.CreateLeaderboardAsync( executionContext: context, serviceAccountKey: "YOUR_SERVICE_ACCOUNT_KEY", serviceAccountSecret: "YOUR_SERVICE_ACCOUNT_SECRET", projectId: Guid.Parse(context.ProjectId), environmentId: Guid.Parse(context.EnvironmentId), leaderboardIdConfig: new LeaderboardIdConfig( id: "new-leaderboard", name: "new-leaderboard", sortOrder: SortOrder.Asc, updateType: UpdateType.KeepBest ) ); } catch (ApiException ex) { _logger.LogError("Failed to create a Leaderboard. Error: {Error}", ex.Message); throw new Exception($"Failed to create a Leaderboard. Error: {ex.Message}"); } } public class ModuleConfig : ICloudCodeSetup { public void Setup(ICloudCodeConfig config) { config.Dependencies.AddSingleton(AdminApiClient.Create()); } }}
REST API를 통해 UGS에 연결
아직 C# SDK가 없는 서비스를 사용하려는 경우, REST API를 통해 직접 서비스를 연결할 수 있습니다.Authentication
사용 사례에 따라AccessTokenServiceTokenServiceToken참고
참고: 호출하려는 서비스에서 Cloud Code C# SDK를 제공하는 경우, 서비스 API를 직접 호출하는 대신 SDK를 사용할 수 있습니다. 자세한 내용은 사용 가능한 라이브러리 목록을 참고하십시오.
API 호출
종속성 삽입을 사용하면 API 인터페이스를 싱글톤으로 생성하여 모듈에 삽입할 수 있습니다.참고
UGS API 외에도 외부 API를 싱글톤으로 구현할 수 있습니다. 외부 API를 구현하는 방법에 대한 예시는 외부 서비스와 연동하는 방법에 대한 기술 자료를 참고하십시오.