Android - TextureView 介绍

封面图 • 2025-10-21 • Android开发

在 Android 开发中，`TextureView` 是一个用于显示视频、相机预览或其他图形内容的视图组件。它与 `SurfaceView` 类似，但有一些重要的区别和优势。

---

## 一、TextureView 简介

`TextureView` 是 Android 提供的一个视图（`View`），可以将图像或视频渲染到屏幕上。它支持通过 OpenGL ES 或其他图形 API 进行渲染，并且可以与其他 Android UI 组件进行交互（如动画、变换等）。

### 优点：

- **支持动画和变换**：可以像普通 View 一样应用旋转、缩放、透明度等动画。
- **兼容性好**：在 Android 3.0（API 11）及以上版本可用。
- **易于集成**：可以通过 Java/Kotlin 代码直接操作，不需要使用 SurfaceHolder 回调。
- **支持硬件加速**：性能优于某些旧的实现方式。

---

## 二、TextureView 的主要用途

- 显示摄像头预览
- 播放视频（例如通过 MediaCodec）
- 渲染 OpenGL 内容（如游戏、3D 图形）
- 实现自定义的图形处理（如滤镜、图像处理）

---

## 三、TextureView 的基本用法

### 1. 布局文件中添加 TextureView

```xml
<androidx.core.widget.ContentLoadingProgressBar
    android:id="@+id/textureView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />
```

> 注意：`TextureView` 应该放在 `FrameLayout` 或类似的布局中，以确保其正确渲染。

---

### 2. 在 Activity 或 Fragment 中使用 TextureView

#### 示例：设置一个简单的纹理

```kotlin
val textureView = findViewById<TextureView>(R.id.textureView)

// 设置一个 Bitmap 作为纹理
val bitmap = BitmapFactory.decodeResource(resources, R.drawable.example)
textureView.surfaceTextureListener = object : TextureView.SurfaceTextureListener {
    override fun onSurfaceTextureAvailable(surface: SurfaceTexture, width: Int, height: Int) {
        val surface = Surface(surface)
        // 使用 Surface 来绘制内容
        // 例如：使用 Canvas 或者 MediaCodec
    }

override fun onSurfaceTextureSizeChanged(surface: SurfaceTexture, width: Int, height: Int) {
        // 当纹理大小变化时调用
    }

override fun onSurfaceTextureUpdated(surface: SurfaceTexture) {
        // 当纹理更新时调用
    }

override fun onSurfaceTextureDestroyed(surface: SurfaceTexture): Boolean {
        // 当纹理被销毁时调用
        return true
    }
}
```

---

## 四、TextureView 与 SurfaceView 的对比

| 特性 | TextureView | SurfaceView |
|------|-------------|-------------|
| 动画支持 | ✅ 支持 | ❌ 不支持 |
| 变换支持 | ✅ 支持 | ❌ 不支持 |
| 兼容性 | Android 3.0+ | Android 2.3+ |
| 硬件加速 | ✅ 支持 | ✅ 支持 |
| 复杂图形处理 | ✅ 更灵活 | ❌ 较少 |
| 与 UI 交互 | ✅ 更好 | ❌ 差 |

---

## 五、常见应用场景

- **相机预览**：使用 CameraX 或 Camera2 API 将摄像头画面输出到 `TextureView`。
- **视频播放器**：结合 `MediaPlayer` 或 `ExoPlayer`，将视频帧渲染到 `TextureView`。
- **OpenGL 渲染**：通过 `GLSurfaceView` 或 `TextureView` 结合 OpenGL ES 实现 3D 渲染。
- **AR/VR 应用**：用于实时图像处理和渲染。

---

## 六、注意事项

- `TextureView` 需要通过 `SurfaceTextureListener` 来监听其生命周期事件（如 `onSurfaceTextureAvailable`）。
- 如果你需要高性能的视频播放，建议使用 `ExoPlayer` 或 `MediaPlayer`，它们通常比直接操作 `TextureView` 更高效。
- 在低版本 Android 上可能不支持 `TextureView`，需要考虑兼容性问题。

---

## 七、示例：使用 CameraX 显示摄像头预览到 TextureView

```kotlin
val cameraProviderFuture = ProcessCameraProvider.getInstance(context)

cameraProviderFuture.addListener({
    val preview = Preview.Builder().build().also {
        it.setSurfaceProvider(textureView.surfaceProvider)
    }

val cameraProvider = cameraProviderFuture.get()
    cameraProvider.bindToLifecycle(this, CameraSelector.DEFAULT_BACK_CAMERA, preview)
}, ContextCompat.getMainExecutor(context))
```

---

## 总结

`TextureView` 是一个功能强大且灵活的 Android 视图，适用于需要将图形内容渲染到屏幕上的场景。相比 `SurfaceView`，它提供了更好的 UI 交互能力，是现代 Android 开发中推荐使用的组件之一。

如果你有具体的使用场景（比如摄像头、视频、OpenGL 等），我可以提供更详细的代码示例。