Unity 权限之 Android 【权限动态申请】功能的简单封装

一、简单介绍

二、Android 权限动态申请

三、实现原理

四、注意事项

五、案例实现简单步骤

附录：

一、进一步优化

二、多个权限申请代码参考

一、简单介绍

Unity 是一个功能强大的跨平台游戏引擎，广泛用于开发视频游戏和其他实时3D互动内容，如模拟器和虚拟现实应用。

游戏引擎：

Unity：Unity Technologies 开发的跨平台游戏引擎，支持2D和3D图形、物理引擎、音频、视频、网络和多平台发布。
跨平台支持：Unity 支持在多个平台上发布，包括 Windows、macOS、Linux、iOS、Android、WebGL、PlayStation、Xbox、Switch 等。

开发环境：

Unity Editor：用于创建和管理 Unity 项目的集成开发环境（IDE）。开发者可以在其中创建场景、设计关卡、编写代码和调试游戏。
场景（Scene）：Unity 中的基本构建块，一个场景可以被视为一个关卡或一个游戏中的独立部分。

编程语言：

C#：主要编程语言。Unity 使用 C# 脚本来控制游戏对象和实现游戏逻辑。
UnityScript（已弃用）：曾经支持的 JavaScript 变种，但已经被弃用。

Unity 进阶开发涉及更复杂的技术和更深入的知识，以创建高性能、复杂和专业的游戏和应用程序。以下是一些 Unity 进阶开发的关键领域和技术：

设计模式：

学习和应用常见的设计模式（如单例模式、工厂模式、观察者模式）以便更好地组织和管理代码。

异步编程：

使用 C# 的 async 和 await 关键字进行异步编程，以提高应用的响应速度和性能。

依赖注入：

使用依赖注入（如 Zenject）来管理对象的依赖关系，减少耦合，提高代码的可测试性和可维护性。

二、Android 权限动态申请

在开发 Unity Android 应用时，动态获取权限是一个常见的需求。由于 Android 6.0（API 级别 23）引入了运行时权限模型，应用必须在运行时请求某些权限。下面是一个如何在 Unity 中封装动态获取权限功能的示例。

在 Unity 中，仅使用 C# 代码来处理 Android 动态权限请求是可能的，但仍需要调用 Android 的原生 API。这可以通过 AndroidJavaClass 和 AndroidJavaObject 来实现。

三、实现原理

PermissionManager 是一个用于管理 Android 权限请求的单例类。其主要功能是动态请求权限并在用户响应后处理结果。以下是其工作原理和实现步骤的详细解释：

单例模式：
- PermissionManager 使用单例模式确保在整个应用生命周期中只有一个实例。
权限请求接口：
- RequestPermission 方法用于请求特定的权限。
- 首先检查权限是否已经授予，如果已授予则立即调用回调函数返回结果。
- 如果权限未授予，启动协程 RequestAndCheckPermission 请求权限并等待用户响应。
协程处理：
- RequestAndCheckPermission 方法通过协程 IEnumerator 实现异步等待。
- 使用 Permission.RequestUserPermission 方法请求权限。
- 使用 yield return new WaitForSeconds(1.0f) 等待一段时间，让用户有足够时间响应权限请求。
- 等待结束后，再次检查权限状态并调用回调函数返回结果。

四、注意事项

权限列表：
- 确保在 AndroidManifest.xml 中声明所有需要请求的权限，否则请求可能会失败。
- 例如：
```
<uses-permission android:name="android.permission.CAMERA" />
```
权限请求的异步性：
- 用户响应权限请求的时间是不确定的。使用协程 (IEnumerator) 异步等待用户响应而不阻塞主线程是必要的。
- yield return new WaitForSeconds(1.0f) 是一个简单的等待机制，实际项目中可能需要更复杂的逻辑来处理用户的响应。
回调函数：
- 确保传递给 RequestPermission 的回调函数能正确处理权限被授予或拒绝的情况。
- 回调函数签名为 System.Action<string, bool>，其中第一个参数是权限名，第二个参数是权限是否被授予的布尔值。
用户体验：
- 提示用户为什么需要请求特定权限，以提高用户接受权限请求的概率。
- 在权限被拒绝后，提供适当的反馈和处理机制，如再次请求权限或退出相关功能。
多权限请求：
- 当前示例处理单个权限请求。如果需要请求多个权限，可以扩展 PermissionManager 类以支持批量请求，并分别处理每个权限的授予结果。

