Remote Config SDK API 참조
클래스
RemoteConfigService
public sealed class RemoteConfigService
이 클래스를 사용하여 런타임 시 구성 설정을 가져오고 적용합니다. RemoteConfigService
는 기본 ConfigManagerImpl
클래스의 기능을 모방하는 래퍼 클래스입니다. ConfigManagerImpl
클래스의 인스턴스를 사용하여 ConfigManagerImpl
의 기본 클래스를 만듭니다.
FetchCompleted
public event Action<ConfigResponse> FetchCompleted
이 이벤트는 구성 관리자가 서비스에서 설정을 성공적으로 가져오도록 작동합니다. 여기서는 Remote Config 가져오기의 응답을 나타내는 구조체가 반환됩니다.
appConfig
public RuntimeConfig appConfig
Remote Config 설정을 처리하기 위해 RuntimeConfig
오브젝트를 검색합니다. 이 프로퍼티를 사용하여 다음 메서드와 클래스에 액세스합니다.
메서드 | 설명 |
---|---|
public string assignmentID | 리포트 및 분석 목적으로 사용되는 고유한 문자열 식별자입니다. Remote Config 서비스에서 구성 요청 시 이 ID를 생성합니다. |
public bool GetBool (string key, bool defaultValue) | 원격 서비스에서 해당 키의 부울 값을 검색합니다(있는 경우). |
public float GetFloat (string key, float defaultValue) | 원격 서비스에서 해당 키의 플로트 값을 검색합니다(있는 경우). |
public long GetLong (string key, long defaultValue) | 원격 서비스에서 해당 키의 long 값을 검색합니다(있는 경우). |
public int GetInt (string key, int defaultValue) | 원격 서비스에서 해당 키의 정수 값을 검색합니다(있는 경우). |
public string GetString (string key, string defaultValue) | 원격 서비스에서 해당 키의 문자열 값을 검색합니다(있는 경우). |
public bool HasKey (string key) | 해당 키가 원격 설정에 있는지 확인합니다. |
public string[] GetKeys () | 원격 설정의 모든 키를 배열로 반환합니다. |
public string[] GetJson () | 원격 서비스에서 해당 키의 JSON 값을 나타내는 문자열을 반환합니다(있는 경우). |
GetConfig
public RuntimeConfig GetConfig(string configType)
configType을 전달하여 여러 구성 오브젝트에서 특정 구성을 검색합니다.
SetCustomUserID
public void SetCustomUserID(string customUserID)
Remote Config 전송 요청 페이로드에 관한 커스텀 사용자 식별자를 설정합니다.
SetEnvironmentID
public void SetEnvironmentID(string environmentID)
Remote Config 전송 요청 페이로드에 관한 환경 식별자를 설정합니다.
SetPlayerIdentityTokenID
public void SetPlayerIdentityTokenID(string playerIdentityTokenID)
플레이어 ID 토큰을 설정합니다.
SetUserID
public void SetUserID(string iid)
userId
를 주요 서비스에서 가져오는 InstallationID
식별자에 설정합니다.
SetPlayerID
public void SetPlayerID(string playerID)
Authentication 서비스에서 가져오는 플레이어 식별자를 설정합니다.
SetAnalyticsUserID
public void SetAnalyticsUserID(string analyticsUserID)
주요 서비스에서 가져오는 분석 사용자 식별자를 설정합니다.
SetConfigAssignmentHash
public void SetConfigAssignmentHash(string confiAssignmentHashID)
주요 서비스에서 가져오는 configAssignmentHash
식별자를 설정합니다.
FetchConfigsAsync
public Task<RuntimeConfig> FetchConfigsAsync<T, T2, T3>(string configType, T userAttributes, T2 appAttributes, T3 filterAttributes)
원격 서버에서 앱 구성 설정을 가져옵니다.
파라미터 | 설명 |
---|---|
configType | cofigType 이 포함된 문자열입니다. 적용되는 항목이 없으면 빈 문자열이 사용됩니다. |
userAttributes | 커스텀 사용자 속성이 포함된 구조체입니다. 적용되는 항목이 없으면 빈 구조체가 사용됩니다. |
appAttributes | 커스텀 앱 속성이 포함된 구조체입니다. 적용되는 항목이 없으면 빈 구조체가 사용됩니다. |
filterAttributes | 커스텀 필터 속성이 포함된 구조체입니다. 적용되는 항목이 없으면 빈 구조체가 사용됩니다. |
T | userAttributes 구조체 유형입니다. |
T2 | appAttributes 구조체 유형입니다. |
T3 | filterAttributes 구조체 유형입니다. |
열거형
ConfigOrigin
가장 최근에 로드된 구성 설정의 시작점을 설명하는 열거형입니다.
값 | 설명 |
---|---|
Default | 현재 세션에 로드된 구성 설정이 없음을 나타냅니다. |
Cached | 현재 세션에 로드된 구성 설정이 이전 세션에서 캐싱됨을 나타냅니다(즉, 로드된 새 구성 설정은 없음). |
Remote | 현재 세션의 원격 서버에서 로드된 새 구성 설정이 있음을 나타냅니다. |
ConfigRequestStatus
현재 Remote Config 요청의 상태를 나타내는 열거형입니다.
값 | 설명 |
---|---|
None | 생성된 Remote Config 요청이 없음을 나타냅니다. |
Failed | Remote Config 요청이 실패했음을 나타냅니다. |
Success | Remote Config 요청이 성공했음을 나타냅니다. |
Pending | Remote Config 요청이 아직 처리 중임을 나타냅니다. |