如何在 Android 中正确从独立类调用 MediaPlayer 播放音频

本文详解为何 `mediaplayer.create()` 报 `nullpointerexception`，核心原因是 `context` 未正确传入自定义类；通过修复构造函数、确保上下文可用，并规范资源调用方式，即可安全复用音频播放逻辑。

在 Android 开发中，将媒体播放逻辑封装到独立工具类（如 Sounds）是良好实践，但必须严格保障 Context 的有效性——因为 MediaPlayer.create() 等资源加载方法依赖 Context 获取 Resources 和 AssetManager。你遇到的崩溃：

Caused by: java.lang.NullPointerException: 
Attempt to invoke virtual method 'android.content.res.Resources android.content.Context.getResources()' 
on a null object reference

明确指出：context 为 null，导致 MediaPlayer.create() 内部调用 context.getResources() 失败。

? 根本原因分析

你的原始代码中：

public void Sound(Context context) {
    this.context = context;
}

这是一个普通成员方法（返回类型为 void，名称非类名），并非构造函数！因此当你执行：

Sounds s = new Sounds(); // 调用的是系统默认无参构造函数
s.hydrogen();             // 此时 this.context 仍为 null

context 始终未被初始化，造成空指针。

神器集

发现最酷的互联网产品工具和智能神器

下载

✅ 正确解决方案：使用显式构造函数注入 Context

修改 Sounds 类，定义公有构造函数并强制传入 Context：

import android.content.Context;
import android.media.MediaPlayer;

public class Sounds {

    private final Context context; // 建议用 final 保证不可变性

    // ✅ 正确的构造函数：名称与类名完全一致，无返回类型
    public Sounds(Context context) {
        if (context == null) {
            throw new IllegalArgumentException("Context must not be null");
        }
        this.context = context.getApplicationContext(); // 推荐使用 ApplicationContext 防止内存泄漏
    }

    // ✅ 公开方法，便于外部调用
    public void hydrogen() {
        // 注意：create() 可能返回 null（如资源不存在或格式不支持），务必判空
        MediaPlayer mp = MediaPlayer.create(context, R.raw.hydrogen);
        if (mp != null) {
            mp.start();
            // ⚠️ 提示：实际项目中建议调用 mp.setOnCompletionListener() 并在完成后 release()
            // mp.setOnCompletionListener(mediaPlayer -> mediaPlayer.release());
        } else {
            android.util.Log.e("Sounds", "Failed to create MediaPlayer for R.raw.hydrogen");
        }
    }
}

? 在 Activity 中正确调用

在 MainActivity 的点击回调中，传入有效的 Activity 或 Application 上下文：

public void onClick(View view) {
    // ✅ 使用 this（即当前 Activity 实例）作为 Context
    Sounds sounds = new Sounds(this);
    sounds.hydrogen();
}

? 为什么推荐 context.getApplicationContext()？ 直接持有 Activity 引用可能导致内存泄漏（尤其当 Sounds 实例生命周期长于 Activity）。使用 getApplicationContext() 可避免此风险，且对资源访问完全足够。

? 重要注意事项

• 资源 ID 必须存在且路径正确：确认 res/raw/hydrogen.mp3（或 .wav 等支持格式）已添加，且 R.raw.hydrogen 编译无误。
• 不要在子线程中直接调用 MediaPlayer.create()：该方法需在主线程执行（它会访问 Resources，而 Resources 不是线程安全的）。
• 及时释放资源：MediaPlayer 占用系统音频硬件，长期持有易引发 IllegalStateException。建议：
  • 播放完后调用 mp.release()；
  • 或使用 try-with-resources（Android API 29+）；
  • 更健壮方案：结合 SoundPool（适合短音效）或 ExoPlayer（适合复杂场景）。

✅ 总结

遵循以上规范，你就能安全、可维护地将音频逻辑抽离至独立类，彻底告别 NullPointerException。