五、案例实现简单步骤

1、新建一个 Unity 工程

2、新建脚本 PermissionWrapper 封装权限申请功能

3、新建脚本 TestPermissionWrapper 测试封装权限申请功能，申请 camera 权限

4、把 TestPermissionWrapper 挂载到场景中

5、在 Player Settings 中的 Build 中勾选 Custom Main Manifest ，添加 Camera 权限申请

6、打包运行

六、关键代码

1、PermissionWrapper


using UnityEngine;
using UnityEngine.Android;

public class PermissionWrapper : MonoSingleton<PermissionWrapper>
{
    /// <summary>
    /// 请求权限
    /// </summary>
    /// <param name="permission">权限名称</param>
    /// <param name="callback">权限回调：true 权限获取成功回调，false 权限获取失败回调</param>
    public void RequestPermission(string permission, System.Action<string, bool> callback)
    {
        if (Permission.HasUserAuthorizedPermission(permission))
        {
            callback?.Invoke(permission, true);
        }
        else
        {
            StartCoroutine(RequestAndCheckPermission(permission, callback));
        }
    }

    /// <summary>
    /// 协程请求权限
    /// </summary>
    /// <param name="permission">权限名称</param>
    /// <param name="callback">权限回调：true 权限获取成功回调，false 权限获取失败回调</param>
    /// <returns></returns>
    private System.Collections.IEnumerator RequestAndCheckPermission(string permission, System.Action<string, bool> callback)
    {
        Permission.RequestUserPermission(permission);
        yield return new WaitForSeconds(1.0f);

        bool granted = Permission.HasUserAuthorizedPermission(permission);
        callback?.Invoke(permission, granted);
    }
}

2、TestPermissionWrapper


using UnityEngine;
using UnityEngine.Android;

public class TestPermissionWrapper : MonoBehaviour
{
    private void Start()
    {
        // 请求摄像头权限
        PermissionWrapper.Instance.RequestPermission(Permission.Camera, OnPermissionResult);
    }

    private void OnPermissionResult(string permission, bool granted)
    {
        if (granted)
        {
            Debug.Log("权限已授予: " + permission);
            // 执行需要权限的功能
        }
        else
        {
            Debug.Log("权限被拒绝: " + permission);
            // 处理权限被拒绝的情况
        }
    }
}

3、MonoSingleton

using System;
using UnityEngine;

public abstract class MonoSingleton<T> : MonoBehaviour where T : MonoSingleton<T>
{
    private static T m_Instance;

    public static T Instance
    {
        get
        {
            if ((UnityEngine.Object)m_Instance == (UnityEngine.Object)null)
            {
                T[] array = UnityEngine.Object.FindObjectsOfType<T>();
                if (array != null && array.Length != 0)
                {
                    if (array.Length != 1)
                    {
                        throw new Exception($"## Uni Exception ## Cls:{typeof(T)} Info:Singleton not allows more than one instance");
                    }

                    m_Instance = array[0];
                }
                else
                {
                    m_Instance = new GameObject($"{typeof(T).ToString()}(Singleton)").AddComponent<T>();
                    m_Instance.OnSingletonInit();
                }
            }

            return m_Instance;
        }
    }

    protected virtual void Awake()
    {
        m_Instance = this as T;
    }

    protected virtual void OnDestroy()
    {
        m_Instance = null;
    }

    protected virtual void OnSingletonInit()
    {
    }
}

4、AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.unity3d.player"
    xmlns:tools="http://schemas.android.com/tools">
    
    <!--相机权限-->
    <uses-permission android:name="android.permission.CAMERA" />
  
    <application>
        <activity android:name="com.unity3d.player.UnityPlayerActivity"
                  android:theme="@style/UnityThemeSelector">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
        </activity>
    </application>
