如何通过OpenHarmony菜单管理设备

OpenHarmony菜单管理设备的实践指南

一、概念与适用场景

• 在应用层，菜单通常指UI菜单（如选项菜单、上下文菜单、自定义弹窗菜单），用于触发对设备的操作（如亮度调节、电源管理、设备信息查看等）。这些操作依赖系统提供的 @ohos.brightness、@ohos.power、@ohos.deviceInfo 等 API。部分系统级能力（如耗电统计、系统参数）多为系统应用开放，普通应用需声明权限并在受限范围内使用。
• 在分布式场景，菜单可作为协同入口，通过分布式能力发现并拉起局域网内的其他设备，把菜单操作在多台设备间同步（如多人点餐的“线上菜单”）。该模式通常结合分布式数据库与分布式设备拉起实现。

二、应用内菜单与设备管理能力集成

• 权限与能力声明：在 module.json5 的 module.requestPermissions 中声明所需权限（如与亮度、电源、设备信息相关的权限），并在代码中按需检查与请求。
• 菜单触发与事件分发：在页面中定义菜单（选项菜单/上下文菜单/自定义弹窗），在点击事件中调用设备管理能力，例如：
  • 屏幕亮度：使用 @ohos.brightness 获取/设置屏幕亮度，结合 @ohos.settings 读写亮度相关设置项（如“screen_brightness_mode”“screen_brightness”）。
  • 电源管理：使用 @ohos.power 执行重启、关机、休眠等操作（需系统授权）。
  • 设备信息：使用 @ohos.deviceInfo 获取设备型号、序列号、厂商等，用于菜单中展示或作为设备选择依据。
• 系统能力检查：通过 @ohos.systemCapability 判断设备是否支持目标能力，避免在不支持的设备上调用导致失败。
• 菜单与设备操作解耦：将“菜单项定义—事件分发—设备能力调用”分层，便于扩展新菜单项而不改动设备控制逻辑。

三、分布式菜单的设备协同

• 设备发现与拉起：在菜单中提供“邀请/分享”入口，调用分布式能力发现局域网设备并拉起目标设备上的菜单页面（同一应用在多设备上协同）。
• 数据一致性：使用分布式数据库维护菜单状态（如菜品列表、购物车、订单），所有已加入的设备可实时看到数量与总额变化，适合多人点餐、协同运维等场景。
• 典型流程：
  1. 用户在设备A点击“分享”；2) 弹出设备列表并选择设备B；3) 应用通过分布式能力在设备B上拉起菜单页；4) 两端通过分布式数据库自动同步菜单与订单数据。

四、命令行工具辅助的设备管理

• 连接与基础管理：使用 hdc 工具进行设备连接、安装/卸载应用、进入 Shell、查看设备信息等，便于在菜单中集成“远程维护/调试”入口。例如：
  • 查看设备：hdc list targets
  • 安装/覆盖安装：hdc install app.hap / hdc install -r app.hap
  • 进入设备 Shell：hdc shell
  • 查看设备信息：hdc shell param get const.product.name
  • 唤醒屏幕：hdc shell power-shell wakeup
• 日志与问题定位：通过 hdc hilog 实时查看日志，结合标签/级别过滤快速定位菜单触发的设备操作问题。
• 提示：部分系统级能力（如耗电统计、系统参数）多为系统应用开放，命令行工具与系统 API 的可用性需与设备系统版本、权限策略匹配。

五、最小实现示例

• 目标：在页面菜单中提供“查看设备信息”“调高亮度”“邀请设备协同”三项，点击后在控制台输出或调用系统 API。
• 代码示例（ETS + ArkUI，省略权限与异常处理的完整工程化实现）：

// 1) 菜单项定义
enum MenuItemId {
  DEVICE_INFO = 'device_info',
  BRIGHTNESS_UP = 'brightness_up',
  INVITE_DEVICE = 'invite_device'
}

// 2) 菜单点击分发
function onMenuAction(id: MenuItemId) {
  switch (id) {
    case MenuItemId.DEVICE_INFO:
      import deviceInfo from '@ohos.deviceInfo';
      console.info('Device:', JSON.stringify(deviceInfo));
      break;
    case MenuItemId.BRIGHTNESS_UP:
      import brightness from '@ohos.brightness';
      import settings from '@ohos.settings';
      // 示例：读取当前模式与亮度，尝试小幅提升（需权限与系统支持）
      // let mode = settings.getValueSync(settings.display.SCREEN_BRIGHTNESS_MODE, 0);
      // let cur = brightness.getValue();
      // brightness.setValue(Math.min(255, cur + 20));
      console.info('Increase brightness requested');
      break;
    case MenuItemId.INVITE_DEVICE:
      // 打开分布式设备选择/邀请对话框，拉起远端设备菜单页
      // RemoteDeviceManager.showDeviceDialog(); // 伪代码：实现分布式拉起
      console.info('Invite device requested');
      break;
  }
}

// 3) 在页面中绑定菜单项（示例按钮）
@Entry
@Component
struct MainPage {
  build() {
    Column({ space: 20 }) {
      Button('设备信息').onClick(() => onMenuAction(MenuItemId.DEVICE_INFO))
      Button('提高亮度').onClick(() => onMenuAction(MenuItemId.BRIGHTNESS_UP))
      Button('邀请设备协同').onClick(() => onMenuAction(MenuItemId.INVITE_DEVICE))
    }
    .padding(20)
  }
}

• 说明：上述示例聚焦“菜单分发—设备能力调用”的主干路径；真实项目需补充权限申请、分布式拉起与数据库接入、以及UI状态管理。