flutter pub add floating基于插件公开信息、社区数据与项目使用情况整理的选型参考。
浮动包为Flutter应用程序中的画中画（PiP）模式管理提供了支持，专用于Android。它允许开发者将媒体播放无缝转换为可移动和可调整大小的小型浮动窗口，同时用户可以与其他应用进行交互。这对于需要在后台持续播放的视频或音频内容特别有用。该包直接集成Android的PiP API，提供了一个简单直观的接口来控制PiP行为。它支持需要持续播放但无需完全聚焦应用的视频和音频用例。
以下为关联源码仓库的 README 原文快照，最新内容请访问源码仓库。
Picture in Picture management for Flutter. Android only
Add android:supportsPictureInPicture="true" line to the <activity> tag in android/src/main/AndroidManifest.xml:
<manifest>
<application>
<activity
android:name=".MainActivity"
android:supportsPictureInPicture="true"
...
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(),
)
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.
final floating = Floating();
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.
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 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.
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.