Picture in Picture Mode Management for Flutter. Available Only For Android


Picture in Picture management for Flutter. Android only

App configuration 

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



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

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


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();

When you're done with the PiP functionality, make sure you're disposing the instance:


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:

StatusDescriptionWill enable() have an effect?
disabledPiP is available to use but currently disabled.Yes
enabledPiP 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
unavailablePiP is disabled on given device.No

Enable PiP mode 

final statusAfterEnabling = await floating.enable();

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

.enable arguments


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()).


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.

Use this package as a library

Depend on it

Run this command:

With Flutter:

 $ flutter pub add floating

This will add a line like this to your package's pubspec.yaml (and run an implicit flutter pub get):

  floating: ^2.0.1

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

Import it

Now in your Dart code, you can use:

import 'package:floating/floating.dart';


import 'dart:math';

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:floating/floating.dart';

void main() {

class MyApp extends StatefulWidget {
  _MyAppState createState() => _MyAppState();

class _MyAppState extends State<MyApp> with WidgetsBindingObserver {
  final floating = Floating();

  void initState() {

  void dispose() {

  void didChangeAppLifecycleState(AppLifecycleState lifecycleState) {
    if (lifecycleState == AppLifecycleState.inactive) {
      floating.enable(aspectRatio: Rational.square());

  Future<void> enablePip(BuildContext context) async {
    final rational = Rational.landscape();
    final screenSize =
        MediaQuery.of(context).size * MediaQuery.of(context).devicePixelRatio;
    final height = screenSize.width ~/ rational.aspectRatio;

    final status = await floating.enable(
      aspectRatio: rational,
      sourceRectHint: Rectangle<int>(
        (screenSize.height ~/ 2) - (height ~/ 2),
    debugPrint('PiP enabled? $status');

  Widget build(BuildContext context) => MaterialApp(
        theme: ThemeData.dark(),
        home: PiPSwitcher(
          childWhenDisabled: Scaffold(
            body: Center(child: Image.asset('assets/image.jpg')),
            floatingActionButton: FutureBuilder<bool>(
              future: floating.isPipAvailable,
              initialData: false,
              builder: (context, snapshot) => snapshot.data ?? false
                  ? FloatingActionButton.extended(
                      onPressed: () => enablePip(context),
                      label: const Text('Enable PiP'),
                      icon: const Icon(Icons.picture_in_picture),
                  : const Card(
                      child: Text('PiP unavailable'),
          childWhenEnabled: Image.asset('assets/image.jpg'),

Download details:

Author: wrbl.xyz

Source: https://github.com/wrbl606/floating

#flutter #android #ios

Picture in Picture Mode Management for Flutter. Available Only For Android
2.05 GEEK