#HarmonyOS NEXT体验官#手电筒应用 原创

手电筒应用

大家好，今天我们一起来开发一个手电筒应用。

前言

在日常生活中，它为人们在黑暗环境中提供照明，如夜间行走、寻找物品、检查电器设备或处理突发的停电情况。尤其对于居住在电力供应不稳定地区的人们，手电筒是必备的工具。

在户外活动中，如露营、徒步旅行、探险等，手电筒能帮助人们看清道路、识别方向、避免危险。它也是紧急情况下的重要信号工具，通过闪烁灯光来引起救援人员的注意。

在工作场景中，维修工人、电力工程师等常常需要手电筒来照亮狭小或昏暗的工作空间，以便进行准确的操作和检查。

从安全角度来看，手电筒可以在遇到紧急危险时作为防身工具，用来暂时吓退潜在的威胁。

总之，手电筒应用虽看似简单，却在保障人们的生活便利、安全以及完成各种任务方面发挥着不可或缺的作用。

功能：

简单开关：用户可以通过点击应用内的按钮或图标轻松打开和关闭手电筒。

SOS 求救信号模式：按照国际通用的 SOS 求救信号节奏（三短、三长、三短）闪烁灯光，在紧急情况下可以发送求救信号。

频闪模式：以一定频率快速闪烁灯光，可用于引起注意、信号指示等场景。

电量显示：实时显示设备当前的电量状态，让用户了解剩余电量还能支持手电筒使用的时长。

低电量提醒：当设备电量低于一定阈值（如 20%）时，给用户发送提醒通知，避免突然没电影响使用。

效果

关灯	开灯

接下来看一下，如何实现。

首先，我们需要检测设备是否支持手电筒。

使用接口

isTorchSupported

isTorchSupported(): boolean

检测设备是否支持手电筒。

系统能力： SystemCapability.Multimedia.Camera.Core

返回值：

类型	说明
boolean	返回true表示设备支持手电筒。

示例：

function isTorchSupported(cameraManager: camera.CameraManager): boolean {
  let isSupported = cameraManager.isTorchSupported();
  return isSupported;
}

接下来我们检测支持设置的手电筒模式。

isTorchModeSupported

isTorchModeSupported(mode: TorchMode): boolean

检测是否支持设置的手电筒模式。

系统能力： SystemCapability.Multimedia.Camera.Core

参数：

参数名	类型	必填	说明
mode	TorchMode	是	手电筒模式。

返回值：

类型	说明
boolean	返回true表示设备支持设置的手电筒模式。

function isTorchModeSupported(cameraManager: camera.CameraManager, torchMode: camera.TorchMode): boolean {
  let isSupported = cameraManager.isTorchModeSupported(torchMode);
  return isSupported;
}

我们得到返回结果是123，

setTorchMode

setTorchMode(mode: TorchMode): void

设置设备手电筒模式。

系统能力： SystemCapability.Multimedia.Camera.Core

参数：

参数名	类型	必填	说明
mode	TorchMode	是	手电筒模式。

错误码：

以下错误码的详细介绍请参见Camera错误码。

错误码ID	错误信息
7400101	Parameter missing or parameter type incorrect.
7400102	Operation not allowed.
7400201	Camera service fatal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

function setTorchMode(cameraManager: camera.CameraManager, torchMode: camera.TorchMode): void {
  try {
    cameraManager.setTorchMode(torchMode);
  } catch (error) {
    // 失败返回错误码error.code并处理
    let err = error as BusinessError;
    console.error(`The setTorchMode call failed. error code: ${err.code}`);
  }
}

on(‘torchStatusChange’)

on(type: ‘torchStatusChange’, callback: AsyncCallback<TorchStatusInfo>): void

手电筒状态变化回调，通过注册回调函数获取手电筒状态变化。使用callback异步回调。

说明

当前注册监听接口，不支持在on监听的回调方法里，调用off注销回调。

系统能力： SystemCapability.Multimedia.Camera.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为’torchStatusChange’。cameraManager对象获取成功后可监听。目前只支持手电筒打开，手电筒关闭，手电筒不可用，手电筒恢复可用会触发该事件并返回对应信息。
callback	AsyncCallback<TorchStatusInfo>	是	回调函数，用于获取手电筒状态变化信息。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, torchStatusInfo: camera.TorchStatusInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`onTorchStatusChange, isTorchAvailable: ${torchStatusInfo.isTorchAvailable}, isTorchActive: ${torchStatusInfo.isTorchActive}, level: ${torchStatusInfo.torchLevel}`);
}

function registerTorchStatusChange(cameraManager: camera.CameraManager): void {
  cameraManager.on('torchStatusChange', callback);
}

off(‘torchStatusChange’)11+

off(type: ‘torchStatusChange’, callback?: AsyncCallback<TorchStatusInfo>): void

手电筒状态变化注销回调，通过注销回调函数取消获取手电筒状态变化。

系统能力： SystemCapability.Multimedia.Camera.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为’torchStatusChange’。cameraManager对象获取成功后可监听。
callback	AsyncCallback<TorchStatusInfo>	否	回调函数，如果指定参数则取消对应callback（callback对象不可是匿名函数），否则取消所有callback。

示例：

function unregisterTorchStatusChange(cameraManager: camera.CameraManager): void {
  cameraManager.off('torchStatusChange');
}

最后最关键的代码，其实就是

下面这段

Column() {

  Button('打开手电筒', { stateEffect: true, type: ButtonType.Capsule })
    .width('80%')
    .height(40)
    .margin(20)
    .onClick(() => {
      camera.getCameraManager(getContext() as common.UIAbilityContext).setTorchMode(1);
    })
  Button('关闭手电筒', { stateEffect: true, type: ButtonType.Capsule })
    .width('80%')
    .height(40)
    .margin(20)
    .onClick(() => {
      camera.getCameraManager(getContext() as common.UIAbilityContext).setTorchMode(0);
    })
}

所以大家看到了吧，其实实现一个手电筒，也没有那么难。你也可以大胆的尝试一下。这里面，我们为了方便，就把image换成了button，你可以按照我上面的实现，做一下试试。