Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev1.0.10

wallpaper_manager

Um plug-in Flutter para alterar o papel de parede da tela inicial, tela de bloqueio (ou ambos) em dispositivos Android.

Downloads em 30 dias
83
Curtidas
103
Pontos Pub
40

Instalar pacote

flutter pub add wallpaper_manager

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Wallpaper Manager é um plugin do Flutter que permite aos desenvolvedores definir programaticamente o papel de parede da tela inicial, da tela de bloqueio ou ambas em dispositivos Android. Ele fornece uma interface simples para aplicar imagens como papéis de parede diretamente dentro de um aplicativo Flutter, melhorando a experiência do usuário em aplicativos de fotos ou personalização. O plugin utiliza APIs nativas do Android e atualmente só suporta Android, sem implementação para iOS. Requer permissões adequadas e funciona melhor quando integrado em aplicativos focados em personalização, galerias de imagens ou exibições de arte digital.

Casos de uso

  • Definir papéis de parede dinâmicos a partir do conteúdo do aplicativo
  • Criando aplicativos de galeria de fotos com recursos de papel de parede
  • Habilitar personalização do usuário em aplicativos de estilo de vida
  • Integrando alterações de papel de parede em plataformas de arte digital

Principais recursos

  • Definir papel de parede da tela inicial
  • Definir papel de parede da tela de bloqueio
  • Suporte para ambas as telas simultaneamente
  • Integração simples com API do Flutter
  • Usa as APIs nativas de papel de parede do Android

Indicado para

  • Aplicativos exclusivos para Android que exigem alterações de papel de parede
  • Aplicativos de compartilhamento de fotos e arte
  • Ferramentas de personalização do usuário
  • Aplicativos com temas de fundo dinâmicos

Considerações

  • Apenas disponível para dispositivos Android
  • Requer solicitação de permissão em tempo de execução
  • Limitado ao sistema de papel de parede do Android
  • Não suporta iOS
  • Pode ser necessário lidar com a resolução e o formato da imagem

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

wallpaper_manager

Wallpaper Manager

A Flutter plugin for changing the Home Screen, Lock Screen (or both) Wallpaper(s) on Android devices.

Pub

Usage

Installation

In the pubspec.yaml of your flutter project, add the following dependency:

dependencies:
  ...
  wallpaper_manager: "^1.0.10"

In your library add the following import:

import 'package:wallpaper_manager/wallpaper_manager.dart';
Example
Basic Usage

Since this is not a Widget, you have to create WallpaperManager constructors from inside an async function, which is a Future that returns a String output specifying success/failure.

String path = "/path/to/file/on/disk";
int location = WallpaperManager.HOME_SCREEN; // or location = WallpaperManager.LOCK_SCREEN;
final String result = await WallpaperManager.setWallpaperFromFile(path, location);
Basic Usage with error handling

You might want to wrap it in a try/catch since platform messages (plug-ins like these) may fail

String path = "/path/to/file/on/disk";
int location = WallpaperManager.HOME_SCREEN; // or location = WallpaperManager.LOCK_SCREEN;
String result;
try {
  result = await WallpaperManager.setWallpaperFromFile(path, location);
} on PlatformException {
  result = 'Failed to get wallpaper.';
}
Loading from a URL (with CacheManager, the image is saved to app files as well)

If you're loading a Wallpaper from a URL, you should save it to the disk first, then use the path of the saved image file. Add flutter_cache_manager or any other dependency you'd like:

dependencies:
  ...
  flutter_cache_manager: "^1.1.3"

And in dart code

String url = "";
int location = WallpaperManager.HOME_SCREEN; // or location = WallpaperManager.LOCK_SCREEN;
String result;
var file = await DefaultCacheManager().getSingleFile(url);
final String result = await WallpaperManager.setWallpaperFromFile(file.path, location);
Loading from a Flutter asset

If you're loading a Wallpaper from an asset, you need to make sure it is indexed in the pubspec.yaml file first

dependencies:
  ...
  flutter:
    ...
    assets:
    - assets/tmp1.jpeg

And in dart code

String assetPath = "assets/tmp1.jpg";
int location = WallpaperManager.HOME_SCREEN; // or location = WallpaperManager.LOCK_SCREEN;
String result;
final String result = await WallpaperManager.setWallpaperFromAsset(assetPath, location);

Getting started

With Wallpaper Manager

See the example directory for a complete sample app using Wallpaper Manager.

With Flutter

For help getting started with Flutter, view the online documentation.

Notes

  • iOS does not support changing Wallpapers from third-party apps (Source)
  • Xiaomi/MIUI does not support changing Lock Screen Wallpapers directly from the Android API (Source). You might want to look at creating a Lock Screen Launcher app instead.

Known Issues

Todos

  • [ ] Write tests
  • [x] Add rect values for optionally cropping the image
  • [ ] Add variable for re-using Wallpaper from phone's settings
  • [ ] Write more tests

Changelog

Please see the Changelog page to know what's recently changed.

Contributions

Feel free to contribute to this project.

If you find a bug or want a feature, but don't know how to fix/implement it, please fill an issue.
If you fixed a bug or implemented a feature, please send a pull request.

Categorias

Repositório-fonte

Projetos que usam este pacote