코드 연동

RemoteConfig

Unity.Services

커스텀 속성 구현

struct

• 애플리케이션에서 전용 트래킹 방법을 사용하는 경우,

  SetCustomUserID

  메서드를 사용하여 커스텀 플레이어 ID 속성을 제공하려면

  Delivery

  구조체를 사용합니다. 개발자가 정의한 속성을 사용할 수 없으면 Remote Config는 ID를 자동으로 생성합니다.

• userAttributes

  구조체를 사용하여 커스텀 사용자 카테고리 속성을 제공합니다.

• appAttributes

  구조체를 사용하여 커스텀 앱 카테고리 속성을 제공합니다.

• filterAttributes

  구조체를 사용하여 커스텀 필터 카테고리 속성을 제공하면 페이로드를 줄일 수 있습니다.

using UnityEngine;using Unity.Services.RemoteConfig;using Unity.Services.Authentication;using Unity.Services.Core;using System.Threading.Tasks;public class RemoteConfigExample : MonoBehaviour {    public struct userAttributes {      // Optionally declare variables for any custom user attributes:        public bool expansionFlag;    }    public struct appAttributes {      // Optionally declare variables for any custom app attributes:        public int level;        public int score;        public string appVersion;    }    public struct filterAttributes {      // Optionally declare variables for attributes to filter on any of following parameters:        public string[] key;        public string[] type;        public string[] schemaId;    }    // Optionally declare a unique assignmentId if you need it for tracking:    public string assignmentId;    // Declare any Settings variables you’ll want to configure remotely:    public int enemyVolume;    public float enemyHealth;    public float enemyDamage;    // The Remote Config package depends on Unity's authentication and core services.    // These dependencies require a small amount of user code for proper configuration.    async Task InitializeRemoteConfigAsync()    {            // initialize handlers for unity game services            await UnityServices.InitializeAsync();            // options can be passed in the initializer, e.g if you want to set AnalyticsUserId or an EnvironmentName use the lines from below:            // var options = new InitializationOptions()            // .SetEnvironmentName("testing")            // .SetAnalyticsUserId("test-user-id-12345");            // await UnityServices.InitializeAsync(options);            // remote config requires authentication for managing environment information            if (!AuthenticationService.Instance.IsSignedIn)            {                await AuthenticationService.Instance.SignInAnonymouslyAsync();            }    }    async Task Awake () {        // In this example, you will fetch configuration settings on Awake.    }    // Create a function to set your variables to their keyed values:    void ApplyRemoteConfig (ConfigResponse configResponse) {        // You will implement this in the final step.    }}

런타임 시 설정 가져오기 및 적용

RemoteConfigService.Instance

ApplyRemoteConfig

ApplyRemoteConfig

ConfigResponse

RemoteConfigService.Instance.appConfig

    // Retrieve and apply the current key-value pairs from the service on Awake:async Task Awake () {    // initialize Unity's authentication and core services, however check for internet connection    // in order to fail gracefully without throwing exception if connection does not exist    if (Utilities.CheckForInternetConnection())     {        await InitializeRemoteConfigAsync();    }    // Add a listener to apply settings when successfully retrieved:    RemoteConfigService.Instance.FetchCompleted += ApplyRemoteConfig;    // you can set the user’s unique ID:    // RemoteConfigService.Instance.SetCustomUserID("some-user-id");    // you can set the environment ID:    // RemoteConfigService.Instance.SetEnvironmentID("an-env-id");    // Fetch configuration settings from the remote service, they must be called with the attributes structs (empty or with custom attributes) to initiate the WebRequest.    await RemoteConfigService.Instance.FetchConfigsAsync(new userAttributes(), new appAttributes());    // Example on how to fetch configuration settings using filter attributes:    // var fAttributes = new filterAttributes();    // fAttributes.key = new string[] { "sword","cannon" };    // RemoteConfigService.Instance.FetchConfigs(new userAttributes(), new appAttributes(), fAttributes);    // Example on how to fetch configuration settings if you have dedicated configType:    // var configType = "specialConfigType";    // Fetch configs of that configType    // RemoteConfigService.Instance.FetchConfigs(configType, new userAttributes(), new appAttributes());    // Configuration can be fetched with both configType and fAttributes passed    // RemoteConfigService.Instance.FetchConfigs(configType, new userAttributes(), new appAttributes(), fAttributes);    // All examples from above will also work asynchronously, returning Task<RuntimeConfig>    // await RemoteConfigService.Instance.FetchConfigsAsync(new userAttributes(), new appAttributes());    // await RemoteConfigService.Instance.FetchConfigsAsync(new userAttributes(), new appAttributes(), fAttributes);    // await RemoteConfigService.Instance.FetchConfigsAsync(configType, new userAttributes(), new appAttributes());    // await RemoteConfigService.Instance.FetchConfigsAsync(configType, new userAttributes(), new appAttributes(), fAttributes);}void ApplyRemoteConfig (ConfigResponse configResponse) {    // Conditionally update settings, depending on the response's origin:    switch (configResponse.requestOrigin) {        case ConfigOrigin.Default:            Debug.Log ("No settings loaded this session and no local cache file exists; using default values.");            break;        case ConfigOrigin.Cached:            Debug.Log ("No settings loaded this session; using cached values from a previous session.");            break;        case ConfigOrigin.Remote:            Debug.Log ("New settings loaded this session; update values accordingly.");            break;    }    enemyVolume = RemoteConfigService.Instance.appConfig.GetInt("enemyVolume");    enemyHealth = RemoteConfigService.Instance.appConfig.GetInt("enemyHealth");    enemyDamage = RemoteConfigService.Instance.appConfig.GetFloat("enemyDamage");    assignmentId = RemoteConfigService.Instance.appConfig.assignmentId;    // These calls could also be used with the 2nd optional arg to provide a default value, e.g:    // enemyVolume = RemoteConfigService.Instance.appConfig.GetInt("enemyVolume", 100);}

특정 구성 유형이 포함된 구성에 액세스

RemoteConfigService.Instance.GetConfig("settings");RemoteConfigService.Instance.GetConfig("specialConfigType");

메타데이터 파라미터

configs

metadata

• assignmentId

  는 각 할당 이벤트에서 생성되며 이벤트와 최종 사용자 세분화를 트래킹하는 데 사용됩니다.

• environmentId

  는 할당이 발생한 환경을 나타냅니다.

• configAssignmentHash

  는 할당 시 생성되며 특정 할당의 고유한 서명을 나타냅니다.

configAssignmentHash

appConfig

RemoteConfigService.Instance.appConfig.configAssignmentHash

configAssignmentHash

SetConfigAssignmentHash()

RemoteConfigService.Instance.SetConfigAssignmentHash("4d1064c5198a26f073fe8301da3fc5ead35d20d1"); 

configAssignmentHash

configAssignmentHash

configAssignmentHash

configAssignmentHash

그 외 고려할 사항

오브젝트 덮어쓰기를 위해 JSON 유형 Settings 활용

CubeInfo

[System.Serializable]public class CubeInfo{    public float rotateX = 10f;    public float rotateY = 10f;    public float rotateZ = 10f;    public float rotSpeed = 1.0f;    public Color color = Color.white;}

• 텍스트 에셋
• 스크립트 가능한 오브젝트
• 게임 오브젝트에 연결된 커스텀 스크립트

CubeInfo

case ConfigOrigin.Remote:var jsonCubeString = RemoteConfigService.Instance.appConfig.GetJson("jsonCubeString");JsonUtility.FromJsonOverwrite(jsonCubeString, CubeInfo);

보안

플랫폼 지원

• Windows(PC)
• Mac
• Linux 스탠드얼론

• iOS
• Android