Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev3.7.0

async_wallpaper

Defina papéis de parede no Android de forma assíncrona. Também suporta papéis de parede animados com vídeo.

Android
Downloads em 30 dias
2,4 mil
Curtidas
91
Pontos Pub
160

Instalar pacote

flutter pub add async_wallpaper

Visão geral do pacote

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

Um pacote Flutter que permite definir papéis de parede em dispositivos Android de forma assíncrona, incluindo suporte para papéis de parede animados com vídeo. Ele oferece uma maneira simples e eficiente de alterar papéis de parede dentro de um aplicativo Flutter sem bloquear a thread da interface. O pacote é especificamente projetado para Android e integra-se perfeitamente com APIs nativas do Android. Permite aos desenvolvedores melhorar a experiência do usuário ao oferecer opções dinâmicas de personalização de papéis de parede. O código-fonte está publicamente disponível no GitHub para transparência e contribuições.

Casos de uso

  • Definir papéis de parede estáticos a partir do aplicativo
  • Criando papéis de parede em vídeo ao vivo
  • Melhorando os recursos de personalização
  • Atualizações de papel de parede de fundo
  • Integração com aplicativos de galeria de fotos

Principais recursos

  • Configuração assíncrona de papel de parede
  • Suporte para papéis de parede ao vivo com vídeo
  • Compatibilidade de plataforma exclusiva para Android
  • Integração simples da API
  • Operações de UI não bloqueantes

Indicado para

  • desenvolvedores de aplicativos Android
  • aplicativos de personalização de papel de parede
  • Aplicativos de foto e mídia
  • Projetos de melhoria da experiência do usuário
  • Aplicativos que exigem mudanças dinâmicas de fundo

Considerações

  • Limitado à plataforma Android
  • Requer permissões em tempo de execução
  • O suporte a papel de parede de vídeo depende das capacidades do dispositivo
  • Pode não funcionar em todas as versões do Android
  • Impacto potencial na bateria com papéis de parede em vídeo

README original

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

async_wallpaper

pub package

Flutter plugin to set wallpapers on Android and save them to Photos on iOS.

  • Static wallpaper from a URL, file path, content URI, or bytes
  • Home, lock, or both targets, with a separate result for each
  • Video and OpenGL live wallpapers
  • Scheduled wallpaper rotation
  • Capability checks before you show an action

Screenshots

Static wallpaper Capabilities More APIs iOS

Video live wallpaper: home screen before, the system preview, and the applied video.

Scale modes: centerCrop, fitCenter, center, fill, and stretch on a 1080x2400 phone.

Requirements

  • Flutter >=3.41.4, Dart >=3.9.0
  • Android minSdk 24
  • iOS 13.0+ (download only)

Installation

dependencies:
  async_wallpaper: ^3.3.0
import 'package:async_wallpaper/async_wallpaper.dart';

Usage

Check capabilities
final c = await AsyncWallpaper.getCapabilities();
if (c.supportsStaticWallpaper && c.canSetWallpaper) {
  // Show the action.
}
Static wallpaper
final result = await AsyncWallpaper.applyWallpaper(
  const StaticWallpaperRequest(
    source: WallpaperSource.url('https://example.com/wallpaper.jpg'),
    target: WallpaperTarget.both,
    scaleMode: WallpaperScaleMode.centerCrop,
    strategy: WallpaperApplyStrategy.direct,
  ),
);
if (result.status == WallpaperOperationStatus.applied) {
  // For `both`, read `result.home` and `result.lock`.
}

Sources: WallpaperSource.url (HTTPS), filePath, contentUri, bytes.

Video live wallpaper
final req = VideoWallpaperRequest(
  source: WallpaperSource.filePath('/storage/emulated/0/Download/loop.mp4'),
  target: WallpaperTarget.home,
);
final prepared = await AsyncWallpaper.setVideoWallpaper(req);
if (prepared.status == WallpaperOperationStatus.awaitingUserConfirmation) {
  await AsyncWallpaper.openLiveWallpaperPreview(req);
}

previewOpened means the system preview opened, not that the user applied it.

OpenGL live wallpaper

Check supportsOpenGlLiveWallpaper first, then call setOpenGlLiveWallpaper with a GLSL ES 1.00 fragment shader (1-60 FPS).

Wallpaper rotation
await AsyncWallpaper.startWallpaperRotation(
  const WallpaperRotationRequest(
    sources: <WallpaperRotationSource>[
      WallpaperRotationSource(sourceType: WallpaperSourceType.url, source: 'https://example.com/1.jpg'),
      WallpaperRotationSource(sourceType: WallpaperSourceType.file, source: '/storage/emulated/0/Download/2.jpg'),
    ],
    target: WallpaperTarget.both,
    intervalMinutes: 60,
    order: WallpaperRotationOrder.shuffle,
    triggers: <WallpaperRotationTrigger>{
      WallpaperRotationTrigger.interval,
      WallpaperRotationTrigger.charging,
      WallpaperRotationTrigger.timeOfDay,
    },
    activeHoursStart: 6,
    activeHoursEnd: 23,
  ),
);
await AsyncWallpaper.getWallpaperRotationStatus();
await AsyncWallpaper.rotateWallpaperNow();
await AsyncWallpaper.stopWallpaperRotation();

The minimum interval is 15 minutes. URLs must be HTTPS. Rotation uses WorkManager and needs no foreground service.

Download
await AsyncWallpaper.downloadWallpaper(
  const DownloadWallpaperRequest(url: 'https://example.com/wallpaper.jpg'),
);
  • iOS: add NSPhotoLibraryAddUsageDescription to Info.plist.
  • Android 9 and older: declare WRITE_EXTERNAL_STORAGE with android:maxSdkVersion="28" and request it before you call downloadWallpaper.

Platform support

Android iOS Web/desktop
Static, live, OpenGL, rotation Yes unsupported unsupported
Download Yes Yes unsupported
  • Background work (for example WorkManager): use WallpaperApplyStrategy.direct. The cropper, picker, and live previews need a foreground Activity and return foregroundRequired otherwise.
  • The plugin shows no toasts and does not navigate. Your app shows its own UI from the result.

Docs

Contributing

Report bugs with the bug report template and include the device model, Android version, and steps to reproduce. Request features with the feature request template. Read CONTRIBUTING.md before you open a PR.

License

MIT

Categorias

Repositório-fonte

Projetos que usam este pacote