App Features

Preparation

Remember, you need to configure and initialize the Magify Manager to work with app features.

Overview

Currently app features in our SDK can be conditionally divided into 2 types: value-features and stored app features. The main difference is that the list of value-features is loaded together with the values of features, while stored app features values are separate files and are loaded separately from the list of current features.

Usually you only need value-features, but when you want to pass some large amount of customization data, it is better to package it in a separate file and put it in stored app features.

Below are examples of how to use these types of features.

Value-features

The simplest use case might look like this:

public class WinScreen
{
    [SerializeField]
    private TextMeshProUGUI _rewardAmountText;
    [SerializeField]
    private GameObject _specialOfferIcon;

    public void Init()
    {
        // getting boolean feature by name
        var showSpecialOfferIcon = MagifyManager.Features.GetBool("win_screen_is_special_offer");
        _specialOfferIcon.SetActive(showSpecialOfferIcon);

        // default value
        var rewardAmount = 5.0;
        // trying to get number feature by name
        if (MagifyManager.Features.TryGetNumber("win_screen_reward_amount", out var amount))
            rewardAmount = amount;
        _rewardAmountText.text = rewardAmount.ToString(CultureInfo.InvariantCulture);
    }
}

Stored app features

One of the uses might be features that are important to start the app when you want the player to start the game with the actual settings.

public class Bootstrapper : MonoBehaviour
{
    private async void Start()
    {
        // your code ...
        // magify initialization code ...

        const string key = "startup_critical_features";
        if (MagifyManager.Features.StoredAppFeatures.TryGet(
                key, out var storedAppFeature))
        {
            var handle = await MagifyManager.Storage
                .LoadStoredAppFeature(
                    storedAppFeature.Url,
                    timeout: 5,
                    destroyCancellationToken);
            if (handle.Code == StorageResultCode.Success)
            {
                var criticalFeature = await handle.Value.LoadString()!;
                // load your game with these critical features values
            }
        }

        // your code ...
    }
}