在 Hamibot 中，获取设备 MAC 地址使用 device.getMacAddress() 函数。

代码示例如下：

// 文档地址 https://docs.hamibot.com/
var mac = device.getMacAddress();
if (mac != null) {
    log("MAC 地址：" + mac);
} else {
    log("无法获取 MAC 地址，请检查 WLAN 连接");
}

注意事项：

WLAN 连接要求：该函数需要在设备有 WLAN 连接的情况下才能获取到 MAC 地址。如果没有 WLAN 连接，函数会返回 null。
返回值类型：返回值为字符串类型（String）。
使用限制：请勿使用此函数来判断 WLAN 连接状态。未来版本可能会增加通过 root 权限在无 WLAN 连接情况下获取 MAC 地址的功能。
权限：通常不需要特殊权限即可读取，但受限于 Android 系统版本和硬件环境。

补充回答 1

关于你提出的两个问题，解答如下：

1. 关于蓝牙 MAC 地址

Hamibot 的 device 模块目前不提供获取蓝牙 MAC 地址的 API 接口。device 模块仅提供了获取设备通用 MAC 地址（通常指 WLAN MAC）、IMEI 和 Android ID 等方法。

2. 关于 5G 网络下获取网卡地址

在 5G 移动数据网络环境下，无法通过 device.getMacAddress() 获取网卡地址。

机制说明：device.getMacAddress() 函数依赖 WLAN 连接。如果设备未连接 WLAN（例如仅使用 5G/4G 数据），该函数会返回 null。
未来计划：后续版本可能会增加通过 root 权限在无 WLAN 连接情况下获取 MAC 地址的功能，但目前尚未实现。
替代方案：如果需要唯一设备标识，建议使用 device.getAndroidId() 或 device.getIMEI() 代替 MAC 地址。

代码示例

以下代码展示了如何获取可用的设备标识信息，并处理 MAC 地址为空的情况：

// 文档地址 https://docs.hamibot.com/
var mac = device.getMacAddress();
var androidId = device.getAndroidId();
var imei = device.getIMEI();

if (mac == null) {
    log("当前无 WLAN 连接，无法获取 MAC 地址");
    log("建议使用 Android ID 作为设备标识：" + androidId);
} else {
    log("MAC 地址：" + mac);
}

log("IMEI: " + imei);
log("Android ID: " + androidId);

建议

由于 Android 系统隐私策略的限制，MAC 地址的获取在现代 Android 版本中受到严格限制。在设计脚本时，推荐优先使用 Android ID 作为设备唯一标识，其稳定性更高且不受网络连接状态影响。

补充回答 2

这是因为读取 IMEI 需要 READ_PHONE_STATE 权限。在 Hamibot 脚本中，需要先请求该权限才能调用 device.getIMEI()。

解决方案

在脚本开头添加权限请求代码：

// 文档地址 https://docs.hamibot.com/
// 请求读取手机状态权限
runtime.requestPermissions(['read_phone_state']);

// 等待权限授予后再获取 IMEI
sleep(1000);

var imei = device.getIMEI();
if (imei != null) {
    log("IMEI: " + imei);
} else {
    log("无法获取 IMEI，请检查权限是否已授予");
}

注意事项

权限弹窗：运行脚本时，系统会弹出权限请求对话框，需要手动点击"允许"。
Android 10+ 限制：在 Android 10 及以上版本，由于系统隐私政策收紧，即使授予权限，getIMEI() 也可能返回 null 或固定值。这是 Android 系统层面的限制，非 Hamibot 问题。
替代方案：如果 IMEI 无法获取，建议使用 device.getAndroidId() 作为设备标识，该标识不需要特殊权限且更稳定：

// 文档地址 https://docs.hamibot.com/
var androidId = device.getAndroidId();
log("Android ID: " + androidId);

权限列表：常用权限名称如下：
- read_phone_state - 读取手机状态（IMEI 等）
- access_fine_location - 精确位置
- write_external_storage - 写入外部存储

完整示例

// 文档地址 https://docs.hamibot.com/
// 请求所需权限
runtime.requestPermissions(['read_phone_state']);

// 等待权限处理
sleep(1000);

// 获取设备标识
var imei = device.getIMEI();
var androidId = device.getAndroidId();
var mac = device.getMacAddress();

log("IMEI: " + (imei != null ? imei : "不可用"));
log("Android ID: " + androidId);
log("MAC 地址：" + (mac != null ? mac : "无 WLAN 连接"));