RecyclerView滚动后YouTubePlayerSupportFragment视频黑屏但音频正常求解决

我之前也碰到过一模一样的问题！当时折腾了好一阵才找到靠谱的解决办法，分享给你参考下～

问题根源 #

这个问题主要是因为RecyclerView的ViewHolder复用机制导致的：当列表项被滚动出屏幕时，ViewHolder会被回收，对应的Fragment视图可能被销毁，但YouTubePlayer的实例还在后台运行（所以音频还能播放）；当列表项重新回到屏幕时，Fragment视图重建，但没有正确和已有的播放器实例绑定，就出现了黑屏的情况。另外，你在onBindViewHolder里每次都重新初始化Fragment，会导致多次初始化，状态进一步混乱。

解决方案 #

1. 避免重复初始化，复用播放器实例

把YouTubePlayer的初始化逻辑移到ViewHolder的构造方法中，只初始化一次，后续绑定数据时直接复用已有的播放器实例：

public class VideoViewHolder extends RecyclerView.ViewHolder {
    YouTubePlayerSupportFragment youTubePlayerFragment;
    YouTubePlayer youTubePlayer;
    String currentVideoId;
    private static final String YOUTUBE_API_KEY = "你的API_KEY";

    public VideoViewHolder(View itemView) {
        super(itemView);
        // 从布局中获取Fragment实例
        youTubePlayerFragment = (YouTubePlayerSupportFragment) ((FragmentActivity) itemView.getContext())
                .getSupportFragmentManager().findFragmentById(R.id.youtube_fragment);
        
        // 只在ViewHolder创建时初始化一次播放器
        youTubePlayerFragment.initialize(YOUTUBE_API_KEY, new YouTubePlayer.OnInitializedListener() {
            @Override
            public void onInitializationSuccess(YouTubePlayer.Provider provider, YouTubePlayer player, boolean wasRestored) {
                youTubePlayer = player;
                // 如果是恢复状态，直接继续播放已保存的视频
                if (wasRestored && currentVideoId != null) {
                    player.play();
                } else if (currentVideoId != null) {
                    player.cueVideo(currentVideoId);
                }
            }

            @Override
            public void onInitializationFailure(YouTubePlayer.Provider provider, YouTubeInitializationResult errorReason) {
                // 这里可以添加初始化失败的处理逻辑，比如显示错误提示
            }
        });
    }

    // 绑定数据时只更新视频，不重新初始化
    public void bind(String videoId) {
        currentVideoId = videoId;
        if (youTubePlayer != null) {
            youTubePlayer.cueVideo(videoId);
            youTubePlayer.play();
        }
    }
}

然后在Adapter的onBindViewHolder里只需要调用holder.bind(videoId)即可：

@Override
public void onBindViewHolder(VideoViewHolder holder, int position) {
    String videoId = yourVideoList.get(position);
    holder.bind(videoId);
}

2. 处理ViewHolder回收，保存/暂停播放器状态

当ViewHolder被回收时，暂停视频播放，避免后台浪费资源，同时也能让下次复用状态更清晰：

@Override
public void onViewRecycled(VideoViewHolder holder) {
    super.onViewRecycled(holder);
    if (holder.youTubePlayer != null) {
        holder.youTubePlayer.pause();
        // 如果你希望彻底释放资源，也可以调用release()，但下次需要重新初始化
        // holder.youTubePlayer.release();
        // holder.youTubePlayer = null;
    }
}

3. 优先使用YouTubePlayerView替代Fragment

Fragment在RecyclerView的复用场景下更容易出现视图状态问题，换成YouTubePlayerView会更可控：

首先修改item布局：

<com.google.android.youtube.player.YouTubePlayerView
    android:id="@+id/youtube_player_view"
    android:layout_width="match_parent"
    android:layout_height="200dp"/>

然后调整ViewHolder：

public class VideoViewHolder extends RecyclerView.ViewHolder implements YouTubePlayer.OnInitializedListener {
    YouTubePlayerView youTubePlayerView;
    YouTubePlayer youTubePlayer;
    String currentVideoId;
    private static final String YOUTUBE_API_KEY = "你的API_KEY";

    public VideoViewHolder(View itemView) {
        super(itemView);
        youTubePlayerView = itemView.findViewById(R.id.youtube_player_view);
        youTubePlayerView.initialize(YOUTUBE_API_KEY, this);
    }

    @Override
    public void onInitializationSuccess(YouTubePlayer.Provider provider, YouTubePlayer player, boolean wasRestored) {
        youTubePlayer = player;
        if (wasRestored && currentVideoId != null) {
            player.play();
        } else if (currentVideoId != null) {
            player.cueVideo(currentVideoId);
        }
    }

    @Override
    public void onInitializationFailure(YouTubePlayer.Provider provider, YouTubeInitializationResult errorReason) {
        // 处理初始化失败
    }

    public void bind(String videoId) {
        currentVideoId = videoId;
        if (youTubePlayer != null) {
            youTubePlayer.cueVideo(videoId);
            youTubePlayer.play();
        }
    }
}

同样在onViewRecycled里暂停播放器，逻辑和之前一致。

额外注意点 #

• 确保你的Activity继承自AppCompatActivity（因为YouTubePlayerSupportFragment需要依赖SupportFragmentManager）
• 不要在列表项中使用match_parent的高度，避免布局冲突导致视图渲染异常
• 测试时注意内存占用，避免因为多个播放器实例导致内存泄漏

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