Pakete, Repositories und App-Kategorien suchen

Cover von floating
Paketdetailsv6.0.0

floating

Bild-in-Bild-Modus-Verwaltung für Flutter. Nur für Android verfügbar.

Android
30-Tage-Downloads
22.700
Likes
270
Pub-Punkte
160

Paket installieren

flutter pub add floating

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das Floating-Paket ermöglicht die Verwaltung des Picture-in-Picture-Modus (PiP) in Flutter-Anwendungen, speziell für Android. Es erlaubt Entwicklern eine nahtlose Umstellung der Medienwiedergabe in ein kleines, bewegliches Fenster, das während der Interaktion mit anderen Apps verschoben und vergrößert werden kann. Dies ist besonders nützlich für Video- oder Audioinhalte, die im Hintergrund weiter abgespielt werden sollen. Das Paket integriert sich direkt in die Android-PiP-API und bietet eine einfache Schnittstelle zur Steuerung des PiP-Verhaltens. Es unterstützt sowohl Video- als auch Audiobereiche, bei denen eine kontinuierliche Wiedergabe ohne vollständige App-Fokussierung gewünscht ist.

Anwendungsfälle

  • Hintergrund-Videowiedergabe
  • Audio-Streaming im PiP-Modus
  • Medien-Apps, die kontinuierliche Wiedergabe erfordern
  • Multitasking-Unterstützung unter Android
  • Videoanrufe mit verkleinertem Fenster

Hauptmerkmale

  • Nur für Android verfügbares PiP-Unterstützung
  • Einfaches API für die PiP-Aktivierung
  • Automatische PiP-Zustandsverwaltung
  • Anpassbare PiP-Größe und Position
  • Integration mit der PiP-API von Android

Geeignet für

  • Videoplayer-Apps
  • Audio-Streaming-Apps
  • Bildungs-Apps mit Medieninhalten
  • Apps, die Multitasking-Funktionen benötigen
  • Entwickler, die Android-Geräte ansprechen

Hinweise

  • Nur auf Android verfügbar
  • Erfordert Android 8.0+ (API 26)
  • Beschränkt auf Medienwiedergabeszenarien
  • Keine iOS-Unterstützung
  • Muss PiP-Lebenszyklusereignisse ordnungsgemäß behandeln

Original-README

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

floating

codecov

Picture in Picture management for Flutter. Android only

Picture in picture demo

App configuration

Add android:supportsPictureInPicture="true" line to the <activity> tag in android/src/main/AndroidManifest.xml:

<manifest>
   <application>
        <activity
            android:name=".MainActivity"
            android:supportsPictureInPicture="true"
            ...

Widget

This package provides a helper PiPSwitcher widget for switching the displayed widgets according to current PiP status. Use it like so:

PiPSwitcher(
    childWhenDisabled: Scaffold(...),
    childWhenEnabled: JustVideo(), 
)

API

PiP mode in desired mode is available only in Android so iOS and web support is not planned until the platforms adds native support for such feature.

Create a Floating instance
final floating = Floating();
Check if PiP is available
final canUsePiP = await floating.isPipAvailable;

PiP may be unavailable because of system settings managed by admin or device manufacturer. Also, the device may have Android version that was released without this feature.

Check if app is in PiP mode
final currentStatus = await floating.pipStatus;

Possible statuses:

Status Description Will enable() have an effect?
disabled PiP is available to use but currently disabled. Yes
enabled PiP is enabled. The app can display content but will not receive user inputs until the user decides to bring the app to it's full size. No
automatic PiP will be enabled automatically by the OS. Yes
unavailable PiP is disabled on given device. No
Enable PiP mode

Enable PiP right away:

final statusAfterEnabling = await floating.enable(ImmediatePiP());

Enable PiP when the app gets minimized via system gesture:

final statusAfterEnabling = await floating.enable(OnLeavePiP());

To later cancel, use .cancelOnLeavePiP().

When enabled, PiP mode can be toggled off by the user via system UI.

Arguments
aspectRatio:

The default 16/9 aspect ratio can be overridden with custom Rational. Eg. to make PiP square use: .enable(aspectRatio: Rational(1, 1)) or .enable(aspectRatio: Rational.square()).

sourceRectHint:

By default, system will simply use fade animation to tween between full app and PiP. Switching animation can be smoother by using source rect hint (example animation).

Check the example project to see an example of usage.

Kategorien

Quell-Repository

Projekte, die dieses Paket verwenden