HarmonyOS 5开发从入门到精通(十一):设备能力调用
设备能力调用让应用能访问手机的硬件功能,比如获取设备信息、使用传感器、定位位置等。本章介绍如何调用这些设备能力。
一、获取设备信息
1.1 获取基本设备信息
import deviceInfo from '@ohos.deviceInfo';// 获取设备型号
let model = deviceInfo.model;
// 获取厂商
let manufacturer = deviceInfo.manufacturer;
// 获取品牌
let brand = deviceInfo.brand;
// 获取系统语言
let language = deviceInfo.language;
1.2 获取屏幕信息
import display from '@ohos.display';// 获取默认屏幕
let defaultDisplay = await display.getDefaultDisplay();
// 屏幕宽度
let width = defaultDisplay.width;
// 屏幕高度
let height = defaultDisplay.height;
// 屏幕密度
let density = defaultDisplay.densityDPI;
二、传感器使用
2.1 加速度传感器
import sensor from '@ohos.sensor';// 监听加速度变化
sensor.on(sensor.SensorId.ACCELEROMETER, (data) => {console.log(`X: ${data.x}, Y: ${data.y}, Z: ${data.z}`);
});
2.2 光线传感器
// 监听光线强度
sensor.on(sensor.SensorId.LIGHT, (data) => {console.log(`光线强度: ${data.intensity} lux`);
});
2.3 距离传感器
// 监听距离变化
sensor.on(sensor.SensorId.PROXIMITY, (data) => {console.log(`距离: ${data.distance} cm`);
});
三、电池管理
3.1 获取电池状态
import batteryInfo from '@ohos.batteryInfo';// 获取电池电量
let batteryLevel = batteryInfo.batteryLevel;
// 充电状态
let chargingStatus = batteryInfo.chargingStatus;
// 电池健康状态
let healthStatus = batteryInfo.healthStatus;
3.2 监听电池变化
// 监听电量变化
batteryInfo.on('batteryLevel', (level) => {console.log(`电量变化: ${level}%`);
});// 监听充电状态变化
batteryInfo.on('chargingStatus', (status) => {console.log(`充电状态: ${status}`);
});
四、网络状态
4.1 获取网络信息
import connection from '@ohos.net.connection';// 获取网络类型
let netHandle = await connection.getDefaultNet();
let type = netHandle.type; // wifi, cellular等// 检查网络是否可用
let isAvailable = netHandle.isAvailable;
4.2 监听网络变化
// 监听网络连接变化
connection.on('netAvailable', () => {console.log('网络已连接');
});connection.on('netLost', () => {console.log('网络已断开');
});
五、振动反馈
5.1 触发振动
import vibrator from '@ohos.vibrator';// 单次振动
vibrator.vibrate(100); // 振动100ms// 模式振动
vibrator.vibrate([100, 200, 100, 200]); // 间隔振动
六、设备方向
6.1 监听屏幕方向
import window from '@ohos.window';// 获取当前方向
let orientation = window.getLastWindow(getContext()).orientation;// 监听方向变化
window.getLastWindow(getContext()).on('orientationChange', (newOrientation) => {console.log(`方向变为: ${newOrientation}`);
});
七、存储空间
7.1 获取存储信息
import fileio from '@ohos.fileio';// 获取可用存储空间
let stats = await fileio.statfs('/data');
let freeSpace = stats.f_bavail * stats.f_bsize;
let totalSpace = stats.f_blocks * stats.f_bsize;
八、实战案例:设备状态监控
@Component
struct DeviceMonitor {@State batteryLevel: number = 0@State networkType: string = '未知'@State storageFree: string = '0'@State screenWidth: number = 0aboutToAppear() {this.loadDeviceInfo()}async loadDeviceInfo() {// 获取电池信息this.batteryLevel = batteryInfo.batteryLevel// 获取网络信息let net = await connection.getDefaultNet()this.networkType = net.type// 获取屏幕信息let display = await display.getDefaultDisplay()this.screenWidth = display.width// 获取存储信息let stats = await fileio.statfs('/data')let freeMB = (stats.f_bavail * stats.f_bsize) / (1024 * 1024)this.storageFree = freeMB.toFixed(0)}build() {Column({ space: 15 }) {Text('设备状态监控').fontSize(20).fontWeight(FontWeight.Bold)List({ space: 10 }) {ListItem() {Text(`电池电量: ${this.batteryLevel}%`)}ListItem() {Text(`网络类型: ${this.networkType}`)}ListItem() {Text(`屏幕宽度: ${this.screenWidth}px`)}ListItem() {Text(`可用存储: ${this.storageFree}MB`)}}.width('100%').layoutWeight(1)Button('刷新信息').onClick(() => this.loadDeviceInfo()).width(200)}.padding(20)}
}
九、总结
本章学习了HarmonyOS的设备能力调用:
✅ 设备信息 - 获取型号、厂商、屏幕信息
✅ 传感器 - 使用加速度、光线、距离传感器
✅ 电池管理 - 监控电量和充电状态
✅ 网络状态 - 检测网络连接和类型
✅ 振动反馈 - 提供触觉反馈
✅ 设备方向 - 监听屏幕旋转
✅ 存储空间 - 获取可用存储信息
使用注意:
- 部分功能需要权限
- 及时移除监听避免内存泄漏
- 耗电功能要合理使用
- 考虑不同设备的兼容性
这些设备能力让应用更智能、更人性化,是提升用户体验的关键技术。