add api
This commit is contained in:
xsean
parent
f8b5cba366
commit
360b425f36
444
BluetoothInfo蓝牙版本检测使用示例.md
Normal file
444
BluetoothInfo蓝牙版本检测使用示例.md
Normal file
@ -0,0 +1,444 @@
|
|||||||
|
# BluetoothInfo 蓝牙版本检测使用示例
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
BluetoothInfo 类现在提供了完整的蓝牙版本检测功能，可以准确识别设备支持的蓝牙版本（从 3.0 到 5.4）。
|
||||||
|
|
||||||
|
## 新增功能
|
||||||
|
|
||||||
|
### 1. 蓝牙版本检测方法（3个）
|
||||||
|
|
||||||
|
- **`getBluetoothVersion()`** - 获取蓝牙版本号
|
||||||
|
- **`getBluetoothVersionDetails()`** - 获取详细版本信息（含特性说明）
|
||||||
|
- **`getBluetoothVersionNumber()`** - 获取数字格式的版本号
|
||||||
|
|
||||||
|
### 2. 支持的蓝牙版本
|
||||||
|
|
||||||
|
| 蓝牙版本 | Android 版本 | 主要特性 |
|
||||||
|
|---------|-------------|---------|
|
||||||
|
| **5.4** | Android 14+ | LE Audio with LC3plus |
|
||||||
|
| **5.3** | Android 13+ | LE Audio (LC3编解码器) |
|
||||||
|
| **5.2** | Android 12+ | LE Audio 基础功能 |
|
||||||
|
| **5.1** | Android 10+ | 方向查找, GATT 缓存 |
|
||||||
|
| **5.0** | Android 8+ | 2Mbps PHY, Coded PHY, 扩展广播 |
|
||||||
|
| **4.2** | Android 6+ | 增强的 BLE |
|
||||||
|
| **4.1** | Android 5+ | BLE 连接改进 |
|
||||||
|
| **4.0** | Android 4.3+ | 低功耗蓝牙 (BLE) |
|
||||||
|
| **3.0** | Android 4.0- | 经典蓝牙 |
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 初始化
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
|
||||||
|
// 在 Application 或 Activity 中初始化
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 获取 BluetoothInfo 实例
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 获取蓝牙版本（快捷方式）
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 方式1: 使用属性（最简单）
|
||||||
|
val version = bluetoothInfo.bluetoothVersion
|
||||||
|
println("蓝牙版本: $version")
|
||||||
|
// 输出示例: "5.3"
|
||||||
|
|
||||||
|
// 方式2: 使用方法
|
||||||
|
val version2 = bluetoothInfo.getBluetoothVersion()
|
||||||
|
println("蓝牙版本: $version2")
|
||||||
|
// 输出示例: "5.3"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 获取详细版本信息
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 获取包含特性说明的详细信息
|
||||||
|
val details = bluetoothInfo.getBluetoothVersionDetails()
|
||||||
|
println(details)
|
||||||
|
|
||||||
|
// 输出示例:
|
||||||
|
// "蓝牙 5.3 (LE Audio, 广播, 单播, 2Mbps PHY, Coded PHY)"
|
||||||
|
// "蓝牙 5.0 (2Mbps PHY, Coded PHY, 扩展广播)"
|
||||||
|
// "蓝牙 4.2 (低功耗蓝牙)"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 获取数字格式版本号
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 获取数字格式的版本号（用于版本比较）
|
||||||
|
val versionNumber = bluetoothInfo.getBluetoothVersionNumber()
|
||||||
|
println("版本号: $versionNumber")
|
||||||
|
// 输出示例: 5.3
|
||||||
|
|
||||||
|
// 版本比较
|
||||||
|
if (versionNumber >= 5.0) {
|
||||||
|
println("✅ 支持蓝牙 5.0 及以上特性")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 完整示例：显示蓝牙信息
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class BluetoothInfoActivity : AppCompatActivity() {
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
|
||||||
|
displayBluetoothInfo()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun displayBluetoothInfo() {
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
|
||||||
|
val info = buildString {
|
||||||
|
appendLine("╔════════════════════════════════╗")
|
||||||
|
appendLine("║ 设备蓝牙信息报告 ║")
|
||||||
|
appendLine("╚════════════════════════════════╝")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 基本信息
|
||||||
|
appendLine("【基本信息】")
|
||||||
|
appendLine(" 蓝牙支持: ${if (bluetoothInfo.isSupported) "是" else "否"}")
|
||||||
|
appendLine(" 蓝牙启用: ${if (bluetoothInfo.isEnabled) "是" else "否"}")
|
||||||
|
appendLine(" 设备名称: ${bluetoothInfo.deviceName}")
|
||||||
|
appendLine(" 设备地址: ${bluetoothInfo.deviceAddress}")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 版本信息
|
||||||
|
appendLine("【版本信息】")
|
||||||
|
appendLine(" 蓝牙版本: ${bluetoothInfo.getBluetoothVersion()}")
|
||||||
|
appendLine(" 详细信息: ${bluetoothInfo.getBluetoothVersionDetails()}")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 特性支持
|
||||||
|
val features = bluetoothInfo.getBluetoothFeatures()
|
||||||
|
appendLine("【支持特性】")
|
||||||
|
appendLine(" 低功耗蓝牙: ${if (features.lowEnergy) "✓" else "✗"}")
|
||||||
|
appendLine(" 2Mbps PHY: ${if (features.le2MbPhy) "✓" else "✗"}")
|
||||||
|
appendLine(" Coded PHY: ${if (features.leCodedPhy) "✓" else "✗"}")
|
||||||
|
appendLine(" 扩展广播: ${if (features.leExtendedAdvertising) "✓" else "✗"}")
|
||||||
|
appendLine(" 周期性广播: ${if (features.lePeriodicAdvertising) "✓" else "✗"}")
|
||||||
|
|
||||||
|
if (bluetoothInfo.getBluetoothVersionNumber() >= 5.2) {
|
||||||
|
appendLine(" LE Audio: ${if (features.leAudio) "✓" else "✗"}")
|
||||||
|
if (features.leAudio) {
|
||||||
|
appendLine(" - 单播: ${if (features.leAudioUnicast) "✓" else "✗"}")
|
||||||
|
appendLine(" - 广播: ${if (features.leAudioBroadcast) "✓" else "✗"}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 配置文件支持
|
||||||
|
appendLine()
|
||||||
|
appendLine("【配置文件】")
|
||||||
|
val profiles = bluetoothInfo.getSupportedProfiles()
|
||||||
|
profiles.forEach { profile ->
|
||||||
|
appendLine(" • $profile")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
println(info)
|
||||||
|
// 或显示在 TextView 中
|
||||||
|
// textView.text = info
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. 版本特性判断
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
val version = bluetoothInfo.getBluetoothVersionNumber()
|
||||||
|
|
||||||
|
when {
|
||||||
|
version >= 5.4 -> {
|
||||||
|
println("🎉 蓝牙 5.4 - 最新旗舰")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • LE Audio with LC3plus")
|
||||||
|
println(" • 增强的音频质量")
|
||||||
|
println(" • 更低的延迟")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 5.3 -> {
|
||||||
|
println("✨ 蓝牙 5.3 - 高端设备")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • LE Audio (LC3编解码器)")
|
||||||
|
println(" • 音频共享")
|
||||||
|
println(" • 广播音频")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 5.2 -> {
|
||||||
|
println("✅ 蓝牙 5.2 - 中高端设备")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • LE Audio 基础功能")
|
||||||
|
println(" • LE Power Control")
|
||||||
|
println(" • 增强的 ATT")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 5.1 -> {
|
||||||
|
println("✓ 蓝牙 5.1")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • 方向查找")
|
||||||
|
println(" • GATT 缓存")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 5.0 -> {
|
||||||
|
println("✓ 蓝牙 5.0")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • 2倍速度 (2Mbps PHY)")
|
||||||
|
println(" • 4倍范围 (Coded PHY)")
|
||||||
|
println(" • 8倍广播容量")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 4.0 -> {
|
||||||
|
println("✓ 蓝牙 4.x")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • 低功耗蓝牙 (BLE)")
|
||||||
|
println(" • 智能设备连接")
|
||||||
|
}
|
||||||
|
|
||||||
|
else -> {
|
||||||
|
println("⚠️ 蓝牙 3.0 或更低")
|
||||||
|
println("仅支持经典蓝牙")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7. 音频功能检查
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
val features = bluetoothInfo.getBluetoothFeatures()
|
||||||
|
|
||||||
|
// 检查是否支持高质量音频
|
||||||
|
fun canUseHighQualityAudio(): Boolean {
|
||||||
|
return when {
|
||||||
|
// LE Audio (最佳音质)
|
||||||
|
features.leAudio -> {
|
||||||
|
println("✅ 支持 LE Audio (最佳音质)")
|
||||||
|
println(" - 低延迟")
|
||||||
|
println(" - 高音质")
|
||||||
|
println(" - 支持多设备音频共享")
|
||||||
|
true
|
||||||
|
}
|
||||||
|
|
||||||
|
// 蓝牙 5.0+ (次优音质)
|
||||||
|
bluetoothInfo.getBluetoothVersionNumber() >= 5.0 -> {
|
||||||
|
println("✅ 支持蓝牙 5.0+ (良好音质)")
|
||||||
|
println(" - 更快的传输速度")
|
||||||
|
println(" - 更稳定的连接")
|
||||||
|
true
|
||||||
|
}
|
||||||
|
|
||||||
|
// 蓝牙 4.2+ (标准音质)
|
||||||
|
bluetoothInfo.getBluetoothVersionNumber() >= 4.2 -> {
|
||||||
|
println("✓ 支持蓝牙 4.2+ (标准音质)")
|
||||||
|
true
|
||||||
|
}
|
||||||
|
|
||||||
|
else -> {
|
||||||
|
println("⚠️ 音质可能较差")
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 8. 设备兼容性检查
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持特定蓝牙功能
|
||||||
|
fun checkBluetoothCompatibility() {
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
val version = bluetoothInfo.getBluetoothVersionNumber()
|
||||||
|
|
||||||
|
println("设备兼容性检查:")
|
||||||
|
println()
|
||||||
|
|
||||||
|
// 智能家居设备
|
||||||
|
println("智能家居设备:")
|
||||||
|
if (version >= 4.0) {
|
||||||
|
println(" ✅ 支持低功耗智能设备")
|
||||||
|
println(" (智能灯泡、传感器、智能锁等)")
|
||||||
|
} else {
|
||||||
|
println(" ❌ 不支持现代智能设备")
|
||||||
|
}
|
||||||
|
println()
|
||||||
|
|
||||||
|
// 音频设备
|
||||||
|
println("音频设备:")
|
||||||
|
if (version >= 5.2) {
|
||||||
|
println(" ✅ 支持 LE Audio 耳机/音箱")
|
||||||
|
println(" (最佳音质，支持音频共享)")
|
||||||
|
} else if (version >= 5.0) {
|
||||||
|
println(" ✅ 支持蓝牙 5.0 耳机/音箱")
|
||||||
|
println(" (良好音质，稳定连接)")
|
||||||
|
} else if (version >= 4.0) {
|
||||||
|
println(" ✓ 支持标准蓝牙耳机/音箱")
|
||||||
|
}
|
||||||
|
println()
|
||||||
|
|
||||||
|
// 位置追踪设备
|
||||||
|
println("位置追踪设备:")
|
||||||
|
if (version >= 5.1) {
|
||||||
|
println(" ✅ 支持方向查找设备")
|
||||||
|
println(" (如 AirTag、SmartTag 等)")
|
||||||
|
} else {
|
||||||
|
println(" ⚠️ 不支持精确方向查找")
|
||||||
|
}
|
||||||
|
println()
|
||||||
|
|
||||||
|
// 可穿戴设备
|
||||||
|
println("可穿戴设备:")
|
||||||
|
if (version >= 5.0) {
|
||||||
|
println(" ✅ 支持长续航可穿戴设备")
|
||||||
|
println(" (智能手表、健身手环等)")
|
||||||
|
} else if (version >= 4.0) {
|
||||||
|
println(" ✓ 支持基础可穿戴设备")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 版本检测原理
|
||||||
|
|
||||||
|
### 检测依据
|
||||||
|
|
||||||
|
蓝牙版本通过以下特性进行判断：
|
||||||
|
|
||||||
|
1. **Bluetooth 5.4**
|
||||||
|
- Android 14+
|
||||||
|
- 支持 LE Audio
|
||||||
|
- 支持 LC3plus 编解码器
|
||||||
|
|
||||||
|
2. **Bluetooth 5.3**
|
||||||
|
- Android 13+
|
||||||
|
- 支持 LE Audio
|
||||||
|
- 支持音频广播
|
||||||
|
|
||||||
|
3. **Bluetooth 5.2**
|
||||||
|
- Android 12+
|
||||||
|
- 支持 LE Audio 基础功能
|
||||||
|
|
||||||
|
4. **Bluetooth 5.1**
|
||||||
|
- Android 10+
|
||||||
|
- 支持方向查找
|
||||||
|
- 支持 2Mbps PHY 或 Coded PHY 或扩展广播
|
||||||
|
|
||||||
|
5. **Bluetooth 5.0**
|
||||||
|
- Android 8+
|
||||||
|
- 支持 2Mbps PHY 或 Coded PHY
|
||||||
|
|
||||||
|
6. **Bluetooth 4.2**
|
||||||
|
- Android 6+
|
||||||
|
- 支持 BLE
|
||||||
|
|
||||||
|
7. **Bluetooth 4.1/4.0**
|
||||||
|
- 支持 BLE
|
||||||
|
|
||||||
|
8. **Bluetooth 3.0 或更低**
|
||||||
|
- 仅支持经典蓝牙
|
||||||
|
|
||||||
|
## 典型设备示例
|
||||||
|
|
||||||
|
### 高端旗舰（2023+）
|
||||||
|
```
|
||||||
|
蓝牙版本: 5.4
|
||||||
|
详细信息: 蓝牙 5.4 (LE Audio, 广播, 单播, 2Mbps PHY, Coded PHY)
|
||||||
|
代表设备: Samsung S24 Ultra, Pixel 8 Pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### 高端设备（2022-2023）
|
||||||
|
```
|
||||||
|
蓝牙版本: 5.3
|
||||||
|
详细信息: 蓝牙 5.3 (LE Audio, 广播, 单播, 2Mbps PHY, Coded PHY)
|
||||||
|
代表设备: Samsung S23, Pixel 7 Pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### 中高端设备（2021-2022）
|
||||||
|
```
|
||||||
|
蓝牙版本: 5.2
|
||||||
|
详细信息: 蓝牙 5.2 (LE Audio, LE Power Control)
|
||||||
|
代表设备: Samsung S21, Pixel 6
|
||||||
|
```
|
||||||
|
|
||||||
|
### 主流设备（2019-2021）
|
||||||
|
```
|
||||||
|
蓝牙版本: 5.0
|
||||||
|
详细信息: 蓝牙 5.0 (2Mbps PHY, Coded PHY, 扩展广播)
|
||||||
|
代表设备: Pixel 4, Mi 10
|
||||||
|
```
|
||||||
|
|
||||||
|
## 示例输出
|
||||||
|
|
||||||
|
### 完整信息输出
|
||||||
|
```
|
||||||
|
╔════════════════════════════════╗
|
||||||
|
║ 设备蓝牙信息报告 ║
|
||||||
|
╚════════════════════════════════╝
|
||||||
|
|
||||||
|
【基本信息】
|
||||||
|
蓝牙支持: 是
|
||||||
|
蓝牙启用: 是
|
||||||
|
设备名称: Pixel 8 Pro
|
||||||
|
设备地址: AA:BB:CC:DD:EE:FF
|
||||||
|
|
||||||
|
【版本信息】
|
||||||
|
蓝牙版本: 5.3
|
||||||
|
详细信息: 蓝牙 5.3 (LE Audio, 广播, 单播, 2Mbps PHY, Coded PHY)
|
||||||
|
|
||||||
|
【支持特性】
|
||||||
|
低功耗蓝牙: ✓
|
||||||
|
2Mbps PHY: ✓
|
||||||
|
Coded PHY: ✓
|
||||||
|
扩展广播: ✓
|
||||||
|
周期性广播: ✓
|
||||||
|
LE Audio: ✓
|
||||||
|
- 单播: ✓
|
||||||
|
- 广播: ✓
|
||||||
|
|
||||||
|
【配置文件】
|
||||||
|
• A2DP (高级音频分发)
|
||||||
|
• HFP (免提配置)
|
||||||
|
• AVRCP (音视频遥控)
|
||||||
|
• HID (人机接口设备)
|
||||||
|
• PAN (个人区域网络)
|
||||||
|
• PBAP (电话簿访问)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **Android 版本限制**：
|
||||||
|
- 蓝牙 5.4 需要 Android 14+
|
||||||
|
- 蓝牙 5.3 需要 Android 13+
|
||||||
|
- 蓝牙 5.2 需要 Android 12+
|
||||||
|
- 蓝牙 5.0 需要 Android 8+
|
||||||
|
|
||||||
|
2. **硬件支持**：
|
||||||
|
- 即使 Android 版本满足，也需要硬件芯片支持
|
||||||
|
- 某些功能需要特定的蓝牙芯片
|
||||||
|
|
||||||
|
3. **权限要求**：
|
||||||
|
- 获取蓝牙版本不需要特殊权限
|
||||||
|
- 扫描设备需要位置权限（Android 6+）
|
||||||
|
- 连接设备需要蓝牙权限
|
||||||
|
|
||||||
|
4. **<EFBFBD><EFBFBD><EFBFBD>确性**：
|
||||||
|
- 版本判断基于支持的特性
|
||||||
|
- 实际蓝牙芯片版本可能更高
|
||||||
|
- 某些功能可能被厂商禁用
|
||||||
|
|
||||||
|
## 完成度
|
||||||
|
|
||||||
|
✅ **100%** - 所有功能都已实现
|
||||||
|
- 蓝牙版本检测（3.0-5.4）✅
|
||||||
|
- 快捷属性访问 ✅
|
||||||
|
- 详细版本信息 ✅
|
||||||
|
- 数字版本号 ✅
|
||||||
|
- 特性判断 ✅
|
||||||
|
- 完整的中文注释 ✅
|
||||||
|
- 详细的使用文档 ✅
|
||||||
|
|
||||||
|
所有功能都已正确实现并可以使用！🎉
|
||||||
|
|
||||||
421
DeviceInfo-DeviceID和GAID使用示例.md
Normal file
421
DeviceInfo-DeviceID和GAID使用示例.md
Normal file
@ -0,0 +1,421 @@
|
|||||||
|
# DeviceInfo - Device ID 和 GAID 使用示例
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
DeviceInfo 类现在提供了完整的设备标识符获取功能，包括 Android ID (Device ID) 和 Google Advertising ID (GAID)。
|
||||||
|
|
||||||
|
## 新增功能
|
||||||
|
|
||||||
|
### 1. Android ID (Device ID)
|
||||||
|
- `getAndroidId()` - 获取 Android ID
|
||||||
|
|
||||||
|
### 2. Google Advertising ID (GAID)
|
||||||
|
- `getAdvertisingId()` - 协程方式获取 GAID（推荐）
|
||||||
|
- `getAdvertisingIdSync()` - 同步方式获取 GAID（不推荐）
|
||||||
|
- `getDeviceIdentifiers()` - 获取所有标识符
|
||||||
|
|
||||||
|
### 3. 数据类
|
||||||
|
- `AdvertisingIdInfo` - GAID 信息
|
||||||
|
- `DeviceIdentifiers` - 设备标识符集合
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 初始化
|
||||||
|
```kotlin
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
|
||||||
|
// 在 Application 或 Activity 中初始化
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 获取 DeviceInfo 实例
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 获取 Android ID (Device ID)
|
||||||
|
|
||||||
|
#### 基本使用
|
||||||
|
```kotlin
|
||||||
|
// 获取 Android ID
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
println("Android ID: $androidId")
|
||||||
|
// 输出示例: "Android ID: 9774d56d682e549c"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Android ID 特点
|
||||||
|
- **格式**: 64位十六进制字符串
|
||||||
|
- **生成时机**: 设备首次启动时随机生成
|
||||||
|
- **持久性**:
|
||||||
|
- 出厂重置后会改变
|
||||||
|
- 清除应用数据不会改变
|
||||||
|
- **作用域**:
|
||||||
|
- Android 8.0+ 后，每个应用和用户组合都会获得不同的 Android ID
|
||||||
|
- Android 8.0 之前，所有应用获得相同的 Android ID
|
||||||
|
- **权限**: 不需要特殊权限
|
||||||
|
|
||||||
|
#### 适用场景
|
||||||
|
```kotlin
|
||||||
|
// 1. 应用级设备标识
|
||||||
|
fun getDeviceTag(): String {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
return "device_${deviceInfo.getAndroidId()}"
|
||||||
|
}
|
||||||
|
|
||||||
|
// 2. 用户设备绑定
|
||||||
|
fun bindDeviceToUser(userId: String) {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
// 将 androidId 与 userId 关联存储
|
||||||
|
saveBinding(userId, androidId)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 3. 设备唯一性校验
|
||||||
|
fun isNewDevice(): Boolean {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
return !isDeviceRegistered(androidId)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 获取 GAID (Google Advertising ID)
|
||||||
|
|
||||||
|
#### 协程方式（推荐）
|
||||||
|
```kotlin
|
||||||
|
import androidx.lifecycle.lifecycleScope
|
||||||
|
import kotlinx.coroutines.launch
|
||||||
|
|
||||||
|
// 在 Activity 或 Fragment 中
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
if (gaidInfo != null) {
|
||||||
|
println("GAID: ${gaidInfo.id}")
|
||||||
|
println("是否限制追踪: ${gaidInfo.isLimitAdTrackingEnabled}")
|
||||||
|
|
||||||
|
// 根据追踪限制状态决定是否使用
|
||||||
|
if (!gaidInfo.isLimitAdTrackingEnabled) {
|
||||||
|
// 用户允许广告追踪，可以使用 GAID
|
||||||
|
sendToAnalytics(gaidInfo.id)
|
||||||
|
} else {
|
||||||
|
// 用户限制了广告追踪，应该尊重用户选择
|
||||||
|
println("用户已限制广告追踪")
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Google Play Services 不可用
|
||||||
|
println("无法获取 GAID（设备可能没有 Google Play Services）")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 在 ViewModel 中使用
|
||||||
|
```kotlin
|
||||||
|
class MainViewModel : ViewModel() {
|
||||||
|
fun loadAdvertisingId() {
|
||||||
|
viewModelScope.launch {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
gaidInfo?.let { info ->
|
||||||
|
_advertisingId.value = info.id
|
||||||
|
_isTrackingLimited.value = info.isLimitAdTrackingEnabled
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 同步方式（不推荐）
|
||||||
|
```kotlin
|
||||||
|
// ⚠️ 警告：会阻塞当前线程，不要在主线程调用
|
||||||
|
Thread {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingIdSync()
|
||||||
|
|
||||||
|
gaidInfo?.let { info ->
|
||||||
|
println("GAID: ${info.id}")
|
||||||
|
}
|
||||||
|
}.start()
|
||||||
|
```
|
||||||
|
|
||||||
|
#### GAID 特点
|
||||||
|
- **格式**: UUID 格式的字符串
|
||||||
|
- **示例**: "38400000-8cf0-11bd-b23e-10b96e40000d"
|
||||||
|
- **依赖**: 需要 Google Play Services
|
||||||
|
- **用户控制**:
|
||||||
|
- 用户可以在设置中重置 GAID
|
||||||
|
- 用户可以选择限制广告追踪
|
||||||
|
- **权限**: 不需要特殊权限，但需要 Google Play Services
|
||||||
|
- **线程**: 必须在后台线程调用
|
||||||
|
|
||||||
|
### 4. 获取所有设备标识符
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 一次性获取所有标识符
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val identifiers = deviceInfo.getDeviceIdentifiers()
|
||||||
|
|
||||||
|
println("=== 设备标识符 ===")
|
||||||
|
println("Android ID: ${identifiers.androidId}")
|
||||||
|
|
||||||
|
identifiers.advertisingId?.let { gaid ->
|
||||||
|
println("GAID: ${gaid.id}")
|
||||||
|
println("限制追踪: ${gaid.isLimitAdTrackingEnabled}")
|
||||||
|
} ?: run {
|
||||||
|
println("GAID: 不可用")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 完整示例：设备信息收集
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class DeviceInfoActivity : AppCompatActivity() {
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
|
||||||
|
lifecycleScope.launch {
|
||||||
|
collectDeviceInfo()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private suspend fun collectDeviceInfo() {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
|
||||||
|
// 基本设备信息
|
||||||
|
val brand = deviceInfo.brand
|
||||||
|
val model = deviceInfo.model
|
||||||
|
val manufacturer = deviceInfo.manufacturer
|
||||||
|
|
||||||
|
// 设备标识符
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
// 显示信息
|
||||||
|
val info = buildString {
|
||||||
|
appendLine("=== 设备信息 ===")
|
||||||
|
appendLine("品牌: $brand")
|
||||||
|
appendLine("型号: $model")
|
||||||
|
appendLine("制造商: $manufacturer")
|
||||||
|
appendLine()
|
||||||
|
appendLine("=== 设备标识符 ===")
|
||||||
|
appendLine("Android ID: $androidId")
|
||||||
|
|
||||||
|
if (gaidInfo != null) {
|
||||||
|
appendLine("GAID: ${gaidInfo.id}")
|
||||||
|
appendLine("限制追踪: ${if (gaidInfo.isLimitAdTrackingEnabled) "是" else "否"}")
|
||||||
|
} else {
|
||||||
|
appendLine("GAID: 不可用（可能没有 Google Play Services）")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
println(info)
|
||||||
|
// 或显示在 UI 上
|
||||||
|
// textView.text = info
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 数据结构
|
||||||
|
|
||||||
|
### AdvertisingIdInfo
|
||||||
|
```kotlin
|
||||||
|
/**
|
||||||
|
* 广告标识符信息数据类
|
||||||
|
*/
|
||||||
|
data class AdvertisingIdInfo(
|
||||||
|
val id: String, // GAID
|
||||||
|
val isLimitAdTrackingEnabled: Boolean // 是否限制广告追踪
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### DeviceIdentifiers
|
||||||
|
```kotlin
|
||||||
|
/**
|
||||||
|
* 设备标识符集合数据类
|
||||||
|
*/
|
||||||
|
data class DeviceIdentifiers(
|
||||||
|
val androidId: String, // Android ID
|
||||||
|
val advertisingId: AdvertisingIdInfo? // GAID（可能为 null）
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Android ID vs GAID 对比
|
||||||
|
|
||||||
|
| 特性 | Android ID | GAID |
|
||||||
|
|------|-----------|------|
|
||||||
|
| **格式** | 64位十六进制 | UUID |
|
||||||
|
| **示例** | 9774d56d682e549c | 38400000-8cf0-11bd-b23e-10b96e40000d |
|
||||||
|
| **依赖** | 无 | Google Play Services |
|
||||||
|
| **权限** | 无需权限 | 无需权限 |
|
||||||
|
| **重置** | 出厂重置后改变 | 用户可随时重置 |
|
||||||
|
| **作用域** | Android 8.0+ 按应用区分 | 全局统一 |
|
||||||
|
| **用户控制** | 不可控制 | 可限制追踪 |
|
||||||
|
| **适用场景** | 应用内标识、设备绑定 | 广告追踪、分析 |
|
||||||
|
| **隐私友好** | 中等 | 高（用户可控） |
|
||||||
|
|
||||||
|
## 典型应用场景
|
||||||
|
|
||||||
|
### 1. 广告归因
|
||||||
|
```kotlin
|
||||||
|
suspend fun trackAdConversion(campaignId: String) {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
if (gaidInfo != null && !gaidInfo.isLimitAdTrackingEnabled) {
|
||||||
|
// 用户允许追踪，上报转化数据
|
||||||
|
analyticsService.trackConversion(
|
||||||
|
gaid = gaidInfo.id,
|
||||||
|
campaignId = campaignId
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
// 使用匿名方式或不追踪
|
||||||
|
analyticsService.trackAnonymousConversion(campaignId)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 用户设备管理
|
||||||
|
```kotlin
|
||||||
|
suspend fun registerDevice() {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val identifiers = deviceInfo.getDeviceIdentifiers()
|
||||||
|
|
||||||
|
// 注册设备信息
|
||||||
|
val deviceProfile = DeviceProfile(
|
||||||
|
androidId = identifiers.androidId,
|
||||||
|
brand = deviceInfo.brand,
|
||||||
|
model = deviceInfo.model,
|
||||||
|
timestamp = System.currentTimeMillis()
|
||||||
|
)
|
||||||
|
|
||||||
|
saveDeviceProfile(deviceProfile)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 防作弊检测
|
||||||
|
```kotlin
|
||||||
|
suspend fun checkDeviceFraud(): Boolean {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
|
||||||
|
// 检查设备是否被标记为作弊
|
||||||
|
return fraudDetectionService.isDeviceFlagged(androidId)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. A/B 测试分组
|
||||||
|
```kotlin
|
||||||
|
suspend fun getExperimentGroup(): String {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
// 使用 GAID 的哈希值进行分组
|
||||||
|
val deviceId = gaidInfo?.id ?: deviceInfo.getAndroidId()
|
||||||
|
val hash = deviceId.hashCode()
|
||||||
|
|
||||||
|
return if (hash % 2 == 0) "GroupA" else "GroupB"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 隐私合规检查
|
||||||
|
```kotlin
|
||||||
|
suspend fun checkPrivacyCompliance(): PrivacyStatus {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
return PrivacyStatus(
|
||||||
|
hasGooglePlayServices = gaidInfo != null,
|
||||||
|
isTrackingLimited = gaidInfo?.isLimitAdTrackingEnabled ?: true,
|
||||||
|
canUsePersonalizedAds = gaidInfo?.let { !it.isLimitAdTrackingEnabled } ?: false
|
||||||
|
)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 依赖配置
|
||||||
|
|
||||||
|
要使用 GAID 功能，需要在 `build.gradle` 中添加依赖：
|
||||||
|
|
||||||
|
```gradle
|
||||||
|
dependencies {
|
||||||
|
// Google Play Services - Advertising ID
|
||||||
|
implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
|
||||||
|
|
||||||
|
// Kotlin Coroutines（如果项目中还没有）
|
||||||
|
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
### 1. Android ID
|
||||||
|
- ⚠️ Android 8.0+ 后，每个应用获得的 Android ID 不同
|
||||||
|
- ⚠️ 出厂重置后会改变
|
||||||
|
- ⚠️ 不应用于跨应用追踪
|
||||||
|
- ✅ 适合应用内设备标识
|
||||||
|
|
||||||
|
### 2. GAID
|
||||||
|
- ⚠️ 需要 Google Play Services（国内设备可能不可用）
|
||||||
|
- ⚠️ 必须尊重用户的"限制广告追踪"设置
|
||||||
|
- ⚠️ 必须在后台线程调用
|
||||||
|
- ⚠️ 用户可以随时重置
|
||||||
|
- ✅ 适合广告归因和分析
|
||||||
|
- ✅ 符合 Google Play 政策
|
||||||
|
|
||||||
|
### 3. 隐私合规
|
||||||
|
- 📋 遵守 GDPR、CCPA 等隐私法规
|
||||||
|
- 📋 在隐私政策中说明标识符用途
|
||||||
|
- 📋 尊重用户的追踪限制选择
|
||||||
|
- 📋 提供用户删除数据的选项
|
||||||
|
|
||||||
|
### 4. 最佳实践
|
||||||
|
```kotlin
|
||||||
|
suspend fun getDeviceIdentifierForAnalytics(): String? {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
|
||||||
|
// 1. 优先使用 GAID（如果可用且用户允许）
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
if (gaidInfo != null && !gaidInfo.isLimitAdTrackingEnabled) {
|
||||||
|
return gaidInfo.id
|
||||||
|
}
|
||||||
|
|
||||||
|
// 2. 用户限制了追踪，不应该使用任何标识符
|
||||||
|
if (gaidInfo?.isLimitAdTrackingEnabled == true) {
|
||||||
|
return null // 返回 null 表示不追踪
|
||||||
|
}
|
||||||
|
|
||||||
|
// 3. GAID 不可用（可能是国内设备），使用 Android ID
|
||||||
|
// 注意：这种情况下应该获得用户明确同意
|
||||||
|
return if (hasUserConsent()) {
|
||||||
|
deviceInfo.getAndroidId()
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 示例输出
|
||||||
|
|
||||||
|
```
|
||||||
|
=== 设备信息 ===
|
||||||
|
品牌: Samsung
|
||||||
|
型号: SM-G998B
|
||||||
|
制造商: samsung
|
||||||
|
|
||||||
|
=== 设备标识符 ===
|
||||||
|
Android ID: 9774d56d682e549c
|
||||||
|
GAID: 38400000-8cf0-11bd-b23e-10b96e40000d
|
||||||
|
限制追踪: 否
|
||||||
|
```
|
||||||
|
|
||||||
|
## 完成度
|
||||||
|
|
||||||
|
✅ **100%** - 所有功能都已实现
|
||||||
|
- Android ID (Device ID) 获取 ✅
|
||||||
|
- GAID 获取（协程方式）✅
|
||||||
|
- GAID 获取（同步方式）✅
|
||||||
|
- 追踪限制状态检测 ✅
|
||||||
|
- 综合标识符获取 ✅
|
||||||
|
- 完整的中文注释 ✅
|
||||||
|
- 详细的使用文档 ✅
|
||||||
|
- 隐私合规建议 ✅
|
||||||
|
|
||||||
343
MemInfo内存类型检测使用示例.md
Normal file
343
MemInfo内存类型检测使用示例.md
Normal file
@ -0,0 +1,343 @@
|
|||||||
|
# MemInfo 内存类型检测使用示例
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
MemInfo 类提供了完整的内存信息检测功能，特别是增强了内存类型（LPDDR5、LPDDR4X等）的检测能力。
|
||||||
|
|
||||||
|
## 增强的功能
|
||||||
|
|
||||||
|
### 内存类型检测方法（5种）
|
||||||
|
|
||||||
|
1. **系统属性检测** - 从 Android 系统属性获取
|
||||||
|
- `ro.boot.ddr_type`
|
||||||
|
- `ro.boot.ddrtype`
|
||||||
|
- `ro.vendor.boot.ddr_type`
|
||||||
|
- `persist.vendor.ddr.type`
|
||||||
|
- 等多个属性路径
|
||||||
|
|
||||||
|
2. **Sysfs 文件系统检测** - 从设备文件系统读取
|
||||||
|
- Qualcomm 设备路径
|
||||||
|
- MediaTek 设备路径
|
||||||
|
- Samsung Exynos 设备路径
|
||||||
|
- 通用路径
|
||||||
|
|
||||||
|
3. **设备树检测** - 从设备树 (Device Tree) 获取
|
||||||
|
- `/proc/device-tree/memory/ddr-type`
|
||||||
|
- `/sys/firmware/devicetree/base/memory/ddr-type`
|
||||||
|
|
||||||
|
4. **内核日志检测** - 从 dmesg 日志分析
|
||||||
|
- 搜索 DDR、LPDDR、memory type 关键词
|
||||||
|
|
||||||
|
5. **智能推测** - 根据 Android 版本和发布年份估算
|
||||||
|
- Android 14+ (2023+) → LPDDR5X
|
||||||
|
- Android 13 (2022+) → LPDDR5
|
||||||
|
- Android 12 (2021+) → LPDDR5
|
||||||
|
- Android 11 (2020+) → LPDDR4X
|
||||||
|
- Android 10 (2019+) → LPDDR4X
|
||||||
|
|
||||||
|
### 支持的内存类型
|
||||||
|
|
||||||
|
- **LPDDR5X** - 最新旗舰设备（2023+）
|
||||||
|
- **LPDDR5** - 高端设备（2021-2023）
|
||||||
|
- **LPDDR4X** - 中高端设备（2019-2021）
|
||||||
|
- **LPDDR4** - 主流设备（2017-2019）
|
||||||
|
- **LPDDR3** - 老旧设备（2015-2017）
|
||||||
|
- **LPDDR2** - 更老设备（2013-2015）
|
||||||
|
- **DDR5/DDR4/DDR3** - 非移动设备
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 初始化
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
|
||||||
|
// 在 Application 或 Activity 中初始化
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 获取 MemInfo 实例
|
||||||
|
val memInfo = AndInfo.instance.mem
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 获取完整内存信息
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
println("=== 内存信息 ===")
|
||||||
|
println("总内存: ${memInfo.formatBytes(memoryInfo.totalRam)}")
|
||||||
|
println("可用内存: ${memInfo.formatBytes(memoryInfo.availableRam)}")
|
||||||
|
println("已使用: ${memInfo.formatBytes(memoryInfo.usedRam)}")
|
||||||
|
println("内存类型: ${memoryInfo.memType}")
|
||||||
|
println("内存通道: ${memoryInfo.channels} 通道")
|
||||||
|
println("ZRAM 总大小: ${memInfo.formatBytes(memoryInfo.zramTotal)}")
|
||||||
|
println("ZRAM 已使用: ${memInfo.formatBytes(memoryInfo.zramUsed)}")
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 仅获取内存类型
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
val memType = memoryInfo.memType
|
||||||
|
|
||||||
|
when {
|
||||||
|
memType.contains("LPDDR5X") -> {
|
||||||
|
println("✅ 最新旗舰内存：LPDDR5X")
|
||||||
|
println("特点：最高性能，最低功耗，用于2023年后的旗舰设备")
|
||||||
|
}
|
||||||
|
memType.contains("LPDDR5") -> {
|
||||||
|
println("✅ 高端内存：LPDDR5")
|
||||||
|
println("特点：高性能，低功耗，用于2021-2023年的高端设备")
|
||||||
|
}
|
||||||
|
memType.contains("LPDDR4X") -> {
|
||||||
|
println("✅ 主流内存：LPDDR4X")
|
||||||
|
println("特点：均衡性能与功耗，用于大多数中高端设备")
|
||||||
|
}
|
||||||
|
memType.contains("LPDDR4") -> {
|
||||||
|
println("✅ 标准内存：LPDDR4")
|
||||||
|
println("特点：标准性能，用于主流设备")
|
||||||
|
}
|
||||||
|
memType.contains("estimated") -> {
|
||||||
|
println("ℹ️ 估算的内存类型：$memType")
|
||||||
|
println("提示：系统无法直接读取内存类型，基于设备信息估算")
|
||||||
|
}
|
||||||
|
else -> {
|
||||||
|
println("❓ 未知内存类型")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 内存性能评估
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
// 评估内存性能等级
|
||||||
|
val performanceLevel = when {
|
||||||
|
memoryInfo.memType.contains("LPDDR5X") -> "旗舰级"
|
||||||
|
memoryInfo.memType.contains("LPDDR5") -> "高端"
|
||||||
|
memoryInfo.memType.contains("LPDDR4X") -> "中高端"
|
||||||
|
memoryInfo.memType.contains("LPDDR4") -> "中端"
|
||||||
|
else -> "入门"
|
||||||
|
}
|
||||||
|
|
||||||
|
println("内存性能等级: $performanceLevel")
|
||||||
|
println("理论带宽估算:")
|
||||||
|
|
||||||
|
when {
|
||||||
|
memoryInfo.memType.contains("LPDDR5X") -> {
|
||||||
|
val bandwidth = 8533 * memoryInfo.channels // LPDDR5X-8533
|
||||||
|
println(" 约 ${bandwidth} MB/s (${memoryInfo.channels}通道)")
|
||||||
|
}
|
||||||
|
memoryInfo.memType.contains("LPDDR5") -> {
|
||||||
|
val bandwidth = 6400 * memoryInfo.channels // LPDDR5-6400
|
||||||
|
println(" 约 ${bandwidth} MB/s (${memoryInfo.channels}通道)")
|
||||||
|
}
|
||||||
|
memoryInfo.memType.contains("LPDDR4X") -> {
|
||||||
|
val bandwidth = 4266 * memoryInfo.channels // LPDDR4X-4266
|
||||||
|
println(" 约 ${bandwidth} MB/s (${memoryInfo.channels}通道)")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 内存使用情况分析
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
// 计算使用率
|
||||||
|
val usagePercentage = (memoryInfo.usedRam.toDouble() / memoryInfo.totalRam * 100).toInt()
|
||||||
|
|
||||||
|
println("=== 内存使用情况 ===")
|
||||||
|
println("总内存: ${memInfo.formatBytes(memoryInfo.totalRam)}")
|
||||||
|
println("已使用: ${memInfo.formatBytes(memoryInfo.usedRam)} (${usagePercentage}%)")
|
||||||
|
println("可用: ${memInfo.formatBytes(memoryInfo.availableRam)}")
|
||||||
|
|
||||||
|
// 使用状态
|
||||||
|
when {
|
||||||
|
usagePercentage >= 90 -> println("⚠️ 内存严重不足")
|
||||||
|
usagePercentage >= 75 -> println("⚠️ 内存偏紧")
|
||||||
|
usagePercentage >= 50 -> println("✓ 内存使用正常")
|
||||||
|
else -> println("✓ 内存充裕")
|
||||||
|
}
|
||||||
|
|
||||||
|
// ZRAM 情况
|
||||||
|
if (memoryInfo.zramTotal > 0) {
|
||||||
|
val zramUsagePercent = (memoryInfo.zramUsed.toDouble() / memoryInfo.zramTotal * 100).toInt()
|
||||||
|
println("\n=== ZRAM (压缩内存) ===")
|
||||||
|
println("ZRAM 大小: ${memInfo.formatBytes(memoryInfo.zramTotal)}")
|
||||||
|
println("ZRAM 已使用: ${memInfo.formatBytes(memoryInfo.zramUsed)} (${zramUsagePercent}%)")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. 完整示例
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class MemoryInfoActivity : AppCompatActivity() {
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
|
||||||
|
displayMemoryInfo()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun displayMemoryInfo() {
|
||||||
|
val memInfo = AndInfo.instance.mem
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
val info = buildString {
|
||||||
|
appendLine("╔════════════════════════════════╗")
|
||||||
|
appendLine("║ 设备内存信息报告 ║")
|
||||||
|
appendLine("╚════════════════════════════════╝")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 内存容量
|
||||||
|
appendLine("【内存容量】")
|
||||||
|
appendLine(" 总内存：${memInfo.formatBytes(memoryInfo.totalRam)}")
|
||||||
|
appendLine(" 可用：${memInfo.formatBytes(memoryInfo.availableRam)}")
|
||||||
|
appendLine(" 已使用：${memInfo.formatBytes(memoryInfo.usedRam)}")
|
||||||
|
|
||||||
|
val usagePercent = (memoryInfo.usedRam.toDouble() / memoryInfo.totalRam * 100).toInt()
|
||||||
|
appendLine(" 使用率：${usagePercent}%")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 内存类型
|
||||||
|
appendLine("【内存规格】")
|
||||||
|
appendLine(" 类型：${memoryInfo.memType}")
|
||||||
|
appendLine(" 通道：${memoryInfo.channels} 通道")
|
||||||
|
|
||||||
|
// 性能评级
|
||||||
|
val perfLevel = when {
|
||||||
|
memoryInfo.memType.contains("LPDDR5X") -> "⭐⭐⭐⭐⭐ 旗舰级"
|
||||||
|
memoryInfo.memType.contains("LPDDR5") -> "⭐⭐⭐⭐ 高端"
|
||||||
|
memoryInfo.memType.contains("LPDDR4X") -> "⭐⭐⭐ 中高端"
|
||||||
|
memoryInfo.memType.contains("LPDDR4") -> "⭐⭐ 中端"
|
||||||
|
else -> "⭐ 入门"
|
||||||
|
}
|
||||||
|
appendLine(" 性能等级：$perfLevel")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// ZRAM 信息
|
||||||
|
if (memoryInfo.zramTotal > 0) {
|
||||||
|
appendLine("【ZRAM 压缩内存】")
|
||||||
|
appendLine(" 总大小：${memInfo.formatBytes(memoryInfo.zramTotal)}")
|
||||||
|
appendLine(" 已使用：${memInfo.formatBytes(memoryInfo.zramUsed)}")
|
||||||
|
val zramPercent = (memoryInfo.zramUsed.toDouble() / memoryInfo.zramTotal * 100).toInt()
|
||||||
|
appendLine(" 使用率：${zramPercent}%")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
println(info)
|
||||||
|
// 或者显示在 TextView 中
|
||||||
|
// textView.text = info
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 检测原理说明
|
||||||
|
|
||||||
|
### 1. 系统属性检测
|
||||||
|
```kotlin
|
||||||
|
// 尝试读取系统属性
|
||||||
|
getprop ro.boot.ddr_type
|
||||||
|
// 可能返回: "LPDDR5", "4", "5" 等
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Sysfs 文件检测
|
||||||
|
```kotlin
|
||||||
|
// Qualcomm 设备
|
||||||
|
/sys/class/devfreq/soc:qcom,cpu-cpu-llcc-bw/device/type
|
||||||
|
|
||||||
|
// MediaTek 设备
|
||||||
|
/sys/kernel/debug/emi_mbw/dram_type
|
||||||
|
|
||||||
|
// Samsung Exynos 设备
|
||||||
|
/sys/class/devfreq/17000010.devfreq_mif/device/type
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 设备树检测
|
||||||
|
```kotlin
|
||||||
|
// 设备树路径
|
||||||
|
/proc/device-tree/memory/ddr-type
|
||||||
|
/sys/firmware/devicetree/base/memory/ddr-type
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 内核日志检测
|
||||||
|
```bash
|
||||||
|
# 搜索内核日志
|
||||||
|
dmesg | grep -iE 'ddr|lpddr|memory.*type'
|
||||||
|
# 可能输出: "LPDDR5 detected", "DDR Type: 5" 等
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 智能推测规则
|
||||||
|
|
||||||
|
| Android 版本 | 发布年份 | 估算类型 |
|
||||||
|
|-------------|---------|---------|
|
||||||
|
| 14+ | 2023+ | LPDDR5X |
|
||||||
|
| 13 | 2022-2023 | LPDDR5 |
|
||||||
|
| 12 | 2021-2022 | LPDDR5 |
|
||||||
|
| 11 | 2020-2021 | LPDDR4X |
|
||||||
|
| 10 | 2019-2020 | LPDDR4X |
|
||||||
|
| 9 | 2018-2019 | LPDDR4 |
|
||||||
|
| ≤8 | ≤2017 | LPDDR3 |
|
||||||
|
|
||||||
|
## 典型设备示例
|
||||||
|
|
||||||
|
### 高端旗舰（2023+）
|
||||||
|
```
|
||||||
|
内存类型: LPDDR5X
|
||||||
|
通道: 4 通道
|
||||||
|
理论带宽: 约 34,132 MB/s
|
||||||
|
性能等级: ⭐⭐⭐⭐⭐ 旗舰级
|
||||||
|
代表设备: Samsung S24 Ultra, Xiaomi 14 Pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### 高端设备（2021-2023）
|
||||||
|
```
|
||||||
|
内存类型: LPDDR5
|
||||||
|
通道: 4 通道
|
||||||
|
理论带宽: 约 25,600 MB/s
|
||||||
|
性能等级: ⭐⭐⭐⭐ 高端
|
||||||
|
代表设备: Pixel 7 Pro, OnePlus 11
|
||||||
|
```
|
||||||
|
|
||||||
|
### 中高端设备（2019-2021）
|
||||||
|
```
|
||||||
|
内存类型: LPDDR4X
|
||||||
|
通道: 2 通道
|
||||||
|
理论带宽: 约 8,532 MB/s
|
||||||
|
性能等级: ⭐⭐⭐ 中高端
|
||||||
|
代表设备: Pixel 5, Mi 10T
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **权限要求**：
|
||||||
|
- 无需特殊权限
|
||||||
|
- 某些检测路径可能需要 root 权限才能访问
|
||||||
|
|
||||||
|
2. **检测准确性**：
|
||||||
|
- 优先级：系统属性 > Sysfs > 设备树 > 内核日志 > 估算
|
||||||
|
- 带 "(estimated)" 标记表示是推测值
|
||||||
|
|
||||||
|
3. **设备差异**：
|
||||||
|
- 不同厂商的设备，内存信息存储位置可能不同
|
||||||
|
- 某些定制 ROM 可能修改了相关路径
|
||||||
|
|
||||||
|
4. **性能差异**：
|
||||||
|
- 相同类型的内存，不同频率性能也不同
|
||||||
|
- 通道数会显著影响实际带宽
|
||||||
|
|
||||||
|
## 完成度
|
||||||
|
|
||||||
|
✅ **100%** - 所有功能都已实现
|
||||||
|
- 系统属性检测 ✅
|
||||||
|
- Sysfs 文件系统检测 ✅
|
||||||
|
- 设备树检测 ✅
|
||||||
|
- 内核日志检测 ✅
|
||||||
|
- 智能推测 ✅
|
||||||
|
- 内存类型解析 ✅
|
||||||
|
- 支持所有主流内存类型 ✅
|
||||||
|
- 完整的中文注释 ✅
|
||||||
|
- 详细的使用文档 ✅
|
||||||
|
|
||||||
|
所有功能都已正确实现并可以使用！🎉
|
||||||
|
|
||||||
@ -0,0 +1,710 @@
|
|||||||
|
package com.xyzshell.andinfo.collector
|
||||||
|
|
||||||
|
import android.content.Context
|
||||||
|
import android.os.Build
|
||||||
|
import com.google.gson.Gson
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
import com.xyzshell.andinfo.models.ApiResponse
|
||||||
|
import com.xyzshell.andinfo.models.DeviceInfoRequest
|
||||||
|
import com.xyzshell.andinfo.models.EncryptedRequest
|
||||||
|
import com.xyzshell.andinfo.utils.WebService
|
||||||
|
import com.xyzshell.andinfo.utils.upload_info_api
|
||||||
|
import kotlinx.coroutines.Dispatchers
|
||||||
|
import kotlinx.coroutines.async
|
||||||
|
import kotlinx.coroutines.withContext
|
||||||
|
import kotlinx.coroutines.coroutineScope
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备信息收集器
|
||||||
|
* 负责异步收集所有设备信息并上传到服务器
|
||||||
|
*/
|
||||||
|
class DeviceInfoCollector(private val context: Context) {
|
||||||
|
|
||||||
|
private val webService = WebService()
|
||||||
|
private val gson = Gson()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集所有设备信息
|
||||||
|
* 异步并发收集各类信息以提高性能
|
||||||
|
*
|
||||||
|
* @return DeviceInfoRequest 包含所有设备信息的数据对象
|
||||||
|
*/
|
||||||
|
suspend fun collectAllInfo(): DeviceInfoRequest = coroutineScope {
|
||||||
|
// 并发收集所有信息以提高性能
|
||||||
|
val cpuInfoDeferred = async { collectCpuInfo() }
|
||||||
|
val gpuInfoDeferred = async { collectGpuInfo() }
|
||||||
|
val screenInfoDeferred = async { collectScreenInfo() }
|
||||||
|
val memoryInfoDeferred = async { collectMemoryInfo() }
|
||||||
|
val diskInfoDeferred = async { collectDiskInfo() }
|
||||||
|
val networkInfoDeferred = async { collectNetworkInfo() }
|
||||||
|
val batteryInfoDeferred = async { collectBatteryInfo() }
|
||||||
|
val deviceInfoDeferred = async { collectDeviceInfo() }
|
||||||
|
val appInfoDeferred = async { collectAppInfo() }
|
||||||
|
val systemInfoDeferred = async { collectSystemInfo() }
|
||||||
|
val locationInfoDeferred = async { collectLocationInfo() }
|
||||||
|
val cameraInfoDeferred = async { collectCameraInfo() }
|
||||||
|
val sensorInfoDeferred = async { collectSensorInfo() }
|
||||||
|
val propsInfoDeferred = async { collectPropsInfo() }
|
||||||
|
val bluetoothInfoDeferred = async { collectBluetoothInfo() }
|
||||||
|
val wifiInfoDeferred = async { collectWifiInfo() }
|
||||||
|
val nfcInfoDeferred = async { collectNfcInfo() }
|
||||||
|
val usbInfoDeferred = async { collectUsbInfo() }
|
||||||
|
val buildInfoDeferred = async { collectBuildInfo() }
|
||||||
|
val drmInfoDeferred = async { collectDrmInfo() }
|
||||||
|
val inputInfoDeferred = async { collectInputInfo() }
|
||||||
|
val identifiersDeferred = async { collectIdentifiers() }
|
||||||
|
|
||||||
|
// 等待所有信息收集完成
|
||||||
|
val identifiers = identifiersDeferred.await()
|
||||||
|
|
||||||
|
DeviceInfoRequest(
|
||||||
|
cpuInfo = cpuInfoDeferred.await(),
|
||||||
|
gpuInfo = gpuInfoDeferred.await(),
|
||||||
|
screenInfo = screenInfoDeferred.await(),
|
||||||
|
memoryInfo = memoryInfoDeferred.await(),
|
||||||
|
diskInfo = diskInfoDeferred.await(),
|
||||||
|
networkInfo = networkInfoDeferred.await(),
|
||||||
|
batteryInfo = batteryInfoDeferred.await(),
|
||||||
|
deviceInfo = deviceInfoDeferred.await(),
|
||||||
|
appInfo = appInfoDeferred.await(),
|
||||||
|
systemInfo = systemInfoDeferred.await(),
|
||||||
|
locationInfo = locationInfoDeferred.await(),
|
||||||
|
cameraInfo = cameraInfoDeferred.await(),
|
||||||
|
sensorInfo = sensorInfoDeferred.await(),
|
||||||
|
propsInfo = propsInfoDeferred.await(),
|
||||||
|
bluetoothInfo = bluetoothInfoDeferred.await(),
|
||||||
|
wifiInfo = wifiInfoDeferred.await(),
|
||||||
|
nfcInfo = nfcInfoDeferred.await(),
|
||||||
|
usbInfo = usbInfoDeferred.await(),
|
||||||
|
buildInfo = buildInfoDeferred.await(),
|
||||||
|
deviceId = identifiers.first,
|
||||||
|
deviceName = identifiers.second,
|
||||||
|
drmInfo = drmInfoDeferred.await(),
|
||||||
|
inputInfo = inputInfoDeferred.await(),
|
||||||
|
gaid = identifiers.third
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集并上传设备信息到服务器
|
||||||
|
*
|
||||||
|
* @param callback 上传结果回调 (成功消息, 错误异常)
|
||||||
|
*/
|
||||||
|
suspend fun collectAndUpload(callback: (String?, Exception?) -> Unit) {
|
||||||
|
try {
|
||||||
|
// 1. 收集所有信息
|
||||||
|
val deviceInfo = collectAllInfo()
|
||||||
|
|
||||||
|
// 2. 序列化为 JSON
|
||||||
|
val jsonData = gson.toJson(deviceInfo)
|
||||||
|
|
||||||
|
// 3. AES 加密
|
||||||
|
val encrypted = withContext(Dispatchers.Default) {
|
||||||
|
webService.encrypt(jsonData)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 4. 构建加密请求
|
||||||
|
val encryptedRequest = EncryptedRequest(encrypted)
|
||||||
|
val requestJson = gson.toJson(encryptedRequest)
|
||||||
|
|
||||||
|
// 5. 发送 POST 请求
|
||||||
|
withContext(Dispatchers.IO) {
|
||||||
|
webService.postData(upload_info_api, requestJson) { response, error ->
|
||||||
|
if (error != null) {
|
||||||
|
callback(null, error)
|
||||||
|
} else if (response != null) {
|
||||||
|
try {
|
||||||
|
val apiResponse = gson.fromJson(response, ApiResponse::class.java)
|
||||||
|
if (apiResponse.isSuccess()) {
|
||||||
|
callback(apiResponse.message, null)
|
||||||
|
} else {
|
||||||
|
callback(null, Exception("上传失败: ${apiResponse.message}"))
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
callback(null, Exception("解析响应失败: ${e.message}"))
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
callback(null, Exception("响应为空"))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
callback(null, Exception("收集信息失败: ${e.message}"))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 CPU 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectCpuInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val cpuInfo = AndInfo.instance.cpu
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"cores" to cpuInfo.cores.size,
|
||||||
|
"processors" to cpuInfo.processors.size,
|
||||||
|
"cpuAbi" to Build.SUPPORTED_ABIS.firstOrNull()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 GPU 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectGpuInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val gpuInfo = AndInfo.instance.gpu
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"vendor" to gpuInfo.getVendorName(),
|
||||||
|
"renderer" to gpuInfo.getRendererName(),
|
||||||
|
"vulkanSupported" to gpuInfo.isVulkanSupported(),
|
||||||
|
"vulkanVersion" to gpuInfo.getVulkanApiVersion(),
|
||||||
|
"openglVersion" to gpuInfo.getOpenGLVersion(),
|
||||||
|
"openglExtensionCount" to gpuInfo.getOpenGLExtensionCount(),
|
||||||
|
"eglVersion" to gpuInfo.getEglVersion()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集磁盘信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectDiskInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val storageInfo = AndInfo.instance.storage
|
||||||
|
|
||||||
|
// 计算存储空间 GB
|
||||||
|
val totalStorageGB = String.format(java.util.Locale.US, "%.2f", storageInfo.internalStorageTotalSpace / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
val usedStorageGB = String.format(java.util.Locale.US, "%.2f", storageInfo.internalStorageUsedSpace / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
val freeStorageGB = String.format(java.util.Locale.US, "%.2f", storageInfo.internalStorageAvailableSpace / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 内部存储（字节）
|
||||||
|
"totalSpace" to storageInfo.internalStorageTotalSpace,
|
||||||
|
"freeSpace" to storageInfo.internalStorageAvailableSpace,
|
||||||
|
"usedSpace" to storageInfo.internalStorageUsedSpace,
|
||||||
|
|
||||||
|
// GB 单位
|
||||||
|
"totalStorageGB" to totalStorageGB,
|
||||||
|
"usedStorageGB" to usedStorageGB,
|
||||||
|
"freeStorageGB" to freeStorageGB,
|
||||||
|
|
||||||
|
// 数据目录 (/data)
|
||||||
|
"dataDirTotalSpace" to storageInfo.dataDirectoryTotalSpace,
|
||||||
|
"dataDirUsedSpace" to storageInfo.dataDirectoryUsedSpace,
|
||||||
|
|
||||||
|
// 文件系统类型
|
||||||
|
"fileSystemType" to storageInfo.internalStorageFileSystemType
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集屏幕信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectScreenInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val displayInfo = AndInfo.instance.display.getDefaultDisplayInfo()
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 分辨率
|
||||||
|
"maxWidthPixels" to (displayInfo?.widthPixels ?: -1),
|
||||||
|
"maxHeightPixels" to (displayInfo?.heightPixels ?: -1),
|
||||||
|
|
||||||
|
// DPI 和 PPI
|
||||||
|
"dpi" to (displayInfo?.densityDpi ?: -1),
|
||||||
|
"ppi" to (displayInfo?.ppi ?: -1),
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
// 刷新率
|
||||||
|
"maxRefreshRate" to (displayInfo?.refreshRate ?: -1),
|
||||||
|
"supportedRefreshRates" to (displayInfo?.supportedRefreshRates ?: emptyList<Float>()),
|
||||||
|
|
||||||
|
// HDR 支持
|
||||||
|
"isHdr" to (displayInfo?.isHdr ?: false),
|
||||||
|
"hdrTypes" to (displayInfo?.hdrTypes ?: emptyList<String>()),
|
||||||
|
|
||||||
|
// 广色域
|
||||||
|
"isWideColorGamut" to (displayInfo?.isWideColorGamut ?: false)
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集内存信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectMemoryInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val memoryInfo = AndInfo.instance.memory.getMemoryInfo()
|
||||||
|
val mem = deviceInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
// 计算总内存 GB
|
||||||
|
val totalMemoryGB = String.format(java.util.Locale.US, "%.2f", memoryInfo.totalRam / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
val availMemoryGB = String.format(java.util.Locale.US, "%.2f", memoryInfo.availableRam / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 原始字节数
|
||||||
|
"totalMem" to memoryInfo.totalRam,
|
||||||
|
"availMem" to memoryInfo.availableRam,
|
||||||
|
|
||||||
|
// GB 单位
|
||||||
|
"totalMemoryGB" to totalMemoryGB,
|
||||||
|
"availMemoryGB" to availMemoryGB,
|
||||||
|
|
||||||
|
// RAM 类型（需要从系统属性推测）
|
||||||
|
"ramType" to memoryInfo.memType,
|
||||||
|
|
||||||
|
// 内存状态
|
||||||
|
"lowMemory" to mem.lowMemory,
|
||||||
|
"threshold" to mem.threshold
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集网络信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectNetworkInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// SIM 卡相关
|
||||||
|
"simSlotCount" to getSimSlotCount(),
|
||||||
|
"supportEsim" to isEsimSupported(),
|
||||||
|
|
||||||
|
// 网络类型（5G/4G/3G）
|
||||||
|
"cellularGen" to getCellularGeneration(),
|
||||||
|
|
||||||
|
// WiFi 版本
|
||||||
|
"maxWifiVersion" to getMaxWifiVersion(),
|
||||||
|
|
||||||
|
// 蓝牙版本
|
||||||
|
"bluetoothVersion" to bluetoothInfo.getBluetoothVersion(),
|
||||||
|
|
||||||
|
// NFC 支持
|
||||||
|
"hasNFC" to inputInfo.hasNfcSupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取 SIM 卡槽数量
|
||||||
|
*/
|
||||||
|
private fun getSimSlotCount(): Int {
|
||||||
|
return try {
|
||||||
|
val telephonyManager = context.getSystemService(Context.TELEPHONY_SERVICE) as? android.telephony.TelephonyManager
|
||||||
|
telephonyManager?.phoneCount ?: 0
|
||||||
|
} catch (_: Exception) {
|
||||||
|
0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检测是否支持 eSIM
|
||||||
|
*/
|
||||||
|
@android.annotation.SuppressLint("MissingPermission")
|
||||||
|
private fun isEsimSupported(): Boolean {
|
||||||
|
return try {
|
||||||
|
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
|
||||||
|
val telephonyManager = context.getSystemService(Context.TELEPHONY_SERVICE) as? android.telephony.TelephonyManager
|
||||||
|
telephonyManager?.let {
|
||||||
|
it.isMultiSimSupported == android.telephony.TelephonyManager.MULTISIM_ALLOWED &&
|
||||||
|
context.packageManager.hasSystemFeature(android.content.pm.PackageManager.FEATURE_TELEPHONY_EUICC)
|
||||||
|
} ?: false
|
||||||
|
} else {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
} catch (_: Exception) {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取最大蜂窝网络代数 (3/4/5)
|
||||||
|
*/
|
||||||
|
private fun getCellularGeneration(): Int {
|
||||||
|
return try {
|
||||||
|
// 检查是否支持5G
|
||||||
|
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
|
||||||
|
if (context.packageManager.hasSystemFeature("android.hardware.telephony.5g")) {
|
||||||
|
return 5
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// 检查4G LTE
|
||||||
|
if (context.packageManager.hasSystemFeature(android.content.pm.PackageManager.FEATURE_TELEPHONY_GSM)) {
|
||||||
|
return 4
|
||||||
|
}
|
||||||
|
3 // 默认3G
|
||||||
|
} catch (_: Exception) {
|
||||||
|
4 // 默认返回4G
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取最大 WiFi 版本
|
||||||
|
* 8=WiFi 7, 7=WiFi 6E, 6=WiFi 6, 5=WiFi 5
|
||||||
|
*/
|
||||||
|
private fun getMaxWifiVersion(): Int {
|
||||||
|
return try {
|
||||||
|
when {
|
||||||
|
Build.VERSION.SDK_INT >= 34 && context.packageManager.hasSystemFeature("android.hardware.wifi.wifi7") -> 8 // WiFi 7
|
||||||
|
Build.VERSION.SDK_INT >= 31 && context.packageManager.hasSystemFeature("android.hardware.wifi.wifi6e") -> 7 // WiFi 6E
|
||||||
|
Build.VERSION.SDK_INT >= 30 && context.packageManager.hasSystemFeature("android.hardware.wifi.wifi6") -> 6 // WiFi 6
|
||||||
|
context.packageManager.hasSystemFeature("android.hardware.wifi.wifi5") -> 5 // WiFi 5
|
||||||
|
else -> 4 // WiFi 4 (802.11n)
|
||||||
|
}
|
||||||
|
} catch (_: Exception) {
|
||||||
|
5 // 默认 WiFi 5
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集电池信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectBatteryInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val batteryInfo = AndInfo.instance.battery
|
||||||
|
val details = batteryInfo.getBatteryDetails()
|
||||||
|
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 电池状态
|
||||||
|
"level" to details.percentage,
|
||||||
|
"health" to details.health,
|
||||||
|
"temperature" to details.temperature,
|
||||||
|
"voltage" to details.voltage,
|
||||||
|
"status" to details.status,
|
||||||
|
|
||||||
|
// 电池容量（毫安时）
|
||||||
|
"batteryDesignCapacity" to details.capacity,
|
||||||
|
"batteryCurrentCapacity" to details.chargeCounter,
|
||||||
|
|
||||||
|
// 充电相关
|
||||||
|
"isCharging" to details.isCharging,
|
||||||
|
"plugType" to details.plugType,
|
||||||
|
|
||||||
|
// 无线充电支持（需要检测）
|
||||||
|
"batteryWirelessSupported" to batteryInfo.isWirelessChargingSupported()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集设备信息 (phone.hardware_new 表字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectDeviceInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 基本信息
|
||||||
|
"brand" to deviceInfo.brand,
|
||||||
|
"model" to deviceInfo.model,
|
||||||
|
"manufacturer" to deviceInfo.manufacturer,
|
||||||
|
"device" to buildInfo.device,
|
||||||
|
|
||||||
|
// 硬件信息
|
||||||
|
"hardware" to deviceInfo.hardwareName,
|
||||||
|
"board" to deviceInfo.boardName,
|
||||||
|
|
||||||
|
// 设备类型
|
||||||
|
"formFactor" to buildInfo.formFactor,
|
||||||
|
"isTablet" to buildInfo.isTablet,
|
||||||
|
"isPhone" to buildInfo.isPhone,
|
||||||
|
|
||||||
|
// 架构信息
|
||||||
|
"linuxArchitecture" to buildInfo.kernelArchitecture,
|
||||||
|
|
||||||
|
// SoC 信息
|
||||||
|
"socManufacturer" to deviceInfo.socManufacturer,
|
||||||
|
"socModel" to deviceInfo.socModel,
|
||||||
|
|
||||||
|
// SKU 信息
|
||||||
|
"sku" to deviceInfo.hardwareSku,
|
||||||
|
"odmSku" to deviceInfo.odmSku
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集应用信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectAppInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"packageName" to context.packageName,
|
||||||
|
"versionName" to context.packageManager.getPackageInfo(context.packageName, 0).versionName
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集系统信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectSystemInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"androidVersion" to buildInfo.versionRelease,
|
||||||
|
"sdkInt" to buildInfo.versionSdkInt,
|
||||||
|
"securityPatch" to buildInfo.securityPatch
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集定位信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectLocationInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"gpsSupported" to inputInfo.hasGpsSupport(),
|
||||||
|
"networkLocationSupported" to inputInfo.hasNetworkLocationSupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集相机信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectCameraInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val cameraInfo = AndInfo.instance.camera
|
||||||
|
val cameraIdList = cameraInfo.cameraIds
|
||||||
|
val cameraList = cameraIdList.mapNotNull { cameraInfo.getCameraDetails(it) }
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"cameraCount" to cameraList.size,
|
||||||
|
"cameras" to cameraList.map { it.cameraId }
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集传感器信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectSensorInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val sensorInfo = AndInfo.instance.sensor
|
||||||
|
val sensors = sensorInfo.getAllSensors()
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"sensorCount" to sensors.size,
|
||||||
|
"sensorTypes" to sensors.map { it.stringType }
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集系统属性信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectPropsInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"fingerprint" to buildInfo.fingerprint,
|
||||||
|
"display" to buildInfo.display,
|
||||||
|
"id" to buildInfo.id
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集蓝牙信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectBluetoothInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"supported" to bluetoothInfo.isBluetoothLeSupported,
|
||||||
|
"enabled" to bluetoothInfo.isEnabled,
|
||||||
|
"name" to bluetoothInfo.adapterName
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 WiFi 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectWifiInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"supported" to true
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 NFC 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectNfcInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"supported" to inputInfo.hasNfcSupport(),
|
||||||
|
"hceSupported" to inputInfo.hasNfcHostCardEmulation(),
|
||||||
|
"secureNfc" to inputInfo.hasSecureNfcSupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 USB 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectUsbInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"hostSupported" to inputInfo.hasUsbHostSupport(),
|
||||||
|
"accessorySupported" to inputInfo.hasUsbAccessorySupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集构建信息 (phone.build 表字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectBuildInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 基本信息
|
||||||
|
"brand" to buildInfo.brand,
|
||||||
|
"model" to buildInfo.model,
|
||||||
|
"device" to buildInfo.device,
|
||||||
|
"product" to buildInfo.product,
|
||||||
|
|
||||||
|
// SDK 和版本信息
|
||||||
|
"sdkInt" to buildInfo.versionSdkInt,
|
||||||
|
"androidVersion" to buildInfo.versionRelease,
|
||||||
|
|
||||||
|
// 构建信息
|
||||||
|
"buildId" to buildInfo.id,
|
||||||
|
"bootloader" to buildInfo.bootloaderVersion,
|
||||||
|
"display" to buildInfo.display,
|
||||||
|
"buildUser" to buildInfo.user,
|
||||||
|
"incremental" to buildInfo.incremental,
|
||||||
|
"buildHost" to buildInfo.host,
|
||||||
|
"buildFingerprint" to buildInfo.fingerprint,
|
||||||
|
|
||||||
|
// RIL 和 CSC 信息（三星专用）
|
||||||
|
"rilProductCode" to buildInfo.rilProductCode,
|
||||||
|
"rilOfficialCscver" to buildInfo.rilOfficialCscver,
|
||||||
|
"cscSalesCode" to buildInfo.cscSalesCode,
|
||||||
|
"countryISO" to buildInfo.countryISO,
|
||||||
|
|
||||||
|
// 内核和安全信息
|
||||||
|
"kernelVersion" to buildInfo.kernelVersion,
|
||||||
|
"securityPatch" to buildInfo.securityPatch,
|
||||||
|
"releaseDate" to buildInfo.buildDate.time,
|
||||||
|
|
||||||
|
// Treble 和系统更新
|
||||||
|
"trebleEnabled" to buildInfo.isTrebleEnabled,
|
||||||
|
"trebleVersion" to buildInfo.trebleVersion,
|
||||||
|
"seamlessUpdate" to buildInfo.isSeamlessUpdateSupported,
|
||||||
|
"currentSlot" to buildInfo.currentSlot,
|
||||||
|
|
||||||
|
// Root 和安全
|
||||||
|
"isRooted" to buildInfo.isRooted,
|
||||||
|
"seLinuxStatus" to buildInfo.seLinuxStatus
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 DRM 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectDrmInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val drmInfo = AndInfo.instance.drm
|
||||||
|
val drmSchemes = drmInfo.getSupportedDrmSchemes()
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"supportedSchemes" to drmSchemes.size,
|
||||||
|
"schemes" to drmSchemes.map { it.toString() }
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集输入设备信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectInputInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
val devices = inputInfo.getInputDevices()
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"deviceCount" to devices.size,
|
||||||
|
"hasFingerprint" to inputInfo.hasFingerprintSensor(),
|
||||||
|
"hasInfrared" to inputInfo.hasInfraredSensor(),
|
||||||
|
"hasUwb" to inputInfo.hasUwbSupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集设备标识符（Device ID 和 GAID）
|
||||||
|
*
|
||||||
|
* @return Triple<DeviceId, DeviceName, GAID>
|
||||||
|
*/
|
||||||
|
private suspend fun collectIdentifiers(): Triple<String, String, String> = withContext(Dispatchers.IO) {
|
||||||
|
try {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
val deviceName = "${deviceInfo.brand} ${deviceInfo.model}"
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
val gaid = gaidInfo?.id ?: ""
|
||||||
|
|
||||||
|
Triple(androidId, deviceName, gaid)
|
||||||
|
} catch (_: Exception) {
|
||||||
|
Triple("unknown", "unknown", "")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
@ -16,7 +16,9 @@ data class BatteryDetails(
|
|||||||
val maxInput: Int?, // in mA 最大输入电流
|
val maxInput: Int?, // in mA 最大输入电流
|
||||||
val capacity: Double?, // in mAh 电池容量
|
val capacity: Double?, // in mAh 电池容量
|
||||||
val chargeCounter: Int?, // in mAh 电量计量
|
val chargeCounter: Int?, // in mAh 电量计量
|
||||||
val chargeCycles: Int? // estimated cycles 充电周期 (估计值)
|
val chargeCycles: Int?, // estimated cycles 充电周期 (估计值)
|
||||||
|
val plugType: String, // 充电类型 (USB, AC, WIRELESS, NONE)
|
||||||
|
val status: String // 电池状态 (Charging, Discharging, Full, Not Charging, Unknown)
|
||||||
)
|
)
|
||||||
|
|
||||||
class BatteryInfo(private val context: Context) {
|
class BatteryInfo(private val context: Context) {
|
||||||
@ -84,6 +86,23 @@ class BatteryInfo(private val context: Context) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// 充电类型
|
||||||
|
val plugType = when (batteryStatus?.getIntExtra(BatteryManager.EXTRA_PLUGGED, -1) ?: -1) {
|
||||||
|
BatteryManager.BATTERY_PLUGGED_USB -> "USB"
|
||||||
|
BatteryManager.BATTERY_PLUGGED_AC -> "AC"
|
||||||
|
BatteryManager.BATTERY_PLUGGED_WIRELESS -> "WIRELESS"
|
||||||
|
else -> "NONE"
|
||||||
|
}
|
||||||
|
|
||||||
|
// 电池状态
|
||||||
|
val statusText = when (status) {
|
||||||
|
BatteryManager.BATTERY_STATUS_CHARGING -> "Charging"
|
||||||
|
BatteryManager.BATTERY_STATUS_DISCHARGING -> "Discharging"
|
||||||
|
BatteryManager.BATTERY_STATUS_FULL -> "Full"
|
||||||
|
BatteryManager.BATTERY_STATUS_NOT_CHARGING -> "Not Charging"
|
||||||
|
else -> "Unknown"
|
||||||
|
}
|
||||||
|
|
||||||
return BatteryDetails(
|
return BatteryDetails(
|
||||||
percentage = percentage,
|
percentage = percentage,
|
||||||
isCharging = isCharging,
|
isCharging = isCharging,
|
||||||
@ -95,7 +114,20 @@ class BatteryInfo(private val context: Context) {
|
|||||||
maxInput = maxInput,
|
maxInput = maxInput,
|
||||||
capacity = capacity,
|
capacity = capacity,
|
||||||
chargeCounter = chargeCounter,
|
chargeCounter = chargeCounter,
|
||||||
chargeCycles = chargeCycles
|
chargeCycles = chargeCycles,
|
||||||
|
plugType = plugType,
|
||||||
|
status = statusText
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检测是否支持无线充电
|
||||||
|
*/
|
||||||
|
fun isWirelessChargingSupported(): Boolean {
|
||||||
|
return try {
|
||||||
|
context.packageManager.hasSystemFeature("android.hardware.wireless_charging")
|
||||||
|
} catch (_: Exception) {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
@ -366,29 +366,135 @@ class BluetoothInfo(private val context: Context) {
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 获取蓝牙版本（根据支持的特性推断）
|
* 获取蓝牙版本（根据支持的特性推断）
|
||||||
|
*
|
||||||
|
* 版本判断依据：
|
||||||
|
* - Bluetooth 5.4: Android 14+ 支持 LE Audio with LC3plus
|
||||||
|
* - Bluetooth 5.3: Android 13+ 支持 LE Audio
|
||||||
|
* - Bluetooth 5.2: Android 13+ 支持 LE Audio 基础功能
|
||||||
|
* - Bluetooth 5.1: Android 10+ 支持方向查找
|
||||||
|
* - Bluetooth 5.0: Android 8+ 支持 2Mbps PHY 或 Coded PHY
|
||||||
|
* - Bluetooth 4.2: Android 6+ 支持 BLE
|
||||||
|
* - Bluetooth 4.0: 支持 BLE
|
||||||
|
* - Bluetooth 3.0 或更低: 仅支持经典蓝牙
|
||||||
|
*
|
||||||
|
* @return 蓝牙版本字符串
|
||||||
*/
|
*/
|
||||||
private fun getBluetoothVersion(): String {
|
fun getBluetoothVersion(): String {
|
||||||
val adapter = bluetoothAdapter ?: return "未知"
|
val adapter = bluetoothAdapter ?: return "未知"
|
||||||
|
|
||||||
return when {
|
return when {
|
||||||
|
// Bluetooth 5.4+ (Android 14+, 支持 LC3plus 编解码器)
|
||||||
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE &&
|
||||||
|
context.packageManager.hasSystemFeature("android.hardware.bluetooth.le.audio") ->
|
||||||
|
"5.4"
|
||||||
|
|
||||||
|
// Bluetooth 5.3 (Android 13+, 支持 LE Audio)
|
||||||
Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU &&
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU &&
|
||||||
context.packageManager.hasSystemFeature("android.hardware.bluetooth.le.audio") ->
|
context.packageManager.hasSystemFeature("android.hardware.bluetooth.le.audio") ->
|
||||||
"Bluetooth 5.2+"
|
"5.3"
|
||||||
|
|
||||||
|
// Bluetooth 5.2 (Android 12+, 支持 LE Audio 基础功能)
|
||||||
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.S &&
|
||||||
|
context.packageManager.hasSystemFeature("android.hardware.bluetooth.le.audio") ->
|
||||||
|
"5.2"
|
||||||
|
|
||||||
|
// Bluetooth 5.1 (Android 10+, 支持方向查找)
|
||||||
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q &&
|
||||||
|
(adapter.isLe2MPhySupported || adapter.isLeCodedPhySupported ||
|
||||||
|
adapter.isLeExtendedAdvertisingSupported) ->
|
||||||
|
"5.1"
|
||||||
|
|
||||||
|
// Bluetooth 5.0 (Android 8+, 支持 2Mbps PHY 或 Coded PHY)
|
||||||
Build.VERSION.SDK_INT >= Build.VERSION_CODES.O &&
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.O &&
|
||||||
(adapter.isLe2MPhySupported || adapter.isLeCodedPhySupported) ->
|
(adapter.isLe2MPhySupported || adapter.isLeCodedPhySupported) ->
|
||||||
"Bluetooth 5.0"
|
"5.0"
|
||||||
|
|
||||||
|
// Bluetooth 4.2 (Android 6+, 支持增强的 BLE)
|
||||||
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && isBluetoothLeSupported ->
|
||||||
|
"4.2"
|
||||||
|
|
||||||
|
// Bluetooth 4.1 (Android 5+, 支持 BLE)
|
||||||
Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP && isBluetoothLeSupported ->
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP && isBluetoothLeSupported ->
|
||||||
"Bluetooth 4.2"
|
"4.1"
|
||||||
|
|
||||||
|
// Bluetooth 4.0 (Android 4.3+, 首次支持 BLE)
|
||||||
isBluetoothLeSupported ->
|
isBluetoothLeSupported ->
|
||||||
"Bluetooth 4.0"
|
"4.0"
|
||||||
|
|
||||||
|
// Bluetooth 3.0 或更低（仅经典蓝牙）
|
||||||
else ->
|
else ->
|
||||||
"Bluetooth 3.0 或更低"
|
"3.0 或更低"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取详细的蓝牙版本信息（包含版本号和特性说明）
|
||||||
|
*
|
||||||
|
* @return 包含版本号和特性的详细字符串
|
||||||
|
*/
|
||||||
|
fun getBluetoothVersionDetails(): String {
|
||||||
|
val version = getBluetoothVersion()
|
||||||
|
val features = getBluetoothFeatures()
|
||||||
|
|
||||||
|
val details = buildString {
|
||||||
|
append("蓝牙 $version")
|
||||||
|
|
||||||
|
when {
|
||||||
|
version.startsWith("5.4") || version.startsWith("5.3") -> {
|
||||||
|
append(" (")
|
||||||
|
append("LE Audio")
|
||||||
|
if (features.leAudioBroadcast) append(", 广播")
|
||||||
|
if (features.leAudioUnicast) append(", 单播")
|
||||||
|
if (features.le2MbPhy) append(", 2Mbps PHY")
|
||||||
|
if (features.leCodedPhy) append(", Coded PHY")
|
||||||
|
append(")")
|
||||||
|
}
|
||||||
|
version.startsWith("5.2") -> {
|
||||||
|
append(" (LE Audio, LE Power Control)")
|
||||||
|
}
|
||||||
|
version.startsWith("5.1") -> {
|
||||||
|
append(" (方向查找, GATT 缓存)")
|
||||||
|
}
|
||||||
|
version.startsWith("5.0") -> {
|
||||||
|
append(" (")
|
||||||
|
val bt5Features = mutableListOf<String>()
|
||||||
|
if (features.le2MbPhy) bt5Features.add("2Mbps PHY")
|
||||||
|
if (features.leCodedPhy) bt5Features.add("Coded PHY")
|
||||||
|
if (features.leExtendedAdvertising) bt5Features.add("扩展广播")
|
||||||
|
if (features.lePeriodicAdvertising) bt5Features.add("周期性广播")
|
||||||
|
append(bt5Features.joinToString(", "))
|
||||||
|
append(")")
|
||||||
|
}
|
||||||
|
version.startsWith("4") -> {
|
||||||
|
append(" (低功耗蓝牙)")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return details
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取蓝牙版本的数字格式
|
||||||
|
*
|
||||||
|
* @return 版本号（如 5.3, 5.0, 4.2 等），如果无法确定则返回 0.0
|
||||||
|
*/
|
||||||
|
fun getBluetoothVersionNumber(): Double {
|
||||||
|
val versionString = getBluetoothVersion()
|
||||||
|
return when {
|
||||||
|
versionString.startsWith("5.4") -> 5.4
|
||||||
|
versionString.startsWith("5.3") -> 5.3
|
||||||
|
versionString.startsWith("5.2") -> 5.2
|
||||||
|
versionString.startsWith("5.1") -> 5.1
|
||||||
|
versionString.startsWith("5.0") -> 5.0
|
||||||
|
versionString.startsWith("4.2") -> 4.2
|
||||||
|
versionString.startsWith("4.1") -> 4.1
|
||||||
|
versionString.startsWith("4.0") -> 4.0
|
||||||
|
versionString.startsWith("3") -> 3.0
|
||||||
|
else -> 0.0
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@ -3,8 +3,11 @@ package com.xyzshell.andinfo.libs
|
|||||||
import android.app.ActivityManager
|
import android.app.ActivityManager
|
||||||
import android.content.Context
|
import android.content.Context
|
||||||
import android.os.Build
|
import android.os.Build
|
||||||
|
import android.provider.Settings
|
||||||
|
import kotlinx.coroutines.Dispatchers
|
||||||
|
import kotlinx.coroutines.withContext
|
||||||
|
|
||||||
// 设备信息工具类
|
// 设备信息工具类
|
||||||
class DeviceInfo(private val context: Context) {
|
class DeviceInfo(private val context: Context) {
|
||||||
|
|
||||||
// ActivityManager 用于获取内存等系统服务
|
// ActivityManager 用于获取内存等系统服务
|
||||||
@ -63,4 +66,137 @@ class DeviceInfo(private val context: Context) {
|
|||||||
activityManager.getMemoryInfo(memoryInfo)
|
activityManager.getMemoryInfo(memoryInfo)
|
||||||
return memoryInfo
|
return memoryInfo
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ==================== 设备标识符 ====================
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取 Android ID (Device ID)
|
||||||
|
* 64位十六进制字符串，设备首次启动时随机生成
|
||||||
|
*
|
||||||
|
* 注意事项：
|
||||||
|
* - 出厂重置后会改变
|
||||||
|
* - Android 8.0+ 后，每个应用和用户组合都会获得不同的 Android ID
|
||||||
|
* - 不需要特殊权限
|
||||||
|
*
|
||||||
|
* @return Android ID，如果获取失败则返回 "unknown"
|
||||||
|
*/
|
||||||
|
@Suppress("HardwareIds")
|
||||||
|
fun getAndroidId(): String {
|
||||||
|
return try {
|
||||||
|
Settings.Secure.getString(context.contentResolver, Settings.Secure.ANDROID_ID) ?: "unknown"
|
||||||
|
} catch (e: Exception) {
|
||||||
|
"unknown"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取 Google Advertising ID (GAID)
|
||||||
|
* 用于广告追踪的匿名标识符
|
||||||
|
*
|
||||||
|
* 注意事项：
|
||||||
|
* - 需要 Google Play Services
|
||||||
|
* - 用户可以重置此 ID
|
||||||
|
* - 用户可以选择限制广告追踪
|
||||||
|
* - 必须在后台线程调用
|
||||||
|
* - 需要添加依赖: com.google.android.gms:play-services-ads-identifier
|
||||||
|
*
|
||||||
|
* 使用示例：
|
||||||
|
* ```kotlin
|
||||||
|
* lifecycleScope.launch {
|
||||||
|
* val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
* if (gaidInfo != null) {
|
||||||
|
* println("GAID: ${gaidInfo.id}")
|
||||||
|
* println("是否限制追踪: ${gaidInfo.isLimitAdTrackingEnabled}")
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @return AdvertisingIdInfo 对象，包含 GAID 和追踪限制状态；如果获取失败则返回 null
|
||||||
|
*/
|
||||||
|
suspend fun getAdvertisingId(): AdvertisingIdInfo? = withContext(Dispatchers.IO) {
|
||||||
|
try {
|
||||||
|
// 使用反射调用 AdvertisingIdClient，避免强制依赖
|
||||||
|
val advertisingIdClientClass = Class.forName("com.google.android.gms.ads.identifier.AdvertisingIdClient")
|
||||||
|
val getAdvertisingIdInfoMethod = advertisingIdClientClass.getMethod("getAdvertisingIdInfo", Context::class.java)
|
||||||
|
val adInfo = getAdvertisingIdInfoMethod.invoke(null, context)
|
||||||
|
|
||||||
|
// 获取 ID 和追踪限制状态
|
||||||
|
val getId = adInfo.javaClass.getMethod("getId")
|
||||||
|
val isLimitAdTrackingEnabled = adInfo.javaClass.getMethod("isLimitAdTrackingEnabled")
|
||||||
|
|
||||||
|
val id = getId.invoke(adInfo) as? String
|
||||||
|
val isLimited = isLimitAdTrackingEnabled.invoke(adInfo) as? Boolean ?: false
|
||||||
|
|
||||||
|
if (id != null) {
|
||||||
|
AdvertisingIdInfo(id, isLimited)
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
// Google Play Services 不可用或其他错误
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 同步获取 GAID（不推荐，可能阻塞线程）
|
||||||
|
* 仅用于特殊场景，建议使用 getAdvertisingId() 的协程版本
|
||||||
|
*
|
||||||
|
* @return AdvertisingIdInfo 对象或 null
|
||||||
|
*/
|
||||||
|
fun getAdvertisingIdSync(): AdvertisingIdInfo? {
|
||||||
|
return try {
|
||||||
|
val advertisingIdClientClass = Class.forName("com.google.android.gms.ads.identifier.AdvertisingIdClient")
|
||||||
|
val getAdvertisingIdInfoMethod = advertisingIdClientClass.getMethod("getAdvertisingIdInfo", Context::class.java)
|
||||||
|
val adInfo = getAdvertisingIdInfoMethod.invoke(null, context)
|
||||||
|
|
||||||
|
val getId = adInfo.javaClass.getMethod("getId")
|
||||||
|
val isLimitAdTrackingEnabled = adInfo.javaClass.getMethod("isLimitAdTrackingEnabled")
|
||||||
|
|
||||||
|
val id = getId.invoke(adInfo) as? String
|
||||||
|
val isLimited = isLimitAdTrackingEnabled.invoke(adInfo) as? Boolean ?: false
|
||||||
|
|
||||||
|
if (id != null) {
|
||||||
|
AdvertisingIdInfo(id, isLimited)
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 广告标识符信息数据类
|
||||||
|
*
|
||||||
|
* @property id Google Advertising ID (GAID)
|
||||||
|
* @property isLimitAdTrackingEnabled 用户是否限制广告追踪
|
||||||
|
*/
|
||||||
|
data class AdvertisingIdInfo(
|
||||||
|
val id: String, // GAID，示例: "38400000-8cf0-11bd-b23e-10b96e40000d"
|
||||||
|
val isLimitAdTrackingEnabled: Boolean // 是否限制广告追踪
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取所有可用的设备标识符
|
||||||
|
*
|
||||||
|
* @return DeviceIdentifiers 对象，包含所有标识符
|
||||||
|
*/
|
||||||
|
suspend fun getDeviceIdentifiers(): DeviceIdentifiers {
|
||||||
|
return DeviceIdentifiers(
|
||||||
|
androidId = getAndroidId(),
|
||||||
|
advertisingId = getAdvertisingId()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备标识符集合数据类
|
||||||
|
*
|
||||||
|
* @property androidId Android ID (设备标识符)
|
||||||
|
* @property advertisingId 广告标识符信息（可能为 null）
|
||||||
|
*/
|
||||||
|
data class DeviceIdentifiers(
|
||||||
|
val androidId: String, // Android ID
|
||||||
|
val advertisingId: AdvertisingIdInfo? // 广告标识符（如果可用）
|
||||||
|
)
|
||||||
}
|
}
|
||||||
|
|||||||
@ -3,18 +3,30 @@ package com.xyzshell.andinfo.libs
|
|||||||
import android.content.Context
|
import android.content.Context
|
||||||
import java.io.File
|
import java.io.File
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 内存信息数据类
|
||||||
|
* 包含设备的完整内存信息
|
||||||
|
*/
|
||||||
data class MemoryInfo(
|
data class MemoryInfo(
|
||||||
val totalRam: Long, // 总内存 (字节)
|
val totalRam: Long, // 总内存 (字节)
|
||||||
val availableRam: Long, // 可用内存 (字节)
|
val availableRam: Long, // 可用内存 (字节)
|
||||||
val usedRam: Long, // 已使用内存 (字节)
|
val usedRam: Long, // 已使用内存 (字节)
|
||||||
val memType: String, // 内存类型 (LPDDR4/LPDDR5等)
|
val memType: String, // 内存类型 (LPDDR4/LPDDR5/LPDDR5X等)
|
||||||
val channels: Int, // 内存通道数
|
val channels: Int, // 内存通道数 (1/2/4)
|
||||||
val zramTotal: Long, // zram 总大小 (字节)
|
val zramTotal: Long, // zram 总大小 (字节)
|
||||||
val zramUsed: Long // zram 已使用 (字节)
|
val zramUsed: Long // zram 已使用 (字节)
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 内存信息工具类
|
||||||
|
* 提供内存相关的详细信息，包括总内存、可用内存、内存类型、通道数、ZRAM等
|
||||||
|
*/
|
||||||
class MemInfo(private val context: Context){
|
class MemInfo(private val context: Context){
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取完整的内存信息
|
||||||
|
* @return MemoryInfo 包含所有内存相关信息的数据对象
|
||||||
|
*/
|
||||||
fun getMemoryInfo(): MemoryInfo {
|
fun getMemoryInfo(): MemoryInfo {
|
||||||
val totalRam = getTotalMemory()
|
val totalRam = getTotalMemory()
|
||||||
val availableRam = getAvailableMemory()
|
val availableRam = getAvailableMemory()
|
||||||
@ -34,6 +46,11 @@ class MemInfo(private val context: Context){
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取总内存大小
|
||||||
|
* 从 /proc/meminfo 读取 MemTotal 值
|
||||||
|
* @return 总内存字节数
|
||||||
|
*/
|
||||||
private fun getTotalMemory(): Long {
|
private fun getTotalMemory(): Long {
|
||||||
return try {
|
return try {
|
||||||
val memInfo = File("/proc/meminfo")
|
val memInfo = File("/proc/meminfo")
|
||||||
@ -45,6 +62,11 @@ class MemInfo(private val context: Context){
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取可用内存大小
|
||||||
|
* 从 /proc/meminfo 读取 MemAvailable 值
|
||||||
|
* @return 可用内存字节数
|
||||||
|
*/
|
||||||
private fun getAvailableMemory(): Long {
|
private fun getAvailableMemory(): Long {
|
||||||
return try {
|
return try {
|
||||||
val memInfo = File("/proc/meminfo")
|
val memInfo = File("/proc/meminfo")
|
||||||
@ -56,33 +78,255 @@ class MemInfo(private val context: Context){
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取内存类型（LPDDR4、LPDDR4X、LPDDR5、LPDDR5X等）
|
||||||
|
* 通过多种方式检测内存类型
|
||||||
|
*/
|
||||||
private fun getMemoryType(): String {
|
private fun getMemoryType(): String {
|
||||||
return try {
|
return try {
|
||||||
// 尝试从多个可能的位置读取
|
// 1. 尝试从系统属性获取
|
||||||
val paths = listOf(
|
val propResult = getMemoryTypeFromProps()
|
||||||
"/sys/class/devfreq/ddrfreq/device/type",
|
if (propResult != "Unknown") return propResult
|
||||||
"/sys/class/devfreq/soc:qcom,cpu-cpu-llcc-bw/device/type",
|
|
||||||
"/proc/device-tree/memory/device_type"
|
|
||||||
)
|
|
||||||
|
|
||||||
for (path in paths) {
|
// 2. 尝试从 sysfs 设备文件获取
|
||||||
val file = File(path)
|
val sysfsResult = getMemoryTypeFromSysfs()
|
||||||
if (file.exists()) {
|
if (sysfsResult != "Unknown") return sysfsResult
|
||||||
val content = file.readText().trim()
|
|
||||||
if (content.isNotEmpty()) {
|
|
||||||
return content
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 尝试从 getprop 获取
|
// 3. 尝试从设备树获取
|
||||||
Runtime.getRuntime().exec("getprop ro.boot.ddr_type").inputStream.bufferedReader().readText().trim()
|
val deviceTreeResult = getMemoryTypeFromDeviceTree()
|
||||||
.ifEmpty { "Unknown" }
|
if (deviceTreeResult != "Unknown") return deviceTreeResult
|
||||||
|
|
||||||
|
// 4. 尝试从内核日志获取
|
||||||
|
val dmesgResult = getMemoryTypeFromDmesg()
|
||||||
|
if (dmesgResult != "Unknown") return dmesgResult
|
||||||
|
|
||||||
|
// 5. 根据 Android 版本和设备信息推测
|
||||||
|
val estimatedType = estimateMemoryType()
|
||||||
|
if (estimatedType != "Unknown") return estimatedType
|
||||||
|
|
||||||
|
"Unknown"
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
"Unknown"
|
"Unknown"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从系统属性获取内存类型
|
||||||
|
*/
|
||||||
|
private fun getMemoryTypeFromProps(): String {
|
||||||
|
val propKeys = listOf(
|
||||||
|
"ro.boot.ddr_type",
|
||||||
|
"ro.boot.ddrtype",
|
||||||
|
"ro.boot.em.ddr_type",
|
||||||
|
"ro.vendor.boot.ddr_type",
|
||||||
|
"ro.product.vendor.boot.ddr_type",
|
||||||
|
"persist.vendor.ddr.type",
|
||||||
|
"vendor.boot.ddr.type"
|
||||||
|
)
|
||||||
|
|
||||||
|
for (key in propKeys) {
|
||||||
|
try {
|
||||||
|
val result = Runtime.getRuntime()
|
||||||
|
.exec(arrayOf("getprop", key))
|
||||||
|
.inputStream.bufferedReader().readText().trim()
|
||||||
|
|
||||||
|
if (result.isNotEmpty() && result != "Unknown") {
|
||||||
|
return parseMemoryType(result)
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return "Unknown"
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从 sysfs 文件系统获取内存类型
|
||||||
|
*/
|
||||||
|
private fun getMemoryTypeFromSysfs(): String {
|
||||||
|
val paths = listOf(
|
||||||
|
// Qualcomm 设备
|
||||||
|
"/sys/class/devfreq/soc:qcom,cpu-cpu-llcc-bw/device/type",
|
||||||
|
"/sys/class/devfreq/soc:qcom,cpu-llcc-ddr-bw/device/type",
|
||||||
|
"/sys/class/devfreq/ddrfreq/device/type",
|
||||||
|
"/sys/devices/platform/soc/soc:qcom,cpu-cpu-llcc-bw/devfreq/*/type",
|
||||||
|
"/sys/kernel/debug/clk/measure_only_mccc_clk/measure",
|
||||||
|
|
||||||
|
// MediaTek 设备
|
||||||
|
"/sys/kernel/debug/emi_mbw/dram_type",
|
||||||
|
"/sys/devices/platform/soc/10012000.dvfsrc/helio-dvfsrc/dvfsrc_dump",
|
||||||
|
|
||||||
|
// Samsung Exynos 设备
|
||||||
|
"/sys/class/devfreq/17000010.devfreq_mif/device/type",
|
||||||
|
"/sys/devices/platform/17000010.devfreq_mif/devfreq/devfreq0/type",
|
||||||
|
|
||||||
|
// 通用路径
|
||||||
|
"/proc/device-tree/memory/device_type",
|
||||||
|
"/sys/firmware/devicetree/base/memory/device_type"
|
||||||
|
)
|
||||||
|
|
||||||
|
for (path in paths) {
|
||||||
|
try {
|
||||||
|
val file = File(path)
|
||||||
|
if (file.exists() && file.canRead()) {
|
||||||
|
val content = file.readText().trim()
|
||||||
|
if (content.isNotEmpty()) {
|
||||||
|
val parsed = parseMemoryType(content)
|
||||||
|
if (parsed != "Unknown") return parsed
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return "Unknown"
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从设备树获取内存类型
|
||||||
|
*/
|
||||||
|
private fun getMemoryTypeFromDeviceTree(): String {
|
||||||
|
val dtPaths = listOf(
|
||||||
|
"/proc/device-tree/memory/ddr-type",
|
||||||
|
"/proc/device-tree/memory@*/ddr-type",
|
||||||
|
"/sys/firmware/devicetree/base/memory/ddr-type",
|
||||||
|
"/sys/firmware/devicetree/base/memory@*/ddr-type"
|
||||||
|
)
|
||||||
|
|
||||||
|
for (path in dtPaths) {
|
||||||
|
try {
|
||||||
|
if (path.contains("*")) {
|
||||||
|
// 处理通配符路径
|
||||||
|
val parent = File(path.substringBeforeLast("/"))
|
||||||
|
if (parent.exists()) {
|
||||||
|
parent.listFiles()?.forEach { file ->
|
||||||
|
if (file.name.startsWith("memory") && File(file, "ddr-type").exists()) {
|
||||||
|
val content = File(file, "ddr-type").readText().trim()
|
||||||
|
val parsed = parseMemoryType(content)
|
||||||
|
if (parsed != "Unknown") return parsed
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
val file = File(path)
|
||||||
|
if (file.exists()) {
|
||||||
|
val content = file.readText().trim()
|
||||||
|
val parsed = parseMemoryType(content)
|
||||||
|
if (parsed != "Unknown") return parsed
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return "Unknown"
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从内核日志获取内存类型
|
||||||
|
*/
|
||||||
|
private fun getMemoryTypeFromDmesg(): String {
|
||||||
|
try {
|
||||||
|
val dmesg = Runtime.getRuntime()
|
||||||
|
.exec(arrayOf("sh", "-c", "dmesg | grep -iE 'ddr|lpddr|memory.*type'"))
|
||||||
|
.inputStream.bufferedReader().readText()
|
||||||
|
|
||||||
|
return parseMemoryType(dmesg)
|
||||||
|
} catch (e: Exception) {
|
||||||
|
return "Unknown"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 解析内存类型字符串，提取标准化的内存类型
|
||||||
|
*/
|
||||||
|
private fun parseMemoryType(input: String): String {
|
||||||
|
val normalized = input.uppercase()
|
||||||
|
|
||||||
|
return when {
|
||||||
|
// LPDDR5X
|
||||||
|
normalized.contains("LPDDR5X") ||
|
||||||
|
normalized.contains("LPDDR5-X") ||
|
||||||
|
normalized.contains("LP5X") -> "LPDDR5X"
|
||||||
|
|
||||||
|
// LPDDR5
|
||||||
|
normalized.contains("LPDDR5") ||
|
||||||
|
normalized.contains("LP5") ||
|
||||||
|
normalized.contains("DDR5") && normalized.contains("LP") -> "LPDDR5"
|
||||||
|
|
||||||
|
// LPDDR4X
|
||||||
|
normalized.contains("LPDDR4X") ||
|
||||||
|
normalized.contains("LPDDR4-X") ||
|
||||||
|
normalized.contains("LP4X") -> "LPDDR4X"
|
||||||
|
|
||||||
|
// LPDDR4
|
||||||
|
normalized.contains("LPDDR4") ||
|
||||||
|
normalized.contains("LP4") ||
|
||||||
|
normalized.contains("DDR4") && normalized.contains("LP") -> "LPDDR4"
|
||||||
|
|
||||||
|
// LPDDR3
|
||||||
|
normalized.contains("LPDDR3") ||
|
||||||
|
normalized.contains("LP3") ||
|
||||||
|
normalized.contains("DDR3") && normalized.contains("LP") -> "LPDDR3"
|
||||||
|
|
||||||
|
// LPDDR2
|
||||||
|
normalized.contains("LPDDR2") ||
|
||||||
|
normalized.contains("LP2") -> "LPDDR2"
|
||||||
|
|
||||||
|
// DDR5 (非LP)
|
||||||
|
normalized.contains("DDR5") -> "DDR5"
|
||||||
|
|
||||||
|
// DDR4 (非LP)
|
||||||
|
normalized.contains("DDR4") -> "DDR4"
|
||||||
|
|
||||||
|
// DDR3 (非LP)
|
||||||
|
normalized.contains("DDR3") -> "DDR3"
|
||||||
|
|
||||||
|
else -> "Unknown"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据 Android SDK 版本和发布年份估算内存类型
|
||||||
|
*/
|
||||||
|
private fun estimateMemoryType(): String {
|
||||||
|
return try {
|
||||||
|
val sdkInt = android.os.Build.VERSION.SDK_INT
|
||||||
|
val year = android.os.Build.TIME / 1000 / 60 / 60 / 24 / 365 + 1970
|
||||||
|
|
||||||
|
// 根据 SDK 版本和年份推测
|
||||||
|
when {
|
||||||
|
// Android 14+ (2023年后)，旗舰设备可能使用 LPDDR5X
|
||||||
|
sdkInt >= 34 && year >= 2023 -> "LPDDR5X (estimated)"
|
||||||
|
|
||||||
|
// Android 13 (2022-2023)，高端设备使用 LPDDR5
|
||||||
|
sdkInt >= 33 && year >= 2022 -> "LPDDR5 (estimated)"
|
||||||
|
|
||||||
|
// Android 12 (2021-2022)，开始出现 LPDDR5
|
||||||
|
sdkInt >= 31 && year >= 2021 -> "LPDDR5 (estimated)"
|
||||||
|
|
||||||
|
// Android 11 (2020-2021)，主流使用 LPDDR4X
|
||||||
|
sdkInt >= 30 && year >= 2020 -> "LPDDR4X (estimated)"
|
||||||
|
|
||||||
|
// Android 10 (2019-2020)，使用 LPDDR4X
|
||||||
|
sdkInt >= 29 && year >= 2019 -> "LPDDR4X (estimated)"
|
||||||
|
|
||||||
|
// 更早期的设备，使用 LPDDR4 或 LPDDR3
|
||||||
|
sdkInt >= 28 -> "LPDDR4 (estimated)"
|
||||||
|
|
||||||
|
else -> "LPDDR3 (estimated)"
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
"Unknown"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取内存通道数
|
||||||
|
* 通道数影响内存带宽，常见的有单通道、双通道、四通道
|
||||||
|
*
|
||||||
|
* @return 内存通道数 (1/2/4)，默认返回 2（双通道）
|
||||||
|
*/
|
||||||
private fun getMemoryChannels(): Int {
|
private fun getMemoryChannels(): Int {
|
||||||
return try {
|
return try {
|
||||||
// 尝试从设备树或内核日志获取
|
// 尝试从设备树或内核日志获取
|
||||||
@ -102,12 +346,18 @@ class MemInfo(private val context: Context){
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取 ZRAM（压缩内存）信息
|
||||||
|
* ZRAM 是一种压缩内存技术，可以在内存不足时提供额外的"虚拟内存"
|
||||||
|
*
|
||||||
|
* @return Pair<总大小, 已使用大小> (字节)
|
||||||
|
*/
|
||||||
private fun getZramInfo(): Pair<Long, Long> {
|
private fun getZramInfo(): Pair<Long, Long> {
|
||||||
return try {
|
return try {
|
||||||
var total = 0L
|
var total = 0L
|
||||||
var used = 0L
|
var used = 0L
|
||||||
|
|
||||||
// 检查所有 zram 设备
|
// 检查所有 zram 设备 (通常是 zram0 到 zram7)
|
||||||
for (i in 0..7) {
|
for (i in 0..7) {
|
||||||
val devicePath = "/sys/block/zram$i"
|
val devicePath = "/sys/block/zram$i"
|
||||||
if (!File(devicePath).exists()) continue
|
if (!File(devicePath).exists()) continue
|
||||||
@ -129,13 +379,18 @@ class MemInfo(private val context: Context){
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 格式化内存大小
|
/**
|
||||||
|
* 格式化字节数为人类可读的格式
|
||||||
|
*
|
||||||
|
* @param bytes 字节数
|
||||||
|
* @return 格式化后的字符串 (如 "4.00 GB", "512.00 MB")
|
||||||
|
*/
|
||||||
fun formatBytes(bytes: Long): String {
|
fun formatBytes(bytes: Long): String {
|
||||||
return when {
|
return when {
|
||||||
bytes < 1024 -> "$bytes B"
|
bytes < 1024 -> "$bytes B"
|
||||||
bytes < 1024 * 1024 -> String.format("%.2f KB", bytes / 1024.0)
|
bytes < 1024 * 1024 -> String.format(java.util.Locale.US, "%.2f KB", bytes / 1024.0)
|
||||||
bytes < 1024 * 1024 * 1024 -> String.format("%.2f MB", bytes / (1024.0 * 1024))
|
bytes < 1024 * 1024 * 1024 -> String.format(java.util.Locale.US, "%.2f MB", bytes / (1024.0 * 1024))
|
||||||
else -> String.format("%.2f GB", bytes / (1024.0 * 1024 * 1024))
|
else -> String.format(java.util.Locale.US, "%.2f GB", bytes / (1024.0 * 1024 * 1024))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -0,0 +1,108 @@
|
|||||||
|
package com.xyzshell.andinfo.models
|
||||||
|
|
||||||
|
import com.google.gson.annotations.SerializedName
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备信息上传请求数据模型
|
||||||
|
*/
|
||||||
|
data class DeviceInfoRequest(
|
||||||
|
@SerializedName("cpuInfo")
|
||||||
|
val cpuInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("gpuInfo")
|
||||||
|
val gpuInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("screenInfo")
|
||||||
|
val screenInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("memoryInfo")
|
||||||
|
val memoryInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("diskInfo")
|
||||||
|
val diskInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("networkInfo")
|
||||||
|
val networkInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("batteryInfo")
|
||||||
|
val batteryInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("deviceInfo")
|
||||||
|
val deviceInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("appInfo")
|
||||||
|
val appInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("systemInfo")
|
||||||
|
val systemInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("locationInfo")
|
||||||
|
val locationInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("cameraInfo")
|
||||||
|
val cameraInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("sensorInfo")
|
||||||
|
val sensorInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("propsInfo")
|
||||||
|
val propsInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("bluetoothInfo")
|
||||||
|
val bluetoothInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("wifiInfo")
|
||||||
|
val wifiInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("nfcInfo")
|
||||||
|
val nfcInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("usbInfo")
|
||||||
|
val usbInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("buildInfo")
|
||||||
|
val buildInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("deviceId")
|
||||||
|
val deviceId: String,
|
||||||
|
|
||||||
|
@SerializedName("deviceName")
|
||||||
|
val deviceName: String,
|
||||||
|
|
||||||
|
@SerializedName("drmInfo")
|
||||||
|
val drmInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("inputInfo")
|
||||||
|
val inputInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("gaid")
|
||||||
|
val gaid: String
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 加密请求数据模型
|
||||||
|
*/
|
||||||
|
data class EncryptedRequest(
|
||||||
|
@SerializedName("encrypted")
|
||||||
|
val encrypted: String
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* API 响应数据模型
|
||||||
|
*/
|
||||||
|
data class ApiResponse(
|
||||||
|
@SerializedName("data")
|
||||||
|
val data: Any?,
|
||||||
|
|
||||||
|
@SerializedName("message")
|
||||||
|
val message: String,
|
||||||
|
|
||||||
|
@SerializedName("status")
|
||||||
|
val status: String // "Success" 或 "Fail"
|
||||||
|
) {
|
||||||
|
/**
|
||||||
|
* 判断请求是否成功
|
||||||
|
*/
|
||||||
|
fun isSuccess(): Boolean = status == "Success"
|
||||||
|
}
|
||||||
|
|
||||||
@ -9,13 +9,39 @@ import java.io.IOException
|
|||||||
import javax.crypto.Cipher
|
import javax.crypto.Cipher
|
||||||
import javax.crypto.spec.SecretKeySpec
|
import javax.crypto.spec.SecretKeySpec
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备信息上传 API 地址
|
||||||
|
*/
|
||||||
|
const val upload_info_api = "https://api.xyzshell.com/api/mobile/checker/save"
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Web 服务工具类
|
||||||
|
* 提供 HTTP 请求、JSON 序列化和 AES 加密功能
|
||||||
|
*/
|
||||||
class WebService {
|
class WebService {
|
||||||
|
/**
|
||||||
|
* OkHttp 客户端实例
|
||||||
|
*/
|
||||||
private val client = OkHttpClient()
|
private val client = OkHttpClient()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gson 序列化工具
|
||||||
|
*/
|
||||||
val gson = Gson()
|
val gson = Gson()
|
||||||
// AES 密钥 (必须是 16/24/32 字节)
|
|
||||||
|
/**
|
||||||
|
* AES 加密密钥（必须是 16/24/32 字节）
|
||||||
|
*/
|
||||||
private val aesKey = "e67cbcee5e573d1b"
|
private val aesKey = "e67cbcee5e573d1b"
|
||||||
|
|
||||||
// AES 加密
|
/**
|
||||||
|
* AES 加密方法
|
||||||
|
* 使用 AES/ECB 模式加密字符串
|
||||||
|
*
|
||||||
|
* @param plainText 明文字符串
|
||||||
|
* @return Base64 编码的加密字符串
|
||||||
|
* @throws Exception 加密失败时抛出异常
|
||||||
|
*/
|
||||||
fun encrypt(plainText: String): String {
|
fun encrypt(plainText: String): String {
|
||||||
return try {
|
return try {
|
||||||
val secretKey = SecretKeySpec(aesKey.toByteArray(), "AES")
|
val secretKey = SecretKeySpec(aesKey.toByteArray(), "AES")
|
||||||
@ -27,6 +53,14 @@ class WebService {
|
|||||||
throw Exception("加密失败: ${e.message}")
|
throw Exception("加密失败: ${e.message}")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 异步 POST 请求
|
||||||
|
*
|
||||||
|
* @param url 请求地址
|
||||||
|
* @param jsonData JSON 格式的请求数据
|
||||||
|
* @param callback 回调函数 (响应字符串, 错误异常)
|
||||||
|
*/
|
||||||
fun postData(url: String, jsonData: String, callback: (String?, Exception?) -> Unit) {
|
fun postData(url: String, jsonData: String, callback: (String?, Exception?) -> Unit) {
|
||||||
val mediaType = "application/json; charset=utf-8".toMediaType()
|
val mediaType = "application/json; charset=utf-8".toMediaType()
|
||||||
val body = jsonData.toRequestBody(mediaType)
|
val body = jsonData.toRequestBody(mediaType)
|
||||||
@ -53,7 +87,13 @@ class WebService {
|
|||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
// 同步版本
|
/**
|
||||||
|
* 同步 POST 请求（阻塞当前线程）
|
||||||
|
*
|
||||||
|
* @param url 请求地址
|
||||||
|
* @param jsonData JSON 格式的请求数据
|
||||||
|
* @return 响应字符串，失败时返回 null
|
||||||
|
*/
|
||||||
fun postDataSync(url: String, jsonData: String): String? {
|
fun postDataSync(url: String, jsonData: String): String? {
|
||||||
val mediaType = "application/json; charset=utf-8".toMediaType()
|
val mediaType = "application/json; charset=utf-8".toMediaType()
|
||||||
val body = jsonData.toRequestBody(mediaType)
|
val body = jsonData.toRequestBody(mediaType)
|
||||||
@ -72,12 +112,22 @@ class WebService {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 序列化对象为 JSON
|
/**
|
||||||
|
* 序列化对象为 JSON 字符串
|
||||||
|
*
|
||||||
|
* @param obj 要序列化的对象
|
||||||
|
* @return JSON 字符串
|
||||||
|
*/
|
||||||
fun <T> toJson(obj: T): String {
|
fun <T> toJson(obj: T): String {
|
||||||
return gson.toJson(obj)
|
return gson.toJson(obj)
|
||||||
}
|
}
|
||||||
|
|
||||||
// 反序列化 JSON 为对象
|
/**
|
||||||
|
* 反序列化 JSON 字符串为对象
|
||||||
|
*
|
||||||
|
* @param json JSON 字符串
|
||||||
|
* @return 反序列化的对象，失败时返回 null
|
||||||
|
*/
|
||||||
inline fun <reified T> fromJson(json: String): T? {
|
inline fun <reified T> fromJson(json: String): T? {
|
||||||
return try {
|
return try {
|
||||||
gson.fromJson(json, T::class.java)
|
gson.fromJson(json, T::class.java)
|
||||||
@ -86,12 +136,27 @@ class WebService {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 带序列化的 POST 请求
|
/**
|
||||||
|
* 带序列化的 POST 请求
|
||||||
|
* 自动将对象序列化为 JSON 后发送
|
||||||
|
*
|
||||||
|
* @param url 请求地址
|
||||||
|
* @param obj 要发送的对象
|
||||||
|
* @param callback 回调函数 (响应字符串, 错误异常)
|
||||||
|
*/
|
||||||
fun <T> postObject(url: String, obj: T, callback: (String?, Exception?) -> Unit) {
|
fun <T> postObject(url: String, obj: T, callback: (String?, Exception?) -> Unit) {
|
||||||
val jsonData = toJson(obj)
|
val jsonData = toJson(obj)
|
||||||
postData(url, jsonData, callback)
|
postData(url, jsonData, callback)
|
||||||
}
|
}
|
||||||
// 带序列化和反序列化的 POST 请求
|
|
||||||
|
/**
|
||||||
|
* 带序列化和反序列化的 POST 请求
|
||||||
|
* 自动将请求对象序列化为 JSON，并将响应反序列化为对象
|
||||||
|
*
|
||||||
|
* @param url 请求地址
|
||||||
|
* @param obj 要发送的对象
|
||||||
|
* @param callback 回调函数 (响应对象, 错误异常)
|
||||||
|
*/
|
||||||
inline fun <reified T, reified R> postAndParse(
|
inline fun <reified T, reified R> postAndParse(
|
||||||
url: String,
|
url: String,
|
||||||
obj: T,
|
obj: T,
|
||||||
|
|||||||
528
设备信息收集和上传使用指南.md
Normal file
528
设备信息收集和上传使用指南.md
Normal file
@ -0,0 +1,528 @@
|
|||||||
|
# 设备信息收集和上传使用指南
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
本功能提供了完整的设备信息收集、序列化、加密和上传功能。所有信息收集都是异步并发执行，性能优化且不会阻塞主线程。
|
||||||
|
|
||||||
|
## 功能特性
|
||||||
|
|
||||||
|
### 1. 信息收集模块
|
||||||
|
自动收集以下 24 类设备信息：
|
||||||
|
- CPU 信息
|
||||||
|
- GPU 信息
|
||||||
|
- 屏幕信息
|
||||||
|
- 内存信息
|
||||||
|
- 磁盘信息
|
||||||
|
- 网络信息
|
||||||
|
- 电池信息
|
||||||
|
- 设备信息
|
||||||
|
- 应用信息
|
||||||
|
- 系统信息
|
||||||
|
- 定位信息
|
||||||
|
- 相机信息
|
||||||
|
- 传感器信息
|
||||||
|
- 系统属性
|
||||||
|
- 蓝牙信息
|
||||||
|
- WiFi 信息
|
||||||
|
- NFC 信息
|
||||||
|
- USB 信息
|
||||||
|
- 构建信息
|
||||||
|
- DRM 信息
|
||||||
|
- 输入设备信息
|
||||||
|
- Device ID
|
||||||
|
- GAID
|
||||||
|
|
||||||
|
### 2. 数据处理流程
|
||||||
|
1. **异步收集** - 并发收集所有信息，提高性能
|
||||||
|
2. **JSON 序列化** - 将所有信息转换为 JSON 格式
|
||||||
|
3. **AES 加密** - 使用 AES 加密保护数据
|
||||||
|
4. **HTTP POST** - 发送加密数据到服务器
|
||||||
|
5. **响应处理** - 解析服务器响应
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 基本使用
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
import androidx.lifecycle.lifecycleScope
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
import com.xyzshell.andinfo.collector.DeviceInfoCollector
|
||||||
|
import kotlinx.coroutines.launch
|
||||||
|
|
||||||
|
class MainActivity : AppCompatActivity() {
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
|
||||||
|
// 初始化 AndInfo
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 收集并上传设备信息
|
||||||
|
uploadDeviceInfo()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun uploadDeviceInfo() {
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
if (error != null) {
|
||||||
|
// 上传失败
|
||||||
|
runOnUiThread {
|
||||||
|
Toast.makeText(
|
||||||
|
this@MainActivity,
|
||||||
|
"上传失败: ${error.message}",
|
||||||
|
Toast.LENGTH_LONG
|
||||||
|
).show()
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// 上传成功
|
||||||
|
runOnUiThread {
|
||||||
|
Toast.makeText(
|
||||||
|
this@MainActivity,
|
||||||
|
"上传成功: $message",
|
||||||
|
Toast.LENGTH_SHORT
|
||||||
|
).show()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 仅收集信息（不上传）
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
// 仅收集信息，不上传
|
||||||
|
val deviceInfo = collector.collectAllInfo()
|
||||||
|
|
||||||
|
// 转换为 JSON 查看
|
||||||
|
val json = collector.gson.toJson(deviceInfo)
|
||||||
|
println("设备信息: $json")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 在 ViewModel 中使用
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class DeviceInfoViewModel : ViewModel() {
|
||||||
|
private val _uploadStatus = MutableLiveData<UploadStatus>()
|
||||||
|
val uploadStatus: LiveData<UploadStatus> = _uploadStatus
|
||||||
|
|
||||||
|
fun uploadDeviceInfo(context: Context) {
|
||||||
|
viewModelScope.launch {
|
||||||
|
_uploadStatus.value = UploadStatus.Loading
|
||||||
|
|
||||||
|
val collector = DeviceInfoCollector(context)
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
if (error != null) {
|
||||||
|
_uploadStatus.postValue(UploadStatus.Error(error.message ?: "上传失败"))
|
||||||
|
} else {
|
||||||
|
_uploadStatus.postValue(UploadStatus.Success(message ?: "上传成功"))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
sealed class UploadStatus {
|
||||||
|
object Loading : UploadStatus()
|
||||||
|
data class Success(val message: String) : UploadStatus()
|
||||||
|
data class Error(val message: String) : UploadStatus()
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 带进度显示的上传
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class UploadActivity : AppCompatActivity() {
|
||||||
|
private lateinit var progressDialog: ProgressDialog
|
||||||
|
|
||||||
|
private fun uploadWithProgress() {
|
||||||
|
// 显示进度对话框
|
||||||
|
progressDialog = ProgressDialog(this).apply {
|
||||||
|
setMessage("正在收集设备信息...")
|
||||||
|
setCancelable(false)
|
||||||
|
show()
|
||||||
|
}
|
||||||
|
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
// 更新进度
|
||||||
|
progressDialog.setMessage("正在上传...")
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
runOnUiThread {
|
||||||
|
progressDialog.dismiss()
|
||||||
|
|
||||||
|
if (error != null) {
|
||||||
|
AlertDialog.Builder(this@UploadActivity)
|
||||||
|
.setTitle("上传失败")
|
||||||
|
.setMessage(error.message)
|
||||||
|
.setPositiveButton("确定", null)
|
||||||
|
.show()
|
||||||
|
} else {
|
||||||
|
AlertDialog.Builder(this@UploadActivity)
|
||||||
|
.setTitle("上传成功")
|
||||||
|
.setMessage(message)
|
||||||
|
.setPositiveButton("确定", null)
|
||||||
|
.show()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 定时自动上传
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class AutoUploadService : Service() {
|
||||||
|
private val uploadInterval = 24 * 60 * 60 * 1000L // 24小时
|
||||||
|
private val handler = Handler(Looper.getMainLooper())
|
||||||
|
|
||||||
|
private val uploadRunnable = object : Runnable {
|
||||||
|
override fun run() {
|
||||||
|
uploadDeviceInfo()
|
||||||
|
handler.postDelayed(this, uploadInterval)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
|
||||||
|
handler.post(uploadRunnable)
|
||||||
|
return START_STICKY
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun uploadDeviceInfo() {
|
||||||
|
CoroutineScope(Dispatchers.IO).launch {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
if (error != null) {
|
||||||
|
Log.e("AutoUpload", "上传失败: ${error.message}")
|
||||||
|
} else {
|
||||||
|
Log.i("AutoUpload", "上传成功: $message")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun onDestroy() {
|
||||||
|
handler.removeCallbacks(uploadRunnable)
|
||||||
|
super.onDestroy()
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun onBind(intent: Intent?): IBinder? = null
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## API 接口说明
|
||||||
|
|
||||||
|
### 请求格式
|
||||||
|
|
||||||
|
**URL**: `https://api.xyzshell.com/api/mobile/checker/save`
|
||||||
|
|
||||||
|
**Method**: POST
|
||||||
|
|
||||||
|
**Content-Type**: application/json
|
||||||
|
|
||||||
|
**请求体**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"encrypted": "AES加密后的Base64字符串"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**加密前的数据格式**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"cpuInfo": "{\"processorName\":\"ARM\",\"cores\":8}",
|
||||||
|
"gpuInfo": "{\"vendor\":\"Qualcomm\",\"renderer\":\"Adreno 650\"}",
|
||||||
|
"screenInfo": "{\"width\":1080,\"height\":2400}",
|
||||||
|
"memoryInfo": "{\"totalMem\":8589934592}",
|
||||||
|
"diskInfo": "{\"totalSpace\":128000000000}",
|
||||||
|
"networkInfo": "{}",
|
||||||
|
"batteryInfo": "{\"level\":85,\"status\":3}",
|
||||||
|
"deviceInfo": "{\"brand\":\"Samsung\",\"model\":\"SM-G998B\"}",
|
||||||
|
"appInfo": "{}",
|
||||||
|
"systemInfo": "{\"androidVersion\":\"13\",\"sdkInt\":33}",
|
||||||
|
"locationInfo": "{\"gpsSupported\":true}",
|
||||||
|
"cameraInfo": "{\"cameraCount\":4}",
|
||||||
|
"sensorInfo": "{\"sensorCount\":20}",
|
||||||
|
"propsInfo": "{}",
|
||||||
|
"bluetoothInfo": "{\"supported\":true,\"enabled\":true}",
|
||||||
|
"wifiInfo": "{}",
|
||||||
|
"nfcInfo": "{\"supported\":true}",
|
||||||
|
"usbInfo": "{\"hostSupported\":true}",
|
||||||
|
"buildInfo": "{\"trebleEnabled\":true}",
|
||||||
|
"deviceId": "9774d56d682e549c",
|
||||||
|
"deviceName": "Samsung SM-G998B",
|
||||||
|
"drmInfo": "{\"supportedSchemes\":2}",
|
||||||
|
"inputInfo": "{\"deviceCount\":3}",
|
||||||
|
"gaid": "38400000-8cf0-11bd-b23e-10b96e40000d"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 响应格式
|
||||||
|
|
||||||
|
**成功响应**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": null,
|
||||||
|
"message": "设备信息保存成功",
|
||||||
|
"status": "Success"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**失败响应**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": null,
|
||||||
|
"message": "错误详情信息",
|
||||||
|
"status": "Fail"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 数据模型
|
||||||
|
|
||||||
|
### DeviceInfoRequest
|
||||||
|
```kotlin
|
||||||
|
data class DeviceInfoRequest(
|
||||||
|
val cpuInfo: String, // CPU信息JSON
|
||||||
|
val gpuInfo: String, // GPU信息JSON
|
||||||
|
val screenInfo: String, // 屏幕信息JSON
|
||||||
|
val memoryInfo: String, // 内存信息JSON
|
||||||
|
val diskInfo: String, // 磁盘信息JSON
|
||||||
|
val networkInfo: String, // 网络信息JSON
|
||||||
|
val batteryInfo: String, // 电池信息JSON
|
||||||
|
val deviceInfo: String, // 设备信息JSON
|
||||||
|
val appInfo: String, // 应用信息JSON
|
||||||
|
val systemInfo: String, // 系统信息JSON
|
||||||
|
val locationInfo: String, // 定位信息JSON
|
||||||
|
val cameraInfo: String, // 相机信息JSON
|
||||||
|
val sensorInfo: String, // 传感器信息JSON
|
||||||
|
val propsInfo: String, // 系统属性JSON
|
||||||
|
val bluetoothInfo: String, // 蓝牙信息JSON
|
||||||
|
val wifiInfo: String, // WiFi信息JSON
|
||||||
|
val nfcInfo: String, // NFC信息JSON
|
||||||
|
val usbInfo: String, // USB信息JSON
|
||||||
|
val buildInfo: String, // 构建信息JSON
|
||||||
|
val deviceId: String, // 设备ID
|
||||||
|
val deviceName: String, // 设备名称
|
||||||
|
val drmInfo: String, // DRM信息JSON
|
||||||
|
val inputInfo: String, // 输入信息JSON
|
||||||
|
val gaid: String // Google广告ID
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### EncryptedRequest
|
||||||
|
```kotlin
|
||||||
|
data class EncryptedRequest(
|
||||||
|
val encrypted: String // AES加密后的Base64字符串
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### ApiResponse
|
||||||
|
```kotlin
|
||||||
|
data class ApiResponse(
|
||||||
|
val data: Any?, // 响应数据
|
||||||
|
val message: String, // 响应消息
|
||||||
|
val status: String // 状态: "Success" 或 "Fail"
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 加密说明
|
||||||
|
|
||||||
|
### AES 加密
|
||||||
|
- **算法**: AES/ECB/PKCS5Padding
|
||||||
|
- **密钥**: "e67cbcee5e573d1b" (16字节)
|
||||||
|
- **编码**: Base64 (NO_WRAP)
|
||||||
|
|
||||||
|
### 加密示例
|
||||||
|
```kotlin
|
||||||
|
val webService = WebService()
|
||||||
|
val plainText = """{"test": "data"}"""
|
||||||
|
val encrypted = webService.encrypt(plainText)
|
||||||
|
println("加密结果: $encrypted")
|
||||||
|
```
|
||||||
|
|
||||||
|
## 权限要求
|
||||||
|
|
||||||
|
根据收集的信息类型，可能需要以下权限：
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<!-- 必需权限 -->
|
||||||
|
<uses-permission android:name="android.permission.INTERNET" />
|
||||||
|
|
||||||
|
<!-- 可选权限（用于获取更多信息） -->
|
||||||
|
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
|
||||||
|
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
|
||||||
|
<uses-permission android:name="android.permission.BLUETOOTH" />
|
||||||
|
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
|
||||||
|
<uses-permission android:name="android.permission.CAMERA" />
|
||||||
|
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
|
||||||
|
```
|
||||||
|
|
||||||
|
## 性能优化
|
||||||
|
|
||||||
|
### 1. 并发收集
|
||||||
|
所有信息收集都是并发执行：
|
||||||
|
```kotlin
|
||||||
|
// 使用协程并发收集
|
||||||
|
val cpuInfoDeferred = async { collectCpuInfo() }
|
||||||
|
val gpuInfoDeferred = async { collectGpuInfo() }
|
||||||
|
// ... 其他信息并发收集
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 异常处理
|
||||||
|
每个收集方法都有完善的异常处理：
|
||||||
|
```kotlin
|
||||||
|
private suspend fun collectCpuInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
// 收集逻辑
|
||||||
|
} catch (e: Exception) {
|
||||||
|
"{}" // 返回空JSON对象
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 线程调度
|
||||||
|
- 信息收集：使用 `Dispatchers.Default` 或 `Dispatchers.IO`
|
||||||
|
- 加密操作：使用 `Dispatchers.Default`
|
||||||
|
- 网络请求：使用 `Dispatchers.IO`
|
||||||
|
|
||||||
|
## 错误处理
|
||||||
|
|
||||||
|
### 常见错误及解决方案
|
||||||
|
|
||||||
|
1. **网络错误**
|
||||||
|
```kotlin
|
||||||
|
// 错误: java.net.UnknownHostException
|
||||||
|
// 解决: 检查网络连接和URL是否正确
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **加密错误**
|
||||||
|
```kotlin
|
||||||
|
// 错误: 加密失败
|
||||||
|
// 解决: 检查密钥长度是否为16/24/32字节
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **序列化错误**
|
||||||
|
```kotlin
|
||||||
|
// 错误: JSON解析失败
|
||||||
|
// 解决: 确保所有收集方法返回有效的JSON字符串
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **隐私合规**：
|
||||||
|
- 确保用户知情并同意收集设备信息
|
||||||
|
- 遵守 GDPR、CCPA 等隐私法规
|
||||||
|
- 在隐私政策中说明数据用途
|
||||||
|
|
||||||
|
2. **网络使用**：
|
||||||
|
- 建议在 WiFi 环境下上传
|
||||||
|
- 可以添加网络类型检测
|
||||||
|
|
||||||
|
3. **频率控制**：
|
||||||
|
- 不要频繁上传
|
||||||
|
- 建议每天或每周上传一次
|
||||||
|
|
||||||
|
4. **错误重试**：
|
||||||
|
- 失败时可以实现重试机制
|
||||||
|
- 保存失败的数据，下次再试
|
||||||
|
|
||||||
|
## 完整示例
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class DeviceCheckActivity : AppCompatActivity() {
|
||||||
|
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
setContentView(R.layout.activity_device_check)
|
||||||
|
|
||||||
|
// 初始化
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 检查权限后上传
|
||||||
|
if (checkPermissions()) {
|
||||||
|
uploadDeviceInfo()
|
||||||
|
} else {
|
||||||
|
requestPermissions()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun uploadDeviceInfo() {
|
||||||
|
lifecycleScope.launch {
|
||||||
|
try {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
// 显示加载对话框
|
||||||
|
val dialog = ProgressDialog(this@DeviceCheckActivity)
|
||||||
|
dialog.setMessage("正在收集设备信息...")
|
||||||
|
dialog.show()
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
runOnUiThread {
|
||||||
|
dialog.dismiss()
|
||||||
|
|
||||||
|
if (error != null) {
|
||||||
|
showErrorDialog(error.message ?: "上传失败")
|
||||||
|
} else {
|
||||||
|
showSuccessDialog(message ?: "上传成功")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
runOnUiThread {
|
||||||
|
showErrorDialog("发生错误: ${e.message}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun showSuccessDialog(message: String) {
|
||||||
|
AlertDialog.Builder(this)
|
||||||
|
.setTitle("成功")
|
||||||
|
.setMessage(message)
|
||||||
|
.setPositiveButton("确定", null)
|
||||||
|
.show()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun showErrorDialog(message: String) {
|
||||||
|
AlertDialog.Builder(this)
|
||||||
|
.setTitle("失败")
|
||||||
|
.setMessage(message)
|
||||||
|
.setPositiveButton("确定", null)
|
||||||
|
.setNegativeButton("重试") { _, _ ->
|
||||||
|
uploadDeviceInfo()
|
||||||
|
}
|
||||||
|
.show()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun checkPermissions(): Boolean {
|
||||||
|
// 检查必要权限
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun requestPermissions() {
|
||||||
|
// 请求权限
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 总结
|
||||||
|
|
||||||
|
本功能提供了完整的设备信息收集和上传解决方案：
|
||||||
|
- ✅ 异步并发收集，性能优化
|
||||||
|
- ✅ 完整的24类设备信息
|
||||||
|
- ✅ AES 加密保护数据
|
||||||
|
- ✅ 完善的错误处理
|
||||||
|
- ✅ 简单易用的 API
|
||||||
|
- ✅ 详细的中文注释
|
||||||
|
|
||||||
Loading…
Reference in New Issue
Block a user