### bada2.0培训_2_5_System：深入解析Osp::System命名空间及关键类
#### 一、概述
在bada2.0开发体系中，`Osp::System`命名空间扮演着极其重要的角色。它提供了一系列的类与接口，帮助开发者获取设备上的系统信息、控制设备行为以及响应各种事件。这些功能覆盖了诸如设置闹钟、监测电池状态、管理电源、监控设备连接状态等多个方面。接下来，我们将详细探讨该命名空间下各个关键类的功能及其提供的API。
#### 二、Osp::System命名空间下的核心类
##### 1. **Alarm** —— 闹钟管理
- **功能描述**：
- 允许应用程序创建、删除和更新闹钟。
- 支持一次性闹钟或重复性闹钟。
- **提供的API**：
- `GetEndTime()`：获取闹钟的结束时间。
- `GetPeriod()`：获取重复周期。
- `GetStartTime()`：获取闹钟的开始时间。
- `Set()`：设置闹钟。
- `Cancel()`：取消闹钟。
- `IAlarmEventListener`：监听闹钟到期事件。
- `OnAlarmExpired()`：闹钟到期时调用此方法。
##### 2. **Battery** —— 电池信息
- **功能描述**：
- 提供当前电池电量和电池是否正在充电的信息。
- **提供的API**：
- `GetCurrentLevel()`：获取当前电量（毫伏）。
- `GetCurrentLevelInPercentage()`：获取当前电量百分比。
- `IsCharging()`：判断电池是否正在充电。
##### 3. **DeviceManager** —— 设备管理
- **功能描述**（自版本1.1起）：
- 监控附件设备的连接状态。
- 支持添加/删除设备状态监听器。
- 监测以下设备的状态：
- 蓝牙耳机
- 充电器
- USB客户端
- TV输出
- 有线耳机(headset)
- 有线头戴耳机(headphone)
- 存储卡
- 硬件键盘
##### 4. **PowerManager** —— 电源管理
- **功能描述**：
- 控制电源管理策略。
- 高效管理电池电量。
- **提供的API**：
- `GetScreenBrightness()`：获取屏幕亮度。
- `IsScreenOn()`：判断屏幕是否开启。
- `KeepScreenOnState()`：保持屏幕开启状态。
- `SetBatteryEventListener()`：设置电池电量监听器。
- `SetChargingEventListener()`：设置充电状态监听器。
- `SetScreenBrightness()`：设置屏幕亮度。
- `SetScreenEventListener()`：设置屏幕状态监听器。
##### 5. **RuntimeInfo** —— 运行时信息
- **功能描述**：
- 获取各种运行时信息。
- **提供的数据**：
- AllocatedMemory：已分配内存
- AvailableExternalStorage：可用外部存储
- AvailableInternalStorage：可用内部存储
- AvailableMediaStorage：可用媒体存储
- BatteryLevel：电池电量
- IsCharging：是否正在充电
##### 6. **SettingInfo** —— 设置信息
- **功能描述**：
- 提供设备系统设置信息。
- 可以通过`ISettingEventListener`接收设置改变时的通知。
- **提供的设置项**：
- Country：国家
- DataRoamingEnabled：数据漫游启用
- FlightModeEnabled：飞行模式启用
- GPSEnabled：GPS启用
- Language：语言
- SilentMode：静音模式
- Theme：主题
- TouchVibrationLevel：触摸振动级别
- WPSEnabled：WPS启用
##### 7. **SystemInfo** —— 系统信息
- **功能描述**：
- 获取设备的系统属性和设备能力的相关信息。
- **提供的信息**：
- BluetoothSupported：支持蓝牙
- CameraCount：摄像头数量
- FmRadioSupported：支持FM收音机
- KeyboardType：键盘类型
- MultiPointTouchCount：多点触控支持点数
- NFCSupported：支持NFC
- OpenGLESVersion：OpenGL ES版本
- RSSI：信号强度
- TvOutSupported：支持TV输出
- WiFiSupported：支持Wi-Fi
##### 8. **SystemTime** —— 系统时间
- **功能描述**：
- 获取不同模式下的当前系统时间。
- **支持的时间模式**：
- UTC：协调世界时间
- Standard：本地时间
- Walltime：夏令时
- **提供的API**：
- `GetCurrentTime()`：获取当前时间。
- `GetTicks()`：获取时间戳。
- `GetUptime()`：获取自启动以来的运行时间。
##### 9. **Vibrator** —— 振动器控制
- **功能描述**：
- 访问和控制设备的振动器。
- **提供的API**：
- 单触发：`Start()`，参数为时长和强度。
- 多触发：`Start()`，参数为开始时间、结束时间、次数和强度。
- `Stop()`：停止振动。
#### 三、总结
通过`Osp::System`命名空间提供的功能，开发者可以轻松访问各种系统信息、设备特定状态和系统设置信息，并能够接收到设置项发生改变的通知。这对于提高应用的功能性和用户体验具有重要意义。掌握了这些类和API的使用，将极大地增强开发者在bada2.0平台上开发应用的能力。
