Flutter音频播放插件easy_audio_player的使用

音频播放器Flutter插件，提供易于使用的控件来播放远程或本地音频文件，支持所有平台

截图

特性

• 使用简单的控件实现易于使用的音频播放器：
  • MinimalAudioPlayer: 仅用于播放音频，不包含播放和暂停按钮。
  • BasicAudioPlayer: 具有进度条和控制按钮的基本音频播放器。
  • FullAudioPlayer: 包含所有功能（进度条、控制按钮、播放列表、艺术图像）的音频播放器。

开始使用

1. 添加依赖项

在pubspec.yaml文件中添加以下依赖项：

dependencies:
  flutter:
    sdk: flutter
    # 添加此行
  easy_audio_player: {latest_version}

2. 平台设置

Android 设置

在AndroidManifest.xml文件中添加以下权限：

<!-- Just audio background PERMISSIONS -->
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>

<application>
  <!-- 修改MainActivity -->
  <activity android:name="com.ryanheise.audioservice.AudioServiceActivity">
    <!-- 添加 SERVICE元素 -->
    <service android:name="com.ryanheise.audioservice.AudioService">
      <intent-filter>
        <action android:name="android.media.browse.MediaBrowserService" />
      </intent-filter>
    </service>

    <!-- 添加 RECEIVER元素 -->
    <receiver android:name="com.ryanheise.audioservice.MediaButtonReceiver">
      <intent-filter>
        <action android:name="android.intent.action.MEDIA_BUTTON" />
      </intent-filter>
    </receiver>
  </activity>
</application>

iOS 设置

在Info.plist文件中插入以下内容：

<key>UIBackgroundModes</key>
<array>
  <string>audio</string>
</array>

使用方法

1. 初始化背景服务

在应用程序启动时尽早调用initJustAudioBackground方法以初始化后台服务，以便在播放音频时显示通知。

void main() async {
  // 初始化后台服务以显示播放时的通知
  await initJustAudioBackground(NotificationSettings(androidNotificationChannelId: 'com.example.example'));
  runApp(MaterialApp(
    home: HomeScreen(),
  ));
}

2. 加载音频文件

创建一个包含音频源的ConcatenatingAudioSource对象。

final ConcatenatingAudioSource _playlist = ConcatenatingAudioSource(children: [
  AudioSource.uri(
    Uri.parse('https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3'),
    tag: MediaItem(
      id: '1',
      artUri: Uri.parse('https://picsum.photos/300/300'),
      title: 'Audio Title',
      album: 'amazing album'
    )
  )
]);

3. 调用播放器控件

使用加载的音频播放器控件，并传递播放列表和选项。

return Scaffold(
  body: SafeArea(
    child: Padding(
      padding: const EdgeInsets.all(20.0),
      child: Center(
        child: BasicAudioPlayer(playlist: _playlist),
      ),
    ),
  ),
);

完整示例代码

import 'package:easy_audio_player/helpers/init_just_audio_background.dart';
import 'package:easy_audio_player/models/models.dart';
import 'package:easy_audio_player/widgets/players/basic_audio_player.dart';
import 'package:flutter/material.dart';
import 'package:just_audio/just_audio.dart';
import 'package:audio_service/audio_service.dart';

void main() async {
  // 初始化后台服务以显示播放时的通知
  await initJustAudioBackground(NotificationSettings(androidNotificationChannelId: 'com.example.example'));
  runApp(MaterialApp(
    home: HomeScreen(),
  ));
}

class HomeScreen extends StatelessWidget {
  HomeScreen({Key? key}) : super(key: key);
  static const routeName = '/';

  final ConcatenatingAudioSource _playlist = ConcatenatingAudioSource(children: [
    AudioSource.uri(
      Uri.parse('https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3'),
      tag: MediaItem(
        id: '1',
        artUri: Uri.parse('https://picsum.photos/300/300'),
        title: 'Audio Title',
        album: 'amazing album'
      )
    )
  ]);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: SafeArea(
        child: Padding(
          padding: const EdgeInsets.all(20.0),
          child: Center(
            child: BasicAudioPlayer(playlist: _playlist),
          ),
        ),
      ),
    );
  }
}