更新记录

1.0.0（2026-11-05） 下载此版本

1.0.0

  • 首个版本，功能可用

平台兼容性

pk-device 设备信息套件

设备信息聚合：ROM/系统皮肤识别、电量归类、网络质量标签、本地存储用量、屏幕描述，一份完整设备档案。纯 JS，零原生依赖。

为什么做它

uni.getSystemInfoSync 返回 40+ 个零散字段，ROM 识别（MIUI/HarmonyOS/ColorOS…）每个项目都要重写，电量在非 H5 端没有系统 API 却常被竞品「假装支持」。pk-device 把这些归一化成一份带置信度的设备档案，能力探测如实上报（测不到就返回 supported:false，不造假）。

快速上手

import device from '@/uni_modules/pk-device/js_sdk/index.js';

const d = await device.describe();
// 「Xiaomi Redmi K60 · android 14 · MIUI · Wi-Fi · 电量86%」

全部方法

方法 说明 返回
init() / info() 初始化并取系统信息（幂等缓存） systemInfo 对象
profile() 完整设备档案（os/硬件/屏幕/运行时/网络/电量/存储） Promise\<profile>
rom() ROM/皮肤识别 + 置信度 { rom, confidence }
network() 网络类型 + 质量标签 + 计费标记 { type, quality, metered, label }
onNetworkChange(fn) 网络变化订阅，返回退订函数 off 函数
battery() 电量（H5 走 Battery API；其他端如实 supported:false） { supported, state, level }
storage() 本地存储用量 { used, limit, percent, label, keys }
screen() 屏幕描述 { width, height, dpr, physical, text }
describe() 一句话人类可读摘要 string

ROM 识别规则（含置信度）

ROM 命中方式 置信度
harmonyos osName/版本明示 high
hyperos os 明示 HyperOS high
miui OS 明示 high；小米系品牌兜底 low high/low
emui 华为/荣耀 high/low
coloros OPPO/realme/一加 high/low
funtouch vivo/iQOO high/low
oneui / flyme 三星 / 魅族 high/low

电量五态

ok（>20）→ low（≤15 未充电）→ critical（≤5 未充电）→ charging / charging-low → unknown

示例工程

example/ 为完整可跑工程。在线文档：https://plugins.cnajiu.cn/public/pk-device.html

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

插件不采集任何数据

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。