Pakete, Repositories und App-Kategorien suchen

Paketdetailsv3.7.0

async_wallpaper

Hintergrundbilder auf Android asynchron festlegen. Unterstützt auch Video-Live-Wallpaper.

Android
30-Tage-Downloads
2440
Likes
91
Pub-Punkte
160

Paket installieren

flutter pub add async_wallpaper

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter-Paket, das das asynchrone Festlegen von Hintergründen auf Android-Geräten ermöglicht, einschließlich Unterstützung für Video-Live-Wallpapers. Es bietet eine einfache und effiziente Möglichkeit, Hintergründe innerhalb einer Flutter-Anwendung zu ändern, ohne die UI-Thread zu blockieren. Das Paket ist speziell für Android entwickelt und integriert sich nahtlos mit den nativen Android-APIs. Es ermöglicht Entwicklern, die Benutzererfahrung durch dynamische Anpassungsoptionen für Hintergründe zu verbessern. Der Quellcode ist öffentlich auf GitHub verfügbar, um Transparenz und Mitwirkung zu gewährleisten.

Anwendungsfälle

  • Statische Hintergründe aus der App festlegen
  • Erstellen von Video-Live-Wallpaper
  • Verbesserung der Personalisierungsfunktionen
  • Hintergrund-Wallpaper-Updates
  • Integration mit Fotogalerie-Apps

Hauptmerkmale

  • Asynchrone Hintergrundfestlegung
  • Unterstützung für Video-Live-Wallpaper
  • Plattformkompatibilität nur für Android
  • Einfache API-Integration
  • Nicht-blockierende UI-Operationen

Geeignet für

  • Android-App-Entwickler
  • Wallpaper-Anpassungs-Apps
  • Foto- und Medien-Apps
  • Projekte zur Verbesserung der Benutzererfahrung
  • Apps, die dynamische Hintergrundänderungen erfordern

Hinweise

  • Beschränkt auf die Android-Plattform
  • Erfordert Laufzeitberechtigungen
  • Die Unterstützung für Videohintergrundbilder hängt von den Gerätefähigkeiten ab
  • Funktioniert möglicherweise nicht auf allen Android-Versionen
  • Möglicher Einfluss auf die Batterie bei Videotapeten

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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

Kategorien

Quell-Repository

Projekte, die dieses Paket verwenden