</manifest>

附录：

一、进一步优化

用户提示：在请求权限前，先提示用户为何需要该权限，增强用户接受度。
多权限支持：实现多权限同时请求的逻辑。
超时处理：考虑在等待用户响应时添加超时处理逻辑，避免无限期等待。
权限变更监听：实现权限变更监听，当用户在应用设置中更改权限时做出相应处理。

通过这些改进和注意事项，可以确保权限请求功能更加健壮和用户友好。

二、多个权限申请代码参考

1、PermissionJudgeMgr

using FfalconXR;
using FFALFramework.UIModule;
using System;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.Android;

public class PermissionJudgeMgr : MonoSingleton<PermissionJudgeMgr>
{
    #region Data
    /// <summary>
    /// TAG
    /// </summary>
    const string TAG = "[PermissionJudgeMgr] ";

	/// <summary>
	/// 权限申请列表
	/// </summary>
	List<IRequestPermissionItem> m_RequestPermissionItemLst;

    /// <summary>
    /// 请求权限回调
    /// </summary>
    private PermissionCallbacks m_PermissionCallbacks;

    /// <summary>
    /// 全部权限允许后的事件
    /// </summary>
    public Action OnAllPermissionGrantedAction;

    /// <summary>
    /// 判断是否有权限
    /// </summary>
    public bool IsHasPermission { get { return JudgeIsHasPermission(); } }
    #endregion

    #region public function

    /// <summary>
    /// 检测 权限
    /// </summary>
    public void CheckAppPermission()
    {
        CheckRequestPermissionLst();
    }

    #endregion

    #region 生命周期
    /// <summary>
    /// OnSingletonInit
    /// </summary>
    protected override void OnSingletonInit()
    {
        base.OnSingletonInit();
        
        RegisterPermissionListener();
    }
    /// <summary>
    /// OnDestroy
    /// </summary>
    protected override void OnDestroy()
    {
        base.OnDestroy();
        UnRegisterPermissionListener();
    }

    #endregion

    #region private function

    /// <summary>
    /// 检测权限队列
    /// </summary>
    private void CheckRequestPermissionLst() {

        IRequestPermissionItem requestPermissionItem = null;
        foreach (var item in m_RequestPermissionItemLst)
        {
            if (item.IsHasPermission == false)
            {
                requestPermissionItem = item;
                break;
            }
        }

        if (requestPermissionItem != null)
        {
            requestPermissionItem.RequestPermission(m_PermissionCallbacks);
        }
        else
        {
            OnAllPermissionGrantedAction?.Invoke();
        }
    }

    /// <summary>
    /// 注册权限监听
    /// </summary>
    private void RegisterPermissionListener()
    {
        UIManager.Instance.QuitAll();

        AddRequestPermissionItem();

        m_PermissionCallbacks = new PermissionCallbacks();
        //对系统权限处理的回调
        m_PermissionCallbacks.PermissionGranted += OnPermissionGranted;
        m_PermissionCallbacks.PermissionDenied += OnPermissionDenied;
    }

    /// <summary>
    /// 取消权限监听
    /// </summary>
    private void UnRegisterPermissionListener()
    {
        m_PermissionCallbacks.PermissionGranted -= OnPermissionGranted;
        m_PermissionCallbacks.PermissionDenied -= OnPermissionDenied;
        m_PermissionCallbacks = null;
        OnAllPermissionGrantedAction = null;
        m_RequestPermissionItemLst.Clear();
        m_RequestPermissionItemLst = null;
    }

    /// <summary>
    /// 权限授予事件
    /// </summary>
    /// <param name="Permission"></param>
    private void OnPermissionGranted(string Permission)
    {
        MainThreadQueue.Instance.ExecuteQueue.Enqueue(() =>
        {
            Debug.Log(TAG+"OnPermissionGranted():" + Permission);
            
            // 继续请求其他权限
            CheckRequestPermissionLst();

        });
    }

