关于截图权限的提示，这是 Android 系统为了保障用户隐私和安全设置的标准机制。当你首次调用 requestScreenCapture() 函数时，系统会弹出授权窗口询问是否允许 Hamibot 截取屏幕内容。

选择“始终允许”的原因及注意事项如下：

1. 避免重复弹窗：选择“始终允许”后，系统在后续运行脚本或切换应用时不会再次弹出授权窗口，保证自动化任务连续执行，不被中断。
2. 函数职责区分：requestScreenCapture() 仅负责申请权限，并不会真正执行截图操作。真正的截图功能由 captureScreen() 实现。
3. 调用频率：该函数只需在脚本初始化阶段执行一次即可，不需要在每次调用 captureScreen() 之前都重复调用。
4. 异常处理：如果没有授予截图权限就调用 captureScreen()，程序会抛出 SecurityException 异常导致脚本停止。
5. 运行环境建议：建议在 Hamibot 软件界面内运行该函数。如果在其他应用界面运行时调用，可能会出现一闪而过的黑屏现象。
6. 时间延迟：权限申请成功后，设备生成截图需要一定时间（通常几百毫秒）。如果立即调用 captureScreen()，可能会因为截图尚未更新而返回旧图像或等待超时。

以下是一个兼容性的基础示例代码：

// 文档地址 https://docs.hamibot.com/
// 请求截图权限
if (!requestScreenCapture()) {
    toastLog("没有授予截图权限");
    exit();
}

// 等待截图服务启动完成
sleep(500);

// 执行截图
var img = captureScreen();
if (img) {
    toastLog("截图成功");
} else {
    toastLog("截图失败");
}

如果遇到 MIUI 等特定系统的特殊权限弹窗，可能需要通过线程监听当前 Activity 并自动点击确认，以确保权限顺利获取。

要重新设置截图权限并确保选择“始终允许”，可以通过系统设置清除旧权限或通过脚本重新触发申请。具体操作如下：

1. 通过系统设置重置权限

这是最直接的方法，适用于之前已拒绝或权限状态异常的情况：

• 进入手机“设置” > “应用管理”或“应用列表”。
• 找到 Hamibot 应用，点击进入“权限管理”。
• 找到“显示悬浮窗”、“截屏”或“录制屏幕”相关权限。
• 先将权限设置为“禁止”，然后重新设置为“允许”。
• 下次运行包含截图功能的脚本时，系统会再次弹出授权对话框，此时务必选择“始终允许”。

2. 通过脚本触发申请

在脚本中调用 requestScreenCapture() 函数可以触发系统的权限申请弹窗。

• 代码示例：

// 文档地址 https://docs.hamibot.com/
if (!requestScreenCapture()) {
    toastLog('未授予截图权限');
    hamibot.exit();
}

• 注意：该函数在截图脚本中只需执行一次，无需每次调用 captureScreen() 时都调用。如果不指定截图方向，截图方向由当前设备屏幕方向决定，请务必注意执行该函数时的屏幕方向。

3. 常见问题与建议

• MIUI 系统：部分 MIUI 系统在非本软件界面运行时容易出现一闪而过的黑屏现象，建议在本软件界面运行该函数。
• 自动处理弹窗：如果遇到无法识别的弹窗，可通过 toastLog(currentActivity()) 输出当前界面信息辅助调试。对于需要自动点击确认按钮的场景，可以使用线程监听当前 Activity 并模拟点击。
• 兼容性：编写脚本时请注意 JavaScript 引擎版本（Rhino 1.7.15），避免使用箭头函数表达式或定义函数默认参数值。

按照以上步骤操作，即可确保 Hamibot 获得稳定的截图权限。