更新记录

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关闭失败

方法说明

  1. 所有的方法都是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>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议