遇到截图权限未获取的问题，通常是因为脚本中未正确调用请求函数，或者系统层面未授权。请按照以下步骤排查和解决。

1. 检查代码逻辑

确保在调用 captureScreen() 之前，先执行 requestScreenCapture()。该函数只需在脚本启动时执行一次，用于申请权限。如果返回 false，说明用户拒绝或系统限制。

注意：requestScreenCapture() 只是申请权限，真正的截图操作由 captureScreen() 完成。如果在权限未授予的情况下直接调用 captureScreen()，可能会抛出 SecurityException 或返回 null。

2. 系统设置检查

进入手机设置，找到应用管理中的 Hamibot，确保开启了以下权限：

• 无障碍服务：Hamibot 运行的基础。
• 悬浮窗/显示在其他应用上层：允许 Hamibot 覆盖其他界面。
• 截屏权限：部分定制系统（如 MIUI）需要单独开启此权限。

建议在 Hamibot 软件界面内首次运行脚本，以便顺利触发权限弹窗。选择“总是允许”以避免重复询问。

3. 调试与诊断

若无法识别弹窗或不确定权限状态，可通过 toastLog 输出当前界面信息辅助调试。例如检测当前 Activity 是否包含权限相关关键词。

4. 代码示例

以下代码展示了正确的权限请求流程，已考虑 Rhino 引擎兼容性（不使用箭头函数等 ES6+ 特性）：

// 文档地址 https://docs.hamibot.com/
// 启用线程处理可能的阻塞或后台任务
threads.start(function () {
    // 循环检查直到获取权限或超时
    var count = 0;
    while (!requestScreenCapture() && count < 10) {
        toastLog("正在请求截图权限...");
        sleep(1000);
        count++;
    }

    if (!requestScreenCapture()) {
        toastLog("截图权限获取失败，请手动授予");
        // 尝试输出当前界面辅助判断
        var activity = currentActivity().toLowerCase();
        toastLog("当前界面：" + activity);
        exit();
    }

    toastLog("截图权限已获取");
});

// 主线程等待一小段时间确保截图服务初始化
sleep(2000);

try {
    var img = captureScreen();
    if (img) {
        toastLog("截图成功，尺寸：" + img.getWidth() + "x" + img.getHeight());
    } else {
        toastLog("截图对象为空");
    }
} catch (e) {
    toastLog("截图异常：" + e);
}

5. 常见问题提示

• 黑屏现象：如果在其他软件界面运行时出现一闪而过的黑屏，请尝试在 Hamibot 主界面运行 requestScreenCapture()。
• 截图延迟：截图需要转换为 Bitmap 格式，执行需要一定时间（0~20ms）。requestScreenCapture() 成功后，建议等待几百毫秒再调用 captureScreen()。
• 连续调用：短时间内连续调用 captureScreen() 可能返回同一张截图，因为设备截图更新需要时间（一般 16ms）。

如果以上步骤仍无法解决问题，请检查手机系统版本是否过低，或联系 Hamibot 技术支持获取进一步帮助。