# ViewfinderSurfaceSession

Artifact: [androidx.camera.viewfinder:viewfinder-core](https://developer.android.com/jetpack/androidx/releases/camera-viewfinder) [View Source](https://cs.android.com/search?q=file:androidx/camera/viewfinder/core/ViewfinderSurfaceSession.kt+class:androidx.camera.viewfinder.core.ViewfinderSurfaceSession) Added in [1.5.0](https://developer.android.com/jetpack/androidx/releases/camera-viewfinder#1.5.0)

*** ** * ** ***


```
interface ViewfinderSurfaceSession : AutoCloseable
```

<br />

*** ** * ** ***

A session of a `https://developer.android.com/reference/android/view/Surface.html` provided by a viewfinder.

The enclosed `https://developer.android.com/reference/android/view/Surface.html` is where pixels can be written by the client to be shown in the viewfinder that created this session. When the client no longer needs to write into the surface, the session must be closed with `https://developer.android.com/reference/java/lang/AutoCloseable.html#close()`. Failure to call `https://developer.android.com/reference/java/lang/AutoCloseable.html#close()` could potentially delay releasing significant resources.

## Summary

| ### Public properties |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/camera/viewfinder/core/ViewfinderSurfaceRequest` | `https://developer.android.com/reference/kotlin/androidx/camera/viewfinder/core/ViewfinderSurfaceSession#request()` The `https://developer.android.com/reference/kotlin/androidx/camera/viewfinder/core/ViewfinderSurfaceRequest` responsible for this session. |
| `https://developer.android.com/reference/android/view/Surface.html` | `https://developer.android.com/reference/kotlin/androidx/camera/viewfinder/core/ViewfinderSurfaceSession#surface()` The `https://developer.android.com/reference/android/view/Surface.html` available for this session. |

| ### Inherited functions |
|---|
| From [java.lang.AutoCloseable](https://developer.android.com/reference/java/lang/AutoCloseable.html) |---|---| | `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/java/lang/AutoCloseable.html#close()()` | |

## Public properties

### request

Added in [1.5.0](https://developer.android.com/jetpack/androidx/releases/camera-viewfinder#1.5.0)

```
val request: ViewfinderSurfaceRequest
```

The `https://developer.android.com/reference/kotlin/androidx/camera/viewfinder/core/ViewfinderSurfaceRequest` responsible for this session.

### surface

Added in [1.5.0](https://developer.android.com/jetpack/androidx/releases/camera-viewfinder#1.5.0)

```
val surface: Surface
```

The `https://developer.android.com/reference/android/view/Surface.html` available for this session. Users of this surface should not call `https://developer.android.com/reference/android/view/Surface.html#release()`, and should close the session with `https://developer.android.com/reference/java/lang/AutoCloseable.html#close()` instead when the surface is no longer in use.