搜尋套件、儲存庫與 APP 分類

audio_video_progress_bar 封面
套件詳情v2.0.3

audio_video_progress_bar

一個進度條小工具,用於顯示或變更音訊或影片串流的位置。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
6.5萬
喜歡數
446
Pub 分數
150

安裝套件

flutter pub add audio_video_progress_bar

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

一個用於顯示和控制音頻或視頻串流播放位置的 Flutter 小部件。它提供了一個可互動的視覺進度條,可用於在媒體內容中尋找。該小部件可自訂,並可在多個平台(包括行動裝置、網頁和桌面)上運作。它與音頻和視頻播放器無縫整合,在播放過程中提供順暢的使用者體驗。

適用情境

  • 媒體播放器介面
  • 影片時間軸導航
  • 音訊軌道定位
  • 互動式媒體控制
  • 串流應用介面
  • 即時音頻/視頻播放

主要特色

  • 可跳轉進度條
  • 跨平台相容性
  • 可自訂樣式
  • 即時播放反饋
  • 同時支援音訊和影片
  • 響應式觸控互動

適合對象

  • 開發媒體應用的開發者
  • 需要互動式進度指示器的UI設計師
  • 需要精確媒體控制的應用
  • 跨平台音視頻應用
  • 教育或娛樂串流平台

使用建議

  • 需要與媒體播放器整合
  • 僅限播放位置控制
  • 可能需要額外的狀態管理
  • 不適用於非媒體使用情境
  • 依賴外部媒體處理邏輯

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

audio_video_progress_bar

A progress bar widget to show or change the position of an audio or video stream.

Note: This package does not play audio or video itself. It's just a widget you can use to show the progress of your audio or video player. This widget is easier to connect to a media player than the Flutter Slider widget is. It also supports showing the buffered status for streamed media.

Example

Add the ProgressBar widget to your UI. A static example would look like this:

ProgressBar(
  progress: Duration(milliseconds: 1000),
  buffered: Duration(milliseconds: 2000),
  total: Duration(milliseconds: 5000),
  onSeek: (duration) {
    print('User selected a new time: $duration');
  },
),

However, you would normally wrap it in a builder widget that is updated by an audio or video player. That might look something like this:

StreamBuilder<DurationState>(
  stream: _durationState,
  builder: (context, snapshot) {
    final durationState = snapshot.data;
    final progress = durationState?.progress ?? Duration.zero;
    final buffered = durationState?.buffered ?? Duration.zero;
    final total = durationState?.total ?? Duration.zero;
    return ProgressBar(
      progress: progress,
      buffered: buffered,
      total: total,
      onSeek: (duration) {
        _player.seek(duration);
      },
    );
  },
),

...

class DurationState {
  const DurationState({this.progress, this.buffered, this.total});
  final Duration progress;
  final Duration buffered;
  final Duration total;
}

You can check out the GitHub repo for the full example using the just_audio plugin. There is no requirement to use just_audio or even a StreamBuilder, though. You can use any audio or video player that provides updates about the current play location. Just rebuild the ProgressBar widget with the new Duration states.

You'll probably want to add other buttons like start and pause, but these are not included with this package. They aren't hard to build, though, and you can find an example in the GitHub repo.

Thanks to the just_audio code example for help with the buttons.

Customization

The default colors use the theme's primary color, so changing the theme will also update this widget:

However, you can set your own colors and sizes as well:

ProgressBar(
  progress: progress,
  buffered: buffered,
  total: total,
  progressBarColor: Colors.red,
  baseBarColor: Colors.white.withOpacity(0.24),
  bufferedBarColor: Colors.white.withOpacity(0.24),
  thumbColor: Colors.white,
  barHeight: 3.0,
  thumbRadius: 5.0,
  onSeek: (duration) {
    _player.seek(duration);
  },
);

Which would look like this (if the app has a dark theme):

You can also set the location of the time labels:

ProgressBar(
  ...
  timeLabelLocation: TimeLabelLocation.sides,
);

Now the time labels are displayed on the side:

Notes

If your interested in how this widget was made, check out the article Creating a Flutter widget from scratch.

Please open an issue if you find any bugs.

New feature requests

There are a number of interesting feature requests in the GitHub issues. Unfortunately, with the other projects I have going on, I generally don't get around to implementing very many of them. Your best bet is to copy the source code and implement the feature yourself. On the other hand, if the issue you is important enough to you or your company, I'm open to being hired to add your desired feature to this package or to create a custom solution.

所屬分類

原始碼儲存庫

使用此套件的專案