Version: 2023.2
언어: 한국어
public static T GetObject (string key);

파라미터

key The key identifying the setting.

반환

T An instance of the object with fields assigned the corresponding remote values.

설명

Gets the object corresponding to the remote setting identified by key, if it exists.

Remote Settings constructs an object of type T and sets its fields or properties to the corresponding remote value, matching field name to key name. The process ignores fields in the object that do not correspond to a remote value and, likewise, ignores remote values that do not correspond to a field or property in the type.

If you do not specify a key when calling GetObject(), Remote Settings treats all of your remote settings as a single object. If you specify a key that does not exist, this function returns null.

Remote Settings converts numbers and boolean types, but it does not convert string types. For example, if you map a float setting to an integer field, the float value is cast to an integer. However, if you attempt to map a numeric or boolean setting to a string field, the string field is left as null. If a remote setting contains an object, that object is converted according to the type of the field in the parent object struct or class.

using UnityEngine;

public class HandleRemoteSettingsGetObject : MonoBehaviour { [System.Serializable] public struct MySettings { public bool enableBoss; public int maxLevelDifficulty; public string defaultPlayerName; public float gameBaseAcceleration; }

private void Start() { MySettings ms = RemoteSettings.GetObject<MySettings>("myGameSettings"); Debug.Log(ms.maxLevelDifficulty); } }

public static object GetObject (Type type, string key);

파라미터

key The key identifying the setting.
type The type of object represented in RemoteSettings.

반환

object An instance of the object with fields assigned the corresponding remote values.

설명

Gets the object corresponding to the remote setting identified by key, if it exists.

Remote Settings constructs an object of the type specified by the type parameter and sets its fields or properties to the corresponding remote value, matching field name to key name. The process ignores fields in the object that do not correspond to a remote value and, likewise, ignores remote values that do not correspond to a field or property in the type.

If you do not specify a key when calling GetObject(), Remote Settings treats all of your remote settings as a single object. If you specify a key that does not exist, this function returns null.

Remote Settings converts numbers and boolean types, but it does not convert string types. For example, if you map a float setting to an integer field, the float value is cast to an integer. However, if you attempt to map a numeric or boolean setting to a string field, the string field is left as null. If a remote setting contains an object, that object is converted according to the type of the field in the parent object struct or class.

using UnityEngine;

public class HandleRemoteSettingsGetObjectWithType : MonoBehaviour { [System.Serializable] public struct MyCustomSettings { public bool enableBoss; public int maxLevelDifficulty; public string defaultPlayerName; public float gameBaseAcceleration; }

private void Start() { MyCustomSettings ms = (MyCustomSettings)RemoteSettings.GetObject(typeof(MyCustomSettings), "myGameSettings"); Debug.Log(ms.maxLevelDifficulty); } }

public static object GetObject (string key, object defaultValue);

파라미터

defaultValue The object that should be for default values.
key The key identifying the setting.

반환

object An instance of the object with fields assigned the corresponding remote values.

설명

Gets the object corresponding to the remote setting identified by key, if it exists.

Remote Settings constructs an object of the type specified by the type parameter and sets its fields or properties to the corresponding remote value, matching field name to key name. The process ignores fields in the object that do not correspond to a remote value and, likewise, ignores remote values that do not correspond to a field or property in the type.

If you do not specify a key when calling GetObject(), Remote Settings treats all of your remote settings as a single object. If you specify a key that does not exist, this function returns null.

Remote Settings converts numbers and boolean types, but it does not convert string types. For example, if you map a float setting to an integer field, the float value is cast to an integer. However, if you attempt to map a numeric or boolean setting to a string field, the string field is left as null. If a remote setting contains an object, that object is converted according to the type of the field in the parent object struct or class.

using UnityEngine;

public class HandleRemoteSettingsGetObjectWithDefault : MonoBehaviour { [System.Serializable] public struct MySettingValues { public bool enableBoss; public int maxLevelDifficulty; public string defaultPlayerName; public float gameBaseAcceleration; }

private void Start() { MySettingValues defaultValue = new MySettingValues(); defaultValue.enableBoss = true; MySettingValues ms = (MySettingValues)RemoteSettings.GetObject("myGameSettings", defaultValue); Debug.Log(ms.maxLevelDifficulty); } }