Android Studio中S3音频URL流式播放崩溃问题及解决方法

崩溃原因分析 #

你的代码使用普通URL正常，但替换为S3 URL后崩溃，大概率是以下问题导致：

• S3文件默认私有，直接访问返回403错误，MediaPlayer无法处理该异常
• URL包含特殊字符（如括号(PaglaSongs)），未编码导致解析失败
• 同步调用prepare()阻塞主线程，引发ANR或崩溃

分步解决 #

1. 确保S3音频文件可访问 #

• 测试用公开权限：在AWS S3控制台找到目标音频文件，修改权限为「公开可读」（不推荐生产环境使用）。
• 生产用预签名URL：使用AWS SDK生成带有效期的预签名URL，即使文件私有也能临时访问。示例代码（需引入AWS S3 SDK）：

AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
        .withRegion(Regions.AP_SOUTH_1)
        .build();
GeneratePresignedUrlRequest request = new GeneratePresignedUrlRequest("testing-ariya", "Faded_320(PaglaSongs).mp3")
        .withMethod(HttpMethod.GET)
        .withExpiration(new Date(System.currentTimeMillis() + 3600000)); // 有效期1小时
URL presignedUrl = s3Client.generatePresignedUrl(request);
String encodedUrl = Uri.parse(presignedUrl.toString()).toString();

2. 处理URL特殊字符 #

原URL中的括号属于URL特殊字符，需编码后再传入MediaPlayer，可通过Uri.parse()自动完成编码：

String rawS3Url = "https://testing-ariya.s3.ap-south1.amazonaws.com/Faded_320(PaglaSongs).mp3";
String encodedUrl = Uri.parse(rawS3Url).toString();

3. 优化MediaPlayer初始化逻辑 #

流式播放必须使用异步准备方法prepareAsync()，避免阻塞主线程，同时设置监听器处理准备完成和错误事件：

private void prepareMediaPlayer(){
    try{
        // 初始化或重置MediaPlayer状态
        if (mediaPlayer == null) {
            mediaPlayer = new MediaPlayer();
            mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
        } else {
            mediaPlayer.reset();
        }

        String rawS3Url = "https://testing-ariya.s3.ap-south1.amazonaws.com/Faded_320(PaglaSongs).mp3";
        String encodedUrl = Uri.parse(rawS3Url).toString();
        
        // 使用带Context的setDataSource方法，稳定性更高
        mediaPlayer.setDataSource(this, Uri.parse(encodedUrl));

        // 准备完成监听器
        mediaPlayer.setOnPreparedListener(new MediaPlayer.OnPreparedListener() {
            @Override
            public void onPrepared(MediaPlayer mp) {
                textTotalDuration.setText(milisecToTimer(mp.getDuration()));
                // 可选：自动开始播放
                // mp.start();
            }
        });

        // 错误监听器，方便排查问题
        mediaPlayer.setOnErrorListener(new MediaPlayer.OnErrorListener() {
            @Override
            public boolean onError(MediaPlayer mp, int what, int extra) {
                Toast.makeText(MainActivity.this, "播放错误: 错误码" + what + ", 额外信息" + extra, Toast.LENGTH_SHORT).show();
                return true;
            }
        });

        // 异步准备，避免主线程阻塞
        mediaPlayer.prepareAsync();

    }catch (Exception e){
        Toast.makeText(this, e.getMessage(), Toast.LENGTH_SHORT).show();
        e.printStackTrace(); // 打印堆栈到Logcat，方便定位深层问题
    }
}

4. 确认必要权限和配置 #

• 在AndroidManifest.xml中添加网络权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

• Android 9及以上版本，若遇到HTTPS证书异常，可添加网络安全配置：
  在res/xml/network_security_config.xml中添加：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="false">
        <domain includeSubdomains="true">testing-ariya.s3.ap-south1.amazonaws.com</domain>
    </domain-config>
</network-security-config>

然后在AndroidManifest.xml的application标签中引用：

android:networkSecurityConfig="@xml/network_security_config"

内容的提问来源于stack exchange，提问作者Jnananidhi