feat: ✨ Add web platform support for audio player #472

vasu-nageshri · 2026-01-12T06:11:41Z

Description

This PR introduces comprehensive web platform support to the audio_waveforms Flutter plugin, enabling audio playback in web applications. The implementation leverages the Web Audio API and HTML5 audio elements to provide feature parity with native platforms.

Checklist

The title of my PR starts with a Conventional Commit prefix (fix:, feat:, docs: etc).
I have followed the Contributor Guide when preparing my PR.
I have updated/added tests for ALL new/updated/fixed functionality.
I have updated/added relevant documentation in docs and added dartdoc comments with ///.
I have updated/added relevant examples in examples or docs.

Breaking Change?

Yes, this PR is a breaking change.
No, this PR is not a breaking change.

Related Issues

Copilot

Pull request overview

This PR adds comprehensive web platform support for the audio_waveforms Flutter plugin, enabling audio playback functionality in web browsers using HTML5 Audio API. The implementation provides feature parity with native platforms for audio playback, while explicitly excluding recording functionality which is not supported on the web platform.

Changes:

Added web platform implementation for audio player with HTML5 audio elements
Implemented platform-specific method channel handlers for web
Added web configuration files and assets for the example app
Updated dependencies to support web platform (flutter_web_plugins, web package)

Reviewed changes

Copilot reviewed 12 out of 17 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
pubspec.yaml	Added flutter_web_plugins and web dependencies, registered web plugin
lib/audio_waveforms_web.dart	Entry point that delegates to web plugin implementation
lib/web/audio_waveforms_plugin_web.dart	Main web plugin class handling method channel calls
lib/web/audio_player_web.dart	Core audio player implementation using HTMLAudioElement
lib/web/waveform_extractor_web.dart	Placeholder waveform extraction with dummy data
lib/web/base/constants_web.dart	Web-specific constants
lib/web/base/utils_web.dart	Web console logging utilities
example/lib/main.dart	Added web platform checks and recording restrictions
example/pubspec.yaml	Updated file_picker dependency version
example/web/*	Standard Flutter web assets (manifest, index.html, icons, favicon)
CHANGELOG.md	Added entry for web platform support

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

lib/web/audio_player_web.dart

lib/web/waveform_extractor_web.dart

lib/web/audio_player_web.dart

example/lib/main.dart

lib/web/waveform_extractor_web.dart

lib/web/audio_player_web.dart

Copilot

Pull request overview

Copilot reviewed 12 out of 17 changed files in this pull request and generated 13 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

lib/web/audio_player_web.dart

example/lib/main.dart

ujas-m-simformsolutions · 2026-01-12T09:33:55Z

lib/web/audio_player_web.dart

+  }
+
+  /// Prepares the audio player with the given path
+  Future<bool> preparePlayer(Map<dynamic, dynamic> arguments) async {


Cant we pass <String, dynamic>?

ujas-m-simformsolutions · 2026-01-12T09:34:41Z

lib/web/audio_player_web.dart

+      final String path = rawPath;
+      final int frequency = arguments[Constants.updateFrequency] ??
+          WebConstants.defaultUpdateFrequency;
+      final double? volume = arguments[Constants.volume];


check type here as well

ujas-m-simformsolutions · 2026-01-12T09:35:03Z

lib/web/audio_player_web.dart

+      final completer = Completer<bool>();
+      bool isCompleted = false;
+
+      audioElement.addEventListener(


do we need to remove listeners?

ujas-m-simformsolutions · 2026-01-12T09:36:03Z

lib/web/audio_player_web.dart

+      return await completer.future
+          .timeout(
+        const Duration(seconds: WebConstants.defaultLoadTimeout),
+        onTimeout: () => false,


we must not use these type of static timeouts

ujas-m-simformsolutions · 2026-01-12T09:38:53Z

lib/web/audio_player_web.dart

+
+      // Stop the player if it's currently playing
+      if (isPlaying) {
+        await stopPlayer();


this method does same thing as below

ujas-m-simformsolutions · 2026-01-12T09:40:54Z

lib/web/audio_player_web.dart

+  void _sendDurationUpdate(int currentTime) {
+    onDurationUpdate(currentTime);
+  }


we can directly use the callback

ujas-m-simformsolutions · 2026-01-12T09:41:08Z

lib/web/audio_player_web.dart

+  void _sendCompletionEvent() {
+    onCompletion();
+  }


ujas-m-simformsolutions · 2026-01-12T09:43:38Z

lib/web/audio_waveforms_plugin_web.dart

+
+  /// Handles method calls from the platform interface
+  Future<dynamic> handleMethodCall(MethodCall call) async {
+    final args = call.arguments as Map<dynamic, dynamic>?;


use <string, dynamic>

ujas-m-simformsolutions · 2026-01-12T09:44:56Z

lib/web/audio_waveforms_plugin_web.dart

+            {
+              Constants.playerKey: playerKey,
+              Constants.finishType:
+                  2, // 2 = stopped (default finish mode on web)


ujas-m-simformsolutions · 2026-01-12T09:45:27Z

lib/web/base/utils_web.dart

+
+import 'package:web/web.dart';
+
+extension WebConsoleLogger on String {


add top level documentation

vasu-nageshri requested a review from Copilot January 12, 2026 06:15

Copilot started reviewing on behalf of vasu-nageshri January 12, 2026 06:15 View session

Copilot AI reviewed Jan 12, 2026

View reviewed changes

vasu-nageshri force-pushed the feat/add_web_support_player_feature branch from 6a79e1d to 2a617d4 Compare January 12, 2026 06:21

SimformSolutionsPvtLtd deleted a comment from Copilot AI Jan 12, 2026

vasu-nageshri force-pushed the feat/add_web_support_player_feature branch from 2a617d4 to 8915752 Compare January 12, 2026 06:36

ujas-m-simformsolutions requested a review from Copilot January 12, 2026 08:03

Copilot started reviewing on behalf of ujas-m-simformsolutions January 12, 2026 08:04 View session

Copilot AI reviewed Jan 12, 2026

View reviewed changes

vasu-nageshri force-pushed the feat/add_web_support_player_feature branch from 8915752 to 14f26d7 Compare January 12, 2026 09:10

feat: ✨ Add web platform support for audio player

57e662e

vasu-nageshri force-pushed the feat/add_web_support_player_feature branch from 14f26d7 to 57e662e Compare January 12, 2026 09:13

ujas-m-simformsolutions requested changes Jan 12, 2026

View reviewed changes


		import 'package:web/web.dart';

		extension WebConsoleLogger on String {

feat: ✨ Add web platform support for audio player #472

Are you sure you want to change the base?

feat: ✨ Add web platform support for audio player #472

Uh oh!

Conversation

vasu-nageshri commented Jan 12, 2026

Description

Checklist

Breaking Change?

Related Issues

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants