Android 媒体播放开发完全指南-EW帮帮网

引言

在当今移动应用生态中，媒体播放功能已成为许多应用的核心组成部分。无论是音乐流媒体应用、视频平台、播客客户端还是游戏应用，都需要强大的媒体播放能力。Android平台提供了丰富的API来支持各种媒体播放场景。本文将全面介绍Android媒体播放的开发技术，从基础到高级功能实现。

一、Android媒体播放基础

1.1 支持的媒体格式

Android原生支持多种媒体格式：

音频：MP3、AAC、FLAC、WAV、OGG等
视频：MP4、3GP、WebM等

可以通过MediaCodec类查询设备具体支持的格式：

MediaCodecList codecList = new MediaCodecList(MediaCodecList.ALL_CODECS);
MediaCodecInfo[] codecInfos = codecList.getCodecInfos();

1.2 核心播放组件

Android提供了几种不同的媒体播放方案：

MediaPlayer：最基础的播放器，适合简单场景
ExoPlayer：Google推荐的现代播放器库，功能强大
Jetpack Media3：最新的媒体播放解决方案

二、使用MediaPlayer实现基础播放

2.1 初始化MediaPlayer


MediaPlayer mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioAttributes(
    new AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_MEDIA)
        .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
        .build()
);

try {
    mediaPlayer.setDataSource(context, Uri.parse("https://example.com/audio.mp3"));
    mediaPlayer.prepareAsync(); // 异步准备防止阻塞UI线程
    
    mediaPlayer.setOnPreparedListener(mp -> {
        mp.start(); // 准备完成后开始播放
    });
} catch (IOException e) {
    e.printStackTrace();
}

2.2 播放控制


// 播放/暂停
if (mediaPlayer.isPlaying()) {
    mediaPlayer.pause();
} else {
    mediaPlayer.start();
}

// 停止播放
mediaPlayer.stop();
mediaPlayer.reset();

// 跳转到指定位置(毫秒)
mediaPlayer.seekTo(positionInMillis);

// 设置循环
mediaPlayer.setLooping(true);

2.3 释放资源


mediaPlayer.release();
mediaPlayer = null;

三、高级播放方案：ExoPlayer

ExoPlayer是Google开源的媒体播放库，相比MediaPlayer具有更多优势：

支持DASH、HLS等自适应流媒体
可扩展性强
定期更新维护

3.1 添加依赖

implementation 'com.google.android.exoplayer:exoplayer:2.19.1'

3.2 基本使用


// 创建播放器实例
SimpleExoPlayer player = new SimpleExoPlayer.Builder(context).build();

// 创建媒体源
MediaItem mediaItem = MediaItem.fromUri("https://example.com/video.mp4");
player.setMediaItem(mediaItem);

// 准备播放器
player.prepare();

// 开始播放
player.play();

3.3 高级功能

自适应比特率流媒体：

// 创建HLS媒体源
HlsMediaSource mediaSource = new HlsMediaSource.Factory(
    new DefaultHttpDataSource.Factory()
).createMediaSource(MediaItem.fromUri(hlsUrl));

自定义渲染器：


RenderersFactory renderersFactory = (handler, videoListener, audioListener, 
    textOutput, metadataOutput) -> {
    return new Renderer[] {
        new MediaCodecVideoRenderer(context, MediaCodecSelector.DEFAULT, handler, videoListener),
        new MediaCodecAudioRenderer(context, MediaCodecSelector.DEFAULT, handler, audioListener)
    };
};

ExoPlayer player = new ExoPlayer.Builder(context, renderersFactory).build();

四、Jetpack Media3

Android Jetpack Media3是最新的媒体播放解决方案，整合了ExoPlayer的优势并提供了更现代化的API。

4.1 主要组件

MediaController：控制播放
MediaSession：管理播放状态
Player：实际播放实现

4.2 基本实现


// 创建播放器
ExoPlayer player = new ExoPlayer.Builder(context).build();

// 创建媒体会话
MediaSession mediaSession = new MediaSession.Builder(context, player)
    .setCallback(new MediaSession.Callback() {
        // 实现回调方法
    })
    .build();

// 创建媒体控制器
ListenableFuture<MediaController> future =
    new MediaController.Builder(context, mediaSession.getToken())
        .buildAsync();

五、后台播放与通知控制

实现后台播放需要：

使用Service保持播放
创建媒体通知
处理音频焦点

5.1 创建播放服务


public class PlaybackService extends Service {
    private MediaSession mediaSession;
    
    @Override
    public void onCreate() {
        super.onCreate();
        
        ExoPlayer player = new ExoPlayer.Builder(this).build();
        mediaSession = new MediaSession.Builder(this, player)
            .setCallback(new MySessionCallback())
            .build();
        
        // 创建通知
        createNotification();
    }
    
    private void createNotification() {
        MediaNotification.Provider provider = 
            new MediaNotification.Provider(R.drawable.ic_notification) {
            // 实现通知提供者
        };
        
        MediaNotificationManager notificationManager = 
            new MediaNotificationManager.Builder(this, 1)
                .setProvider(provider)
                .build();
        
        mediaSession.setNotificationManager(notificationManager);
    }
}

5.2 处理音频焦点


AudioManager audioManager = (AudioManager) context.getSystemService(AUDIO_SERVICE);

AudioAttributes playbackAttributes = new AudioAttributes.Builder()
    .setUsage(AudioAttributes.USAGE_MEDIA)
    .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
    .build();

AudioFocusRequest focusRequest = new AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN)
    .setAudioAttributes(playbackAttributes)
    .setAcceptsDelayedFocusGain(true)
    .setOnAudioFocusChangeListener(focusChangeListener)
    .build();

int result = audioManager.requestAudioFocus(focusRequest);

if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
    // 可以开始播放
}

六、性能优化与最佳实践

缓冲策略：


player.setBufferParameters(new BufferParameters.Builder()
    .setMinBufferMs(15000)
    .setMaxBufferMs(30000)
    .setBufferForPlaybackMs(2500)
    .build());

缓存实现：

Cache cache = new SimpleCache(cacheDir, new NoOpCacheEvictor());
DataSource.Factory cacheDataSourceFactory = new CacheDataSource.Factory()
    .setCache(cache)
    .setUpstreamDataSourceFactory(new DefaultHttpDataSource.Factory());

电池优化：
- 使用WakeLock保持设备唤醒
- 在后台时降低比特率

网络适应：

DefaultTrackSelector trackSelector = new DefaultTrackSelector(context);
trackSelector.setParameters(
    trackSelector.buildUponParameters()
        .setMaxVideoSizeSd()
        .setPreferredAudioLanguage("zh")
);

七、常见问题解决

播放卡顿：
- 检查网络连接
- 降低视频质量
- 增加缓冲区大小
音频焦点冲突：
- 正确处理音频焦点变化
- 实现OnAudioFocusChangeListener
内存泄漏：
- 及时释放播放器资源
- 使用WeakReference持有Context
兼容性问题：
- 检测设备支持的编解码器
- 提供多种格式备用源

结语

Android媒体播放开发涉及多方面知识，从基础的MediaPlayer到强大的ExoPlayer和Media3，开发者可以根据项目需求选择合适的方案。实现一个健壮的播放器不仅需要考虑播放功能本身，还需要处理后台播放、通知控制、音频焦点、性能优化等诸多方面。希望本文能为您在Android媒体播放开发中提供全面的指导。

随着Android平台的不断发展，媒体播放API也在持续演进，建议开发者关注Google官方文档和示例代码，及时了解最新的最佳实践。

Android 媒体播放开发完全指南

引言