Android下TextureView播放视频时无法截取帧截图的问题求助

我之前也遇到过类似的TextureView截图兼容性问题，尤其是三星部分机型的优化导致常规方法失效。你遇到的核心问题是：TextureView的draw()或getBitmap()方法不一定能捕获到Surface上渲染的视频帧——因为视频帧是通过底层OpenGL ES渲染到SurfaceTexture的，而有些厂商（比如三星M系列）对View的绘制流程做了优化，跳过了Surface内容的绘制。

下面给你几个经过验证的可行方案，按推荐优先级排序：

1. 从播放器直接获取帧（最简单，推荐） #

如果你用的是MediaPlayer或ExoPlayer，直接调用播放器的API获取当前帧是最可靠的，完全绕开TextureView的兼容性问题：

针对MediaPlayer #

用MediaMetadataRetriever根据当前播放位置获取帧：

public Bitmap getCurrentVideoFrame(MediaPlayer mediaPlayer) {
    if (mediaPlayer == null || !mediaPlayer.isPlaying()) {
        return null;
    }
    MediaMetadataRetriever retriever = new MediaMetadataRetriever();
    try {
        // 如果是本地文件，也可以直接传入文件路径
        retriever.setDataSource(mediaPlayer.getDataSource());
        long currentPosMs = mediaPlayer.getCurrentPosition();
        // OPTION_CLOSEST_SYNC 确保获取的是最近的同步帧，避免花屏
        return retriever.getFrameAtTime(currentPosMs * 1000, MediaMetadataRetriever.OPTION_CLOSEST_SYNC);
    } catch (Exception e) {
        e.printStackTrace();
        return null;
    } finally {
        retriever.release();
    }
}

注意：如果MediaPlayer的数据源是网络流，getDataSource()可能无法直接调用，这时候可以提前保存视频的URL/路径，直接传给retriever.setDataSource()。

针对ExoPlayer（推荐，API更稳定） #

ExoPlayer 2.18+版本提供了官方的截图API，直接获取当前渲染的视频帧：

public Bitmap getCurrentFrameFromExoPlayer(SimpleExoPlayer player) {
    if (player == null || player.getPlaybackState() != Player.STATE_READY) {
        return null;
    }
    VideoFrame videoFrame = player.getVideoFrame();
    if (videoFrame == null) {
        return null;
    }
    try {
        // 复制Bitmap，避免原帧被释放后失效
        return videoFrame.bitmap.copy(Bitmap.Config.ARGB_8888, false);
    } finally {
        // 必须释放VideoFrame，否则会导致内存泄漏
        videoFrame.release();
    }
}

2. 通过OpenGL读取SurfaceTexture帧（兼容性最强） #

如果无法从播放器获取帧，这个方法是终极解决方案——直接从OpenGL渲染缓冲区读取视频帧，完全不受厂商对TextureView的优化影响：

步骤是初始化EGL环境，绑定SurfaceTexture，然后用glReadPixels读取像素数据：

private EGLContext eglContext;
private EGLDisplay eglDisplay;
private EGLSurface eglSurface;
private TextureView textureView;

// 在TextureView的SurfaceTexture可用时初始化EGL
public void initEglEnvironment(SurfaceTexture surfaceTexture) {
    textureView = findViewById(R.id.your_texture_view);
    // 初始化EGL显示
    eglDisplay = EGL14.eglGetDisplay(EGL14.EGL_DEFAULT_DISPLAY);
    int[] version = new int[2];
    EGL14.eglInitialize(eglDisplay, version, 0, version, 1);

    // 配置EGL参数
    int[] configAttribs = {
            EGL14.EGL_RED_SIZE, 8,
            EGL14.EGL_GREEN_SIZE, 8,
            EGL14.EGL_BLUE_SIZE, 8,
            EGL14.EGL_ALPHA_SIZE, 8,
            EGL14.EGL_RENDERABLE_TYPE, EGL14.EGL_OPENGL_ES2_BIT,
            EGL14.EGL_NONE
    };
    EGLConfig[] configs = new EGLConfig[1];
    int[] numConfigs = new int[1];
    EGL14.eglChooseConfig(eglDisplay, configAttribs, 0, configs, 0, 1, numConfigs, 0);
    EGLConfig config = configs[0];

    // 创建EGL上下文
    int[] contextAttribs = {
            EGL14.EGL_CONTEXT_CLIENT_VERSION, 2,
            EGL14.EGL_NONE
    };
    eglContext = EGL14.eglCreateContext(eglDisplay, config, EGL14.EGL_NO_CONTEXT, contextAttribs, 0);

    // 创建EGL Surface绑定到SurfaceTexture
    int[] surfaceAttribs = {EGL14.EGL_NONE};
    eglSurface = EGL14.eglCreateWindowSurface(eglDisplay, config, surfaceTexture, surfaceAttribs, 0);
    EGL14.eglMakeCurrent(eglDisplay, eglSurface, eglSurface, eglContext);
}

// 截取当前帧
public Bitmap takeTextureViewScreenshot() {
    if (eglDisplay == null || eglSurface == null || textureView.getWidth() == 0) {
        return null;
    }

    int width = textureView.getWidth();
    int height = textureView.getHeight();
    EGL14.eglMakeCurrent(eglDisplay, eglSurface, eglSurface, eglContext);

    // 读取OpenGL缓冲区的像素数据
    ByteBuffer pixelBuffer = ByteBuffer.allocateDirect(width * height * 4);
    pixelBuffer.order(ByteOrder.LITTLE_ENDIAN);
    GLES20.glReadPixels(0, 0, width, height, GLES20.GL_RGBA, GLES20.GL_UNSIGNED_BYTE, pixelBuffer);
    pixelBuffer.rewind();

    // 转换为Bitmap，注意glReadPixels读取的是上下颠倒的，需要翻转
    Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
    bitmap.copyPixelsFromBuffer(pixelBuffer);
    Matrix flipMatrix = new Matrix();
    flipMatrix.postScale(1, -1);
    bitmap = Bitmap.createBitmap(bitmap, 0, 0, width, height, flipMatrix, true);

    return bitmap;
}

// 记得在销毁时释放EGL资源，避免内存泄漏
public void releaseEglEnvironment() {
    if (eglDisplay != null) {
        EGL14.eglMakeCurrent(eglDisplay, EGL14.EGL_NO_SURFACE, EGL14.EGL_NO_SURFACE, EGL14.EGL_NO_CONTEXT);
        if (eglSurface != null) {
            EGL14.eglDestroySurface(eglDisplay, eglSurface);
        }
        if (eglContext != null) {
            EGL14.eglDestroyContext(eglDisplay, eglContext);
        }
        EGL14.eglTerminate(eglDisplay);
    }
    eglDisplay = null;
    eglSurface = null;
    eglContext = null;
}

使用时，在TextureView.SurfaceTextureListener的onSurfaceTextureAvailable回调中调用initEglEnvironment()，在需要截图时调用takeTextureViewScreenshot()，页面销毁时调用releaseEglEnvironment()。

3. 临时排查方案：调整TextureView的LayerType #

有些设备上，TextureView默认的硬件加速层会导致截图失败，可以尝试切换到软件层：

textureView.setLayerType(View.LAYER_TYPE_SOFTWARE, null);

不过这个方法不一定对所有场景有效，只能作为临时排查手段。

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