更新记录
1.0.5(2025-08-22) 下载此版本
修改配置
1.0.4(2025-08-21) 下载此版本
修改备注
1.0.3(2025-08-21) 下载此版本
增加安卓闪光灯
查看更多平台兼容性
uni-app(4.72)
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
- | - | × | × | × | × | - | × | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
× | × | × | × | × | × | × | × | × | × | × |
uni-app x(4.72)
Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
---|---|---|---|---|---|
× | × | - | × | - | × |
其他
多语言 | 暗黑模式 | 宽屏模式 |
---|---|---|
√ | √ | √ |
an-flashlight
开发文档
UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS
插件说明
该插件只支持鸿蒙、安卓环境,之后有时间可以ios;
插件方法说明
方法 | 兼容 | 文件说明 | 返回说明 |
---|---|---|---|
getIsTorchSupported | ios不支持 | 判断当前设备是否支持闪光灯 | 返回boolean格式,true标识支持,false表示不支持 |
setTorchMode | ios不支持 | 打开闪光灯 (再次点击是关闭) | 返回boolean格式,true打开了闪光灯,false开启失败 |
closeTorchMode | ios不支持 | 关闭闪光灯 | 返回boolean格式,true关闭了闪光灯, false开启失败 |
getTorchMode | ios不支持 | 获取闪光灯状态 | 返回number格式,0表示关闭 1 表示开启 |
onTorchStatusChange | ios、Android不支持 | 监听闪光灯变化,默认会执行一次 (注意该方法最好只执行一次,执行多次会有多个放回) | 返回对象格式格式,对象里面 torchLevel 0表示关闭 1 表示开启 |
offTorchStatusChange | ios、Android不支持 | 关闭监听状态 | 返回boolean格式,true关闭了,false关闭失败 |
initFlashLight | ios、鸿蒙不支持 | 安卓初始化闪光灯 | 返回boolean格式,true关闭了,false关闭失败 |
方法说明
- 所有的方法都是Promise格式,只要走到.then都是成功的意思,走到 .catch 表示库报错了;
使用说明
<template>
<view>
<button @click="setInit">安卓需要初始化</button>
<button @click="getTorch">获取闪光灯状态</button>
<button @click="onModel">打开闪光灯(再次点击是关闭)</button>
<button @click="closeModel">关闭闪光灯</button>
<button @click="supported">判断当前设备是否支持闪光灯</button>
<button @click="onTorch">监听闪光灯变化(鸿蒙支持)</button>
<button @click="offTorch">关闭监听闪光灯变化(鸿蒙支持)</button>
</view>
</template>
<script setup>
import { getIsTorchSupported,setTorchMode,getTorchMode,closeTorchMode,onTorchStatusChange,offTorchStatusChange,initFlashLight, } from '@/uni_modules/an-flashlight';
// 初始化
const setInit = () => {
const context = UTSAndroid.getAppContext();
if(context != null) initFlashLight(context)
}
// 判断当前设备是否支持闪光灯
const supported = async () => {
let mode = await getIsTorchSupported();
console.log(mode);
}
// 打开闪光灯 (再次点击是关闭)
const onModel = async () => {
let mode = await setTorchMode();
console.log(mode);
}
// 关闭闪光灯
const closeModel = async () => {
let mode = await closeTorchMode();
console.log(mode);
}
// 获取闪光灯状态
const getTorch = async () => {
let mode = await getTorchMode();
console.log(mode);
}
// 监听闪光灯变化,默认会执行一次 (注意该方法最好只执行一次,执行多次会有多个放回)
const onTorch = () => {
// #ifdef APP-HARMONY
onTorchStatusChange({
change: (err,torchStatusInfo) => {
console.log(err,torchStatusInfo);
}
})
// #endif
}
// 关闭监听
const offTorch = async () => {
let mode = await offTorchStatusChange();
console.log(mode);
}
</script>