기술 자료

지원

Remote Config

Remote Config

Remote Config SDK API 참조

Find the Remote Config SDK API you can use to fetch configurations, retrieve and set values, and handle configuration responses.
읽는 시간 1분최근 업데이트: 한 달 전

클래스

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 요청이 아직 처리 중임을 나타냅니다.