更新记录

1.0.0(2025-10-13)

安卓设备锁屏和桌面壁纸设置,支持静态图片和动态视频


平台兼容性

uni-app(4.07)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - 5.0 × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - -

uni-app x(4.07)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - 5.0 × × -

1、设置静态壁纸

/**
* 设置设备静态壁纸
* @param bitmap 位图
* @param whichType 壁纸类型 见 WallpaperManager.FLAG_SYSTEM | WallpaperManager.FLAG_LOCK | WallpaperManager.FLAG_SYSTEM or WallpaperManager.FLAG_LOCK
*        这里用0,1,2表示设置只桌面,只设置锁屏,都设置
*/
setStaticWallpaper(bitmap : Bitmap, whichType : number)

2、设置动态壁纸

/**
* @param path 图片路径
*/
setLiveWallpaper(path : string)

使用方法举例:


                uni.chooseMedia({
                    count: 1,
                    success: (res) => {
                        if (res.tempFiles != null && res.tempFiles.length > 0) {
                            const uri = res.tempFiles[0].tempFilePath; // 获取文件路径或ID
                            setLiveWallpaper(uri); // context 传递 null 或当前组件实例
                        }
                    },
                    fail: (err) => {
                        console.error('选择视频失败:', err);
                        uni.showToast({
                            title: '选择视频失败',
                            icon: 'none'
                        });
                    }
                });

注意:使用前导入插件

import { setLiveWallpaper,setStaticWallpaper } from '../../uni_modules/st-wallpaper'

隐私、权限声明

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

"android.permission.SET_WALLPAPER", "android.permission.READ_EXTERNAL_STORAGE"

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

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

暂无用户评论。