第23章权限管理

课程目录第23章权限管理

23、权限管理：TV应用的特殊权限、运行时权限处理

权限管理这个话题，说实话在TV开发里比手机端要「温柔」一些。但温柔不代表没坑。我刚开始做TV应用时，以为权限处理和手机一样，结果在遥控器操作和焦点引导上栽了好几次跟头。今天咱们就把TV权限这点事彻底聊透。

TV权限的特殊性

TV设备和手机最大的区别是什么？你想想看——手机可以触摸，TV全靠遥控器。这个差异直接影响了权限申请的交互方式。

在手机上，弹个对话框，用户点「允许」或「拒绝」，很自然。但在TV上，弹窗需要焦点，焦点需要遥控器导航，导航又涉及界面层级。搞不好用户就卡在某个权限弹窗里，进退两难。

我个人习惯把TV权限分为三类：

普通权限：直接声明即可，系统自动授予
运行时权限：需要弹窗让用户确认（危险权限）
特殊权限：需要用户去系统设置里手动开启

嗯，这里要注意——TV应用里运行时权限的种类其实比手机少。因为TV不需要摄像头、不需要读取联系人、不需要短信权限。你想想看，电视上要短信干嘛？

TV应用常用的运行时权限

我整理了一下，TV开发中真正需要运行时处理的权限其实就这几个：

权限	用途	备注
WRITE_EXTERNAL_STORAGE	写入外部存储	Android 10+ 已弱化
READ_EXTERNAL_STORAGE	读取外部存储	播放本地媒体文件时常用
RECORD_AUDIO	录音	语音搜索功能需要
ACCESS_FINE_LOCATION	精确定位	部分直播应用需要
ACCESS_COARSE_LOCATION	粗略定位	区域限制内容

我在项目中遇到过一个问题：某个TV直播应用需要定位权限来提供本地频道。结果用户第一次打开时，权限弹窗被系统级的「正在加载」遮住了，用户根本看不到弹窗。后来怎么解决的？我们改成了在首页引导用户主动触发权限申请，而不是一启动就弹。

TV上的权限申请流程

TV端的权限申请，核心就一句话：不要让用户困惑。

手机用户习惯了弹窗，但TV用户不一定。很多TV用户是老人或小孩，看到弹窗第一反应是「按返回键」。所以我们的流程要更「温柔」一些。

我建议的流程是这样的：

预检查：进入功能前先检查权限是否已授予
友好提示：用自定义的Dialog或Toast告知用户为什么需要这个权限
系统弹窗：调用系统API弹出权限请求
结果回调：处理授权或拒绝的情况
拒绝后的引导：如果用户拒绝，引导去系统设置手动开启

说白了，就是多了一层「预提示」。别一上来就甩系统弹窗，用户会懵的。

代码实现：运行时权限处理

咱们直接看代码。这是我在一个TV项目里实际用过的权限处理工具类：

// TV权限请求工具类
public class TvPermissionHelper {

    private static final int PERMISSION_REQUEST_CODE = 1001;

    private Activity activity;
    private String[] permissions;
    private PermissionCallback callback;

    public interface PermissionCallback {
        void onGranted();
        void onDenied(List<String> deniedPermissions);
    }

    public TvPermissionHelper(Activity activity) {
        this.activity = activity;
    }

    // 检查并请求权限
    public void requestPermissions(String[] permissions, PermissionCallback callback) {
        this.permissions = permissions;
        this.callback = callback;

        List<String> needRequest = new ArrayList<>();
        for (String perm : permissions) {
            if (ContextCompat.checkSelfPermission(activity, perm)
                    != PackageManager.PERMISSION_GRANTED) {
                needRequest.add(perm);
            }
        }

        if (needRequest.isEmpty()) {
            // 所有权限都已授予
            callback.onGranted();
        } else {
            // 先显示自定义提示，再请求系统权限
            showPermissionGuide(needRequest);
        }
    }

    private void showPermissionGuide(List<String> needRequest) {
        // 使用TV友好的Dialog
        AlertDialog.Builder builder = new AlertDialog.Builder(activity);
        builder.setTitle("需要权限");
        builder.setMessage("为了正常使用该功能，需要获取以下权限：\n" +
                getPermissionNames(needRequest));
        builder.setPositiveButton("去授权", (dialog, which) -> {
            // 请求系统权限
            ActivityCompat.requestPermissions(
                    activity,
                    needRequest.toArray(new String[0]),
                    PERMISSION_REQUEST_CODE
            );
        });
        builder.setNegativeButton("取消", (dialog, which) -> {
            if (callback != null) {
                callback.onDenied(needRequest);
            }
        });
        builder.setCancelable(false);
        builder.show();
    }

    // 在Activity的onRequestPermissionsResult中调用
    public void handlePermissionResult(int requestCode, @NonNull String[] permissions,
                                       @NonNull int[] grantResults) {
        if (requestCode != PERMISSION_REQUEST_CODE) return;

        List<String> denied = new ArrayList<>();
        for (int i = 0; i < grantResults.length; i++) {
            if (grantResults[i] != PackageManager.PERMISSION_GRANTED) {
                denied.add(permissions[i]);
            }
        }

        if (denied.isEmpty()) {
            callback.onGranted();
        } else {
            // 检查是否勾选了「不再询问」
            boolean showRationale = false;
            for (String perm : denied) {
                if (ActivityCompat.shouldShowRequestPermissionRationale(activity, perm)) {
                    showRationale = true;
                    break;
                }
            }
            if (!showRationale) {
                // 用户勾选了「不再询问」，引导去设置
                goToSettings();
            } else {
                callback.onDenied(denied);
            }
        }
    }

    private void goToSettings() {
        // 跳转到应用详情页
        Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
        intent.setData(Uri.parse("package:" + activity.getPackageName()));
        activity.startActivity(intent);
    }

