VR-WuKong/Packages/PICO Unity Integration SDK-3.3.2-20251111/Platform/Scripts/Service/Application.cs

/*******************************************************************************
Copyright © 2015-2022 PICO Technology Co., Ltd.All rights reserved.

NOTICE：All information contained herein is, and remains the property of
PICO Technology Co., Ltd. The intellectual and technical concepts
contained herein are proprietary to PICO Technology Co., Ltd. and may be
covered by patents, patents in process, and are protected by trade secret or
copyright law. Dissemination of this information or reproduction of this
material is strictly forbidden unless prior written permission is obtained from
PICO Technology Co., Ltd.
*******************************************************************************/

using System;
using Pico.Platform.Models;
using UnityEngine;
using SystemInfo = Pico.Platform.Models.SystemInfo;

namespace Pico.Platform
{
    /**
     * \ingroup Platform
     *
     * ApplicationService provides functions like launch other application,jump to store, get launch details.
     */
    public static class ApplicationService
    {
        /// <summary>
        /// Launches another app by app package name.
        /// @note If the user does not have that app installed, the user will be directed to the app's download page on the PICO Store.
        /// </summary>
        /// <param name="packageName">The package name of the to-be-launched app.</param>
        /// <param name="options">The options for launching the app. Pass `null` or leave this parameter empty.</param>
        /// <returns>If something goes wrong, a description message will be returned.</returns>
        public static Task<string> LaunchApp(string packageName, ApplicationOptions options = null)
        {
            if (!CoreService.Initialized)
            {
                Debug.LogError(CoreService.NotInitializedError);
                return null;
            }

            return new Task<string>(CLIB.ppf_Application_LaunchOtherApp(packageName, (IntPtr) options));
        }

        /// <summary>
        /// Launches another app by app ID.
        /// @note If the user does not have that app installed, the user will be directed to the app's download page on the PICO Store.
        /// </summary>
        /// <param name="appId">The ID of the to-be-launched app.</param>
        /// <param name="options">The options for launching the app. Pass `null` or leave this parameter empty.</param>
        /// <returns>If something goes wrong, a description message will be returned.</returns>
        public static Task<string> LaunchAppByAppId(string appId, ApplicationOptions options = null)
        {
            if (!CoreService.Initialized)
            {
                Debug.LogError(CoreService.NotInitializedError);
                return null;
            }

            return new Task<string>(CLIB.ppf_Application_LaunchOtherAppByAppID(appId, (IntPtr) options));
        }

        /// <summary>
        /// Launches the PICO Store app and go to the current app's details page.
        ///
        /// You can direct user to the PICO Store to upgrade the installed app by this
        /// method. To judge whether there is a new version in the PICO Store, you can call
        /// \ref GetVersion.
        ///
        /// @note
        /// * If the current app has never published in the PICO Store, the response error code is non-zero.
        /// * The current app will quit once the PICO Store app is launched.
        ///
        /// </summary>
        /// <returns>A string that describes the launch info.</returns>
        public static Task<string> LaunchStore()
        {
            if (!CoreService.Initialized)
            {
                Debug.LogError(CoreService.NotInitializedError);
                return null;
            }

            return new Task<string>(CLIB.ppf_Application_LaunchStore());
        }

        /// <summary>
        /// Gets the app's current version info and the latest version info.
        ///
        /// You can compare the current version info and the latest version info, and
        /// then decide whether to call \ref LaunchStore to direct users to the current app's details page to upgrade the app.
        /// </summary>
        /// <returns>The response will contain the latest version info in the PICO Store
        /// and the app's current version info.
        /// </returns>
        public static Task<ApplicationVersion> GetVersion()
        {
            if (!CoreService.Initialized)
            {
                Debug.LogError(CoreService.NotInitializedError);
                return null;
            }

            return new Task<ApplicationVersion>(CLIB.ppf_Application_GetVersion());
        }

        /// <summary>
        /// Gets the details about an app launch event.
        /// </summary>
        /// <returns>App launch details, including `LaunchResult` and `LaunchType`:
        /// * `LaunchResult`:
        ///   * `0`: Unknown
        ///   * `1`: Success 
        ///   * `2`: FailedRoomFull
        ///   * `3`: FailedGameAlreadyStarted
        ///   * `4`: FailedRoomNotFound
        ///   * `5`: FailedUserDeclined
        ///   * `6`: FailedOtherReason
        /// * `LaunchType`:
        ///   * `0`: Unknown
        ///   * `1`: Normal
        ///   * `2`: Invite
        ///   * `3`: Coordinated
        ///   * `4`: Deeplink
        /// </returns>
        public static LaunchDetails GetLaunchDetails()
        {
            if (!CoreService.Initialized)
            {
                Debug.LogError(CoreService.NotInitializedError);
                return null;
            }

            return new LaunchDetails(CLIB.ppf_ApplicationLifecycle_GetLaunchDetails());
        }
        
        /// <summary>
        /// Gets the device's system information synchronously. 
        /// </summary>
        /// <returns>A structure contains the device's system information, including the device's system version, language code,
        /// country/region code, product name, and more.</returns>
        public static SystemInfo GetSystemInfo()
        {
            if (!CoreService.Initialized)
            {
                Debug.LogError(CoreService.NotInitializedError);
                return null;
            }

            return new SystemInfo(CLIB.ppf_Application_GetSystemInfo());
        }

        /// <summary>
        /// Logs whether a user has been successfully directed to the desired destination via a deep link.
        /// </summary>
        /// <param name="trackId">The tracking ID of the app launch event.</param>
        /// <param name="result">The app launch result:
        /// * `0`: Unknown
        /// * `1`: Success
        /// * `2`: FailedRoomFull
        /// * `3`: FailedGameAlreadyStarted
        /// * `4`: FailedRoomNotFound
        /// * `5`: FailedUserDeclined
        /// * `6`: FailedOtherReason
        /// </param>
        public static void LogDeeplinkResult(string trackId, LaunchResult result)
        {
            CLIB.ppf_ApplicationLifecycle_LogDeeplinkResult(trackId, result);
        }

        /// <summary>
        /// When the launch intent is changed, you will receive this notification.
        /// Then you can call \ref GetLaunchDetails to retrieve the launch details.
        /// </summary>
        /// <param name="callback">The callback function.</param>
        public static void SetLaunchIntentChangedCallback(Message<string>.Handler callback)
        {
            Looper.RegisterNotifyHandler(MessageType.Notification_ApplicationLifecycle_LaunchIntentChanged, callback);
        }
    }


    public class ApplicationOptions
    {
        public ApplicationOptions()
        {
            Handle = CLIB.ppf_ApplicationOptions_Create();
        }


        public void SetDeeplinkMessage(string value)
        {
            CLIB.ppf_ApplicationOptions_SetDeeplinkMessage(Handle, value);
        }

        /// For passing to native C
        public static explicit operator IntPtr(ApplicationOptions options)
        {
            return options?.Handle ?? IntPtr.Zero;
        }

        ~ApplicationOptions()
        {
            CLIB.ppf_ApplicationOptions_Destroy(Handle);
        }

        readonly IntPtr Handle;
    }
}