    /// <summary>
    /// 权限拒绝事件
    /// </summary>
    /// <param name="Permission"></param>
    private void OnPermissionDenied(string Permission)
    {
        MainThreadQueue.Instance.ExecuteQueue.Enqueue(() =>
        {
            Debug.Log(TAG + "OnPermissionDenied():" + Permission);

            // Todo 提示：1、打开失败页界面；2、然后可以继续请求权限
            
        });
    }

    /// <summary>
    /// 添加权限申请判断
    /// </summary>
    private void AddRequestPermissionItem() {
        m_RequestPermissionItemLst = new List<IRequestPermissionItem>();

        // 相机权限获取
        m_RequestPermissionItemLst.Add(new CameraRequestPermissionItem());

        // 麦克风权限获取
        m_RequestPermissionItemLst.Add(new MicrophoneRequestPermissionItem());

        // 继续添加更多...
    }

    /// <summary>
    /// 判断是否有权限没有申请
    /// </summary>
    /// <returns></returns>
    private bool JudgeIsHasPermission() {
        if (m_RequestPermissionItemLst == null) return true;
        else {
            foreach (var item in m_RequestPermissionItemLst)
            {
                if (item.IsHasPermission == false) return false;
            }
        }

        return true;
    }

    #endregion
}

2、CameraRequestPermissionItem


using UnityEngine.Android;

public class CameraRequestPermissionItem : BaseRequestPermissionItem
{
    /// <summary>
    /// TAG
    /// </summary>
    protected override string TAG { get; } = "[CameraRequestPermissionItem] ";

    /// <summary>
    /// 去申请的权限名称
    /// </summary>
    public override string ToRequestPermissionName => Permission.Camera;
}

3、MicrophoneRequestPermissionItem

using UnityEngine.Android;

public class MicrophoneRequestPermissionItem : BaseRequestPermissionItem
{
    /// <summary>
    /// TAG
    /// </summary>
    protected override string TAG { get; } = "[MicrophoneRequestPermissionItem] ";

    /// <summary>
    /// 去申请的权限名称
    /// </summary>
    public override string ToRequestPermissionName => Permission.Microphone;
}

4、BaseRequestPermissionItem


using UnityEngine;
using UnityEngine.Android;

public class BaseRequestPermissionItem : IRequestPermissionItem
{
    #region Data

    /// <summary>
    /// TAG
    /// </summary>
    protected virtual string TAG { get; } = "[BaseRequestPermissionItem] ";

    /// <summary>
    /// 去申请的权限名称
    /// </summary>
    public virtual string ToRequestPermissionName => Permission.Camera;

    /// <summary>
    /// 判断是否有权限
    /// </summary>
    public virtual bool IsHasPermission => Permission.HasUserAuthorizedPermission(ToRequestPermissionName);

    #endregion

    #region Interface function

    /// <summary>
    /// 请求权限
    /// </summary>
    /// <param name="permissionCallbacks">权限回调事件</param>
    public virtual void RequestPermission(PermissionCallbacks permissionCallbacks)
    {
        if (permissionCallbacks == null) {
            Debug.LogError(TAG + " RequestPhoneStatePermission() permissionCallbacks is null ");
            return;
        }

        if (!IsHasPermission)
        {
            Debug.Log(TAG+ " RequestPhoneStatePermission() ");
            Permission.RequestUserPermission(ToRequestPermissionName, permissionCallbacks);
        }
    }

    #endregion
}

5、IRequestPermissionItem



using UnityEngine.Android;

public interface IRequestPermissionItem 
{
    /// <summary>
    /// 去申请的权限名称
    /// </summary>
    string ToRequestPermissionName { get; }

    /// <summary>
    /// 请求权限
    /// </summary>
    /// <param name="permissionCallbacks">权限回调事件</param>
    void RequestPermission(PermissionCallbacks permissionCallbacks);

    /// <summary>
    /// 判断是否有权限
    /// </summary>
    bool IsHasPermission { get; }
}