    private String getPermissionNames(List<String> perms) {
        StringBuilder sb = new StringBuilder();
        for (String p : perms) {
            if (p.equals(Manifest.permission.RECORD_AUDIO)) {
                sb.append("• 麦克风权限（用于语音搜索）\n");
            } else if (p.equals(Manifest.permission.ACCESS_FINE_LOCATION)) {
                sb.append("• 位置权限（用于本地内容推荐）\n");
            } else {
                sb.append("• ").append(p).append("\n");
            }
        }
        return sb.toString();
    }
}

这段代码里有个细节——我用了自定义Dialog而不是直接弹系统权限框。为什么？因为TV上系统权限弹窗的焦点控制有时候会出问题，尤其是Android 8.0以下的设备。自定义Dialog可以确保焦点在遥控器上可控。

TV特殊权限：SYSTEM_ALERT_WINDOW

说到特殊权限，TV上最典型的就是SYSTEM_ALERT_WINDOW（悬浮窗权限）。

你可能会问：TV上要悬浮窗干嘛？

举个例子——有些TV应用需要显示一个「画中画」的小窗口，或者一个悬浮的快捷菜单。这时候就需要悬浮窗权限。

但这个权限不能通过运行时请求直接授予，必须让用户去系统设置里手动开启。流程是这样的：

// 检查悬浮窗权限
if (Settings.canDrawOverlays(context)) {
    // 已有权限，直接使用
    showFloatingWindow();
} else {
    // 引导用户去设置
    Intent intent = new Intent(
        Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
        Uri.parse("package:" + context.getPackageName())
    );
    startActivity(intent);
}

我曾经在一个TV项目里踩过这个坑——用户从设置页面返回后，我们以为权限已经授予了，结果没有做二次检查。后来发现有些用户返回后根本没开启权限。所以记住：从设置页面返回后，一定要重新检查权限状态。

另一个特殊权限：WRITE_SETTINGS

还有一个特殊权限是WRITE_SETTINGS，用于修改系统设置。TV上偶尔会用到，比如调整屏幕亮度、修改默认输入法等。

处理方式和悬浮窗类似：

if (Settings.System.canWrite(context)) {
    // 可以修改系统设置
    modifySystemSettings();
} else {
    Intent intent = new Intent(
        Settings.ACTION_MANAGE_WRITE_SETTINGS,
        Uri.parse("package:" + context.getPackageName())
    );
    startActivity(intent);
}

嗯，这里要注意——WRITE_SETTINGS权限在Android 10+上限制更严格了。如果你的应用targetSdkVersion是29以上，有些系统设置项已经不允许修改了。我建议尽量少用这个权限，能用其他方式替代就替代。

TV权限的焦点与导航处理

这是TV权限管理里最容易出问题的地方。我见过不少应用，权限弹窗弹出来后，遥控器按上下键焦点不动，用户只能按返回键关闭弹窗。

为什么会这样？

因为系统权限弹窗的焦点管理是系统控制的，不同厂商的TV系统实现不一样。有些厂商的弹窗焦点默认在「拒绝」按钮上，有些在「允许」上，有些甚至没有焦点。

我的解决方案是：

尽量使用自定义Dialog，自己控制焦点顺序
设置明确的焦点链：左/右/上/下都能导航
默认焦点放在「允许」按钮上，减少用户操作步骤
添加一个「不再提示」的复选框，避免用户反复被骚扰

小技巧：在自定义Dialog中，可以用requestFocus()方法手动指定默认焦点。别忘了在XML里给按钮加上android:focusable="true"和android:nextFocusDown等属性。

权限申请的最佳实践

做了这么多TV项目，我总结了几条经验：

按需申请：不要一启动就申请所有权限。用户还没用你的功能呢，凭什么给你权限？
解释原因：每次申请权限前，用一句话告诉用户「为什么需要这个权限」。比如「需要定位权限才能推荐你所在地区的频道」。
允许拒绝：用户拒绝后，不要反复弹窗。可以降级功能，或者提供一个「手动开启」的入口。
兼容低版本：Android 6.0以下的设备不需要运行时权限，但要注意Android 5.1的TV设备仍然有不少存量。
测试所有厂商：小米TV、华为TV、索尼TV的权限弹窗表现都不一样。有条件的话，多拿几台设备测一下。

避坑指南：我曾经在一个项目中，权限弹窗的Dialog用了android:theme="@android:style/Theme.Material.Light"，结果在某个品牌的TV上背景全黑了，按钮都看不见。后来改成Theme.DeviceDefault才解决。所以TV上的Dialog主题，尽量用系统默认的，别自己瞎折腾。

知识体系总览

下面这张图把TV权限管理的核心逻辑串起来了：

这张图把TV权限的三大分类和处理流程都串起来了。你可以看到，运行时权限的处理是一个完整的闭环——从预检查到结果处理，每一步都不能少。

总结

TV权限管理，说白了就是「少弹窗、多引导、控焦点」。手机上的那一套直接搬过来肯定不行。我建议你在开发TV应用时，把权限相关的代码单独封装成一个模块，方便统一管理和测试。

最后再啰嗦一句——权限申请不是越多越好。每次加一个新权限之前，先问问自己：这个功能真的需要这个权限吗？有没有替代方案？用户会不会因为这个权限而拒绝安装？

📚 课程目录

23、权限管理：TV应用的特殊权限、运行时权限处理

TV权限的特殊性

TV应用常用的运行时权限

TV上的权限申请流程

代码实现：运行时权限处理

TV特殊权限：SYSTEM_ALERT_WINDOW

另一个特殊权限：WRITE_SETTINGS

TV权限的焦点与导航处理

权限申请的最佳实践

知识体系总览

总结