Metadatos de la imagen de la cámara
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
ARCore te permite usar ImageMetadata
para acceder a valores clave de metadatos desde
resultado de la captura de imagen de la cámara. Algunos tipos comunes de metadatos
de imágenes de cámaras
información sobre la longitud focal,
datos de marcas de tiempo de imágenes
información.
El módulo Camera
de Android puede registrar 160 parámetros o más sobre la imagen.
para cada fotograma capturado, según las capacidades de un dispositivo. Para ver una lista de todos
claves de metadatos posibles, consulta ImageMetadata
.
Usa getImageMetadata()
.
para obtener un par clave-valor de metadatos específico y detectar el MetadataNotFoundException
si no está disponible. En el siguiente ejemplo, se muestra cómo obtener el
Valor clave de metadatos SENSOR_EXPOSURE_TIME
.
Java
// Obtain the SENSOR_EXPOSURE_TIME metadata value from the frame.
Long getSensorExposureTime(Frame frame) {
try {
// Can throw NotYetAvailableException when sensors data is not yet available.
ImageMetadata metadata = frame.getImageMetadata();
// Get the exposure time metadata. Throws MetadataNotFoundException if it's not available.
return metadata.getLong(ImageMetadata.SENSOR_EXPOSURE_TIME);
} catch (MetadataNotFoundException | NotYetAvailableException exception) {
return null;
}
}
Kotlin
// Obtain the SENSOR_EXPOSURE_TIME metadata value from the frame.
fun getSensorExposureTime(frame: Frame): Long? {
return runCatching {
// Can throw NotYetAvailableException when sensors data is not yet available.
val metadata = frame.imageMetadata
// Get the exposure time metadata. Throws MetadataNotFoundException if it's not available.
return metadata.getLong(ImageMetadata.SENSOR_EXPOSURE_TIME)
}
.getOrNull()
}
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 2025-07-26 (UTC)"],[[["\u003cp\u003eARCore provides access to camera image metadata like focal length, timestamp, and lighting information using \u003ccode\u003eImageMetadata\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAndroid's \u003ccode\u003eCamera\u003c/code\u003e module can record over 160 image parameters, which can be accessed through the \u003ccode\u003eImageMetadata\u003c/code\u003e class.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can retrieve specific metadata values using \u003ccode\u003egetImageMetadata()\u003c/code\u003e, while handling potential exceptions like \u003ccode\u003eMetadataNotFoundException\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe provided Java and Kotlin code snippets demonstrate how to obtain the \u003ccode\u003eSENSOR_EXPOSURE_TIME\u003c/code\u003e metadata value from a frame.\u003c/p\u003e\n"]]],["ARCore utilizes `ImageMetadata` to access camera image capture metadata, such as focal length, timestamps, and lighting. The Android `Camera` module can record over 160 parameters per frame. To retrieve a specific key value, use `getImageMetadata()`, handling `MetadataNotFoundException`. The example demonstrates fetching the `SENSOR_EXPOSURE_TIME` metadata, using `getLong()` method and handling `NotYetAvailableException` if sensor data is unavailable. Refer to the `ImageMetadata` documentation for the complete list of available keys.\n"],null,["# Camera image metadata\n\nARCore lets you use `ImageMetadata` to access metadata key values from the\ncamera image capture result. Some common types of camera image metadata you\nmight want to access are focal length, image timestamp data, or lighting\ninformation.\n\nThe Android `Camera` module can record 160 or more parameters about the image\nfor each frame captured, depending on a device's capabilities. For a list of all\npossible metadata keys, see [`ImageMetadata`](/ar/reference/java/com/google/ar/core/ImageMetadata).\n\nGet the value of an individual metadata key\n-------------------------------------------\n\nUse [`getImageMetadata()`](/ar/reference/java/com/google/ar/core/Frame#getImageMetadata-)\nto get a specific metadata key value, and catch the [`MetadataNotFoundException`](/ar/reference/java/com/google/ar/core/exceptions/MetadataNotFoundException)\nif it's not available. The following example shows obtaining the\n`SENSOR_EXPOSURE_TIME` metadata key value. \n\n### Java\n\n```java\n// Obtain the SENSOR_EXPOSURE_TIME metadata value from the frame.\nLong getSensorExposureTime(Frame frame) {\n try {\n // Can throw NotYetAvailableException when sensors data is not yet available.\n ImageMetadata metadata = frame.getImageMetadata();\n\n // Get the exposure time metadata. Throws MetadataNotFoundException if it's not available.\n return metadata.getLong(ImageMetadata.SENSOR_EXPOSURE_TIME);\n } catch (MetadataNotFoundException | NotYetAvailableException exception) {\n return null;\n }\n}\n```\n\n### Kotlin\n\n```kotlin\n// Obtain the SENSOR_EXPOSURE_TIME metadata value from the frame.\nfun getSensorExposureTime(frame: Frame): Long? {\n return runCatching {\n // Can throw NotYetAvailableException when sensors data is not yet available.\n val metadata = frame.imageMetadata\n\n // Get the exposure time metadata. Throws MetadataNotFoundException if it's not available.\n return metadata.getLong(ImageMetadata.SENSOR_EXPOSURE_TIME)\n }\n .getOrNull()\n}\n```"]]