ViewPager2回滑Fragment仅有声无视频的libVLC播放问题求助

问题原因分析 #

从日志中的can't get Video Surface错误可以明确，核心问题是视频渲染表面（Surface）的绑定生命周期不匹配：

• Fragment被ViewPager2缓存或销毁视图时，MediaPlayer未正确分离旧的Surface；
• 视图重建后（回滑/前台恢复），未重新绑定新的VLCVideoLayout到MediaPlayer；
• 每个Fragment单独创建LibVLC实例、重复初始化MediaPlayer，导致资源冲突和引用丢失。

解决方案 #

1. 全局管理LibVLC与MediaPlayer（用ViewModel避免生命周期问题） #

创建ViewModel统一管理所有MediaPlayer和LibVLC实例，避免Fragment重建时丢失引用或重复创建资源：

public class VideoViewModel extends ViewModel {
    private LibVLC libVlc;
    private MediaPlayer[] mediaPlayers;
    private String[] urls;

    public void init(Context context) {
        if (libVlc != null) return;
        libVlc = new LibVLC(context);
        urls = context.getResources().getStringArray(R.array.urls);
        mediaPlayers = new MediaPlayer[urls.length];
        
        for (int i = 0; i < urls.length; i++) {
            mediaPlayers[i] = new MediaPlayer(libVlc);
            Media media = new Media(libVlc, Uri.parse(urls[i]));
            media.setHWDecoderEnabled(true, false);
            media.addOption(":network-caching=600");
            mediaPlayers[i].setMedia(media);
            media.release();
        }
    }

    public MediaPlayer getMediaPlayer(int pageNumber) {
        return mediaPlayers[pageNumber];
    }

    @Override
    protected void onCleared() {
        super.onCleared();
        if (mediaPlayers != null) {
            for (MediaPlayer player : mediaPlayers) {
                if (player != null) {
                    player.stop();
                    player.release();
                }
            }
        }
        if (libVlc != null) libVlc.release();
    }
}

2. 修正Fragment的生命周期处理 #

在Fragment中绑定ViewModel，并严格在视图生命周期中管理Surface的绑定与分离：

public class PageFragment extends Fragment {
    private VideoViewModel viewModel;
    private int pageNumber;
    private VLCVideoLayout videoLayout;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        viewModel = new ViewModelProvider(requireActivity()).get(VideoViewModel.class);
        viewModel.init(requireContext());
        pageNumber = getArguments() != null ? getArguments().getInt("num") : 1;
    }

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        View result = inflater.inflate(R.layout.fragment_page, container, false);
        
        // 设置标题
        TextView pageHeader = result.findViewById(R.id.displayText);
        pageHeader.setText("Camera " + (pageNumber + 1));
        
        // 获取视频布局并绑定到MediaPlayer
        videoLayout = result.findViewById(R.id.videoLayout);
        viewModel.getMediaPlayer(pageNumber).attachViews(videoLayout, null, false, false);
        
        return result;
    }

    @Override
    public void onResume() {
        super.onResume();
        MediaPlayer player = viewModel.getMediaPlayer(pageNumber);
        // 视图重建后重新绑定Surface
        if (videoLayout != null) {
            player.attachViews(videoLayout, null, false, false);
        }
        if (!player.isPlaying()) {
            player.play();
        }
    }

    @Override
    public void onPause() {
        super.onPause();
        MediaPlayer player = viewModel.getMediaPlayer(pageNumber);
        if (player != null && player.isPlaying()) {
            player.pause();
        }
        // 暂停时分离Surface，避免旧视图引用残留
        player.detachViews();
    }

    @Override
    public void onDestroyView() {
        super.onDestroyView();
        // 视图销毁时必须分离Surface
        viewModel.getMediaPlayer(pageNumber).detachViews();
        videoLayout = null;
    }
}

3. 关键修正点说明 #

• ViewModel全局管理：LibVLC和MediaPlayer实例不再随Fragment销毁而丢失，统一在ViewModel销毁时释放资源；
• Surface绑定时机：在onCreateView和onResume中重新绑定Surface，确保视图重建后MediaPlayer能获取到有效的渲染表面；
• Surface分离时机：在onPause和onDestroyView中分离Surface，避免旧视图被回收后VLC无法获取新Surface；
• 避免重复初始化Media：仅在ViewModel初始化时设置一次Media，避免重复加载导致的资源冲突。

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