如何在Android Fragment中结合SurfaceView使用MediaPlayer播放视频

嗨，刚好我之前也做过类似的需求——为了灵活控制MediaPlayer实例，放弃VideoView改用SurfaceView在Fragment中播放视频。结合你提到的旧问题思路，我整理了一套完整的实现步骤，你可以参考下：

一、先准备Fragment的布局文件 #

首先在Fragment的布局里添加SurfaceView，记得给它设置id，方便后续代码中获取：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <SurfaceView
        android:id="@+id/surface_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

    <!-- 你可以在这里添加播放控制按钮等其他视图 -->
</RelativeLayout>

二、Fragment中的核心代码实现 #

接下来是Fragment的Java代码，重点是处理SurfaceView的生命周期回调，以及和MediaPlayer的关联：

1. 初始化关键对象 #

在Fragment中声明SurfaceView、SurfaceHolder和需要传递的MediaPlayer实例：

public class VideoPlayerFragment extends Fragment {
    private SurfaceView mSurfaceView;
    private SurfaceHolder mSurfaceHolder;
    private MediaPlayer mMediaPlayer; // 外部传递进来的MediaPlayer实例

    // 提供方法接收外部传递的MediaPlayer
    public void setMediaPlayer(MediaPlayer mediaPlayer) {
        this.mMediaPlayer = mediaPlayer;
    }

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_video_player, container, false);
        mSurfaceView = view.findViewById(R.id.surface_view);
        
        // 设置窗口格式，避免播放时出现黑块
        if (getActivity() != null) {
            getActivity().getWindow().setFormat(PixelFormat.UNKNOWN);
        }

        // 获取SurfaceHolder并设置回调
        mSurfaceHolder = mSurfaceView.getHolder();
        mSurfaceHolder.addCallback(new SurfaceHolder.Callback() {
            @Override
            public void surfaceCreated(SurfaceHolder holder) {
                // Surface创建完成后，给MediaPlayer设置Surface
                if (mMediaPlayer != null) {
                    mMediaPlayer.setDisplay(holder);
                }
            }

            @Override
            public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {
                // Surface尺寸变化时，可以调整MediaPlayer的显示比例
                if (mMediaPlayer != null) {
                    // 这里可以根据需要设置视频的缩放模式，比如保持比例
                    mMediaPlayer.setVideoScalingMode(MediaPlayer.VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING);
                }
            }

            @Override
            public void surfaceDestroyed(SurfaceHolder holder) {
                // Surface销毁时，暂停播放并移除Surface引用，避免内存泄漏
                if (mMediaPlayer != null) {
                    mMediaPlayer.setDisplay(null);
                    if (mMediaPlayer.isPlaying()) {
                        mMediaPlayer.pause();
                    }
                }
            }
        });

        return view;
    }

    // 记得在Fragment生命周期中管理MediaPlayer
    @Override
    public void onDestroyView() {
        super.onDestroyView();
        // 如果不需要保留MediaPlayer实例，这里可以选择释放（根据你的业务需求）
        // 注意：如果MediaPlayer是外部传递的，释放操作最好交给外部管理，避免重复释放
        if (mMediaPlayer != null) {
            mMediaPlayer.setDisplay(null);
        }
    }
}

2. 外部传递MediaPlayer实例的方式 #

你可以在创建Fragment后，通过setMediaPlayer方法把已经初始化好的MediaPlayer传进去：

// 比如在Activity中创建Fragment并传递MediaPlayer
VideoPlayerFragment fragment = new VideoPlayerFragment();
MediaPlayer mediaPlayer = new MediaPlayer();
// 这里先初始化MediaPlayer，比如设置数据源、准备等操作
try {
    mediaPlayer.setDataSource("你的视频地址");
    mediaPlayer.prepareAsync();
} catch (IOException e) {
    e.printStackTrace();
}
fragment.setMediaPlayer(mediaPlayer);

// 然后把Fragment添加到容器中
getSupportFragmentManager().beginTransaction()
        .replace(R.id.fragment_container, fragment)
        .commit();

三、注意事项 #

• Surface的异步特性：一定要等surfaceCreated回调触发后，再给MediaPlayer设置Surface，否则会出现无法播放的问题。
• 生命周期管理：在Fragment的onDestroyView或者onDestroy中，记得移除MediaPlayer和Surface的关联，避免内存泄漏或者崩溃。
• MediaPlayer的控制权：因为MediaPlayer是外部传递的，播放、暂停、释放等操作最好统一由外部管理，或者在Fragment中提供对应的方法调用，保持逻辑一致。

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