AndroidAssetPacks.ShowConfirmationDialogAsync

Returns

ConfirmationDialogAsyncOperation Returns an object that represents the request operation. If you yield this object inside a coroutine, the coroutine pauses until the operation is complete.

Description

Displays a dialog that asks the user for consent to download asset packs that require user confirmation or WiFi connection.

If the device isn't connected to WiFi, large Android asset pack downloads pause until a WiFi connection is available. In this case, the asset pack has the AndroidAssetPackStatus.WaitingForWifi status. Asset packs can also have AndroidAssetPackStatus.RequiresUserConfirmation status if the current app version was not installed through the Google Play Store. In both situations, the asset packs require user consent to download. To get this consent, call ShowConfirmationDialogAsync to give the user the option to download your application's asset packs using mobile data or to update the app if a valid version isn't installed. This method directly wraps Google's PlayCore plugin API. If the PlayCore plugin is missing, calling this method throws an InvalidOperationException exception.

Additional resources: ConfirmationDialogAsyncOperation, AndroidAssetPacks.CancelAssetPackDownload, AndroidAssetPacks.DownloadAssetPackAsync, AndroidAssetPacks.GetAssetPackStateAsync, AndroidAssetPackStatus.RequiresUserConfirmation, AndroidAssetPackStatus.WaitingForWifi.

using System.Collections;
using UnityEngine;
using UnityEngine.Android;

public class ShowConfirmationDialogAsyncExample : MonoBehaviour
{
    bool isShowingDialog = false;

    void Start()
    {
        var assetPackNames = new string[] { "MyAssetPack" };

        // Start the download with a callback to monitor status changes.
        AndroidAssetPacks.DownloadAssetPackAsync(
            assetPackNames,
            info =>
            {
                Debug.Log($"{info.name}: {info.status}");

                if (!isShowingDialog &&
                    (info.status == AndroidAssetPackStatus.WaitingForWifi ||
                     info.status == AndroidAssetPackStatus.RequiresUserConfirmation))
                {
                    // Show a dialog asking the user for consent.
                    isShowingDialog = true;
                    StartCoroutine(HandleConfirmationDialog());
                }
            }
        );
    }

    IEnumerator HandleConfirmationDialog()
    {
        var dialogOperation = AndroidAssetPacks.ShowConfirmationDialogAsync();

        // Yield until the user responds.
        yield return dialogOperation;

        if (dialogOperation.result.consentGiven)
        {
            Debug.Log("User gave consent. Downloads will resume.");
        }
        else
        {
            Debug.Log("User denied consent. Downloads remain paused.");
        }

        isShowingDialog = false;
    }
}

Parameters

Description

Displays a dialog that asks the user for consent to download asset packs that require user confirmation or WiFi connection.

If the device isn't connected to WiFi, large Android asset pack downloads pause until a WiFi connection is available. In this case, the asset pack has the AndroidAssetPackStatus.WaitingForWifi status. Asset packs can also have AndroidAssetPackStatus.RequiresUserConfirmation status if the current app version was not installed through the Google Play Store. In both situations, the asset packs require user consent to download. To get this consent, call ShowConfirmationDialogAsync to give the user the option to download your application's asset packs using mobile data or to update the app if a valid version isn't installed. This method directly wraps Google's PlayCore plugin API. If the PlayCore plugin is missing, calling this method throws an InvalidOperationException exception.

Additional resources: AndroidAssetPackConfirmationDialogResult, AndroidAssetPacks.CancelAssetPackDownload, AndroidAssetPacks.DownloadAssetPackAsync, AndroidAssetPacks.GetAssetPackStateAsync, AndroidAssetPackStatus.RequiresUserConfirmation, AndroidAssetPackStatus.WaitingForWifi.

using UnityEngine;
using UnityEngine.Android;

public class ShowConfirmationDialogAsyncCallbackExample : MonoBehaviour
{
    // Call this when an asset pack download is waiting for user confirmation
    // (for example, when the status is WaitingForWifi or RequiresUserConfirmation).    
    public void ShowDialog()
    {
        AndroidAssetPacks.ShowConfirmationDialogAsync(OnDialogResult);
    }

    void OnDialogResult(AndroidAssetPackConfirmationDialogResult result)
    {
        if (result.consentGiven)
        {
            Debug.Log("User gave consent. Downloads will resume.");
        }
        else
        {
            Debug.Log("User denied consent. Downloads will remain paused.");
        }
    }
}