ARCore Android SDK v1.45.0

libraries/include/arcore_c_api.h

@@ -1331,6 +1331,15 @@ AR_DEFINE_ENUM(ArFocusMode){/// Focus is fixed.
                             /// Auto-focus is enabled.
                             AR_FOCUS_MODE_AUTO = 1};
 
+/// @ingroup ArConfig
+/// Selects the desired behavior of the camera flash subsystem. See the <a
+/// href="https://developers.google.com/ar/develop/camera/flash/c">documentation
+/// page</a> for more information on using the device's flash.
+AR_DEFINE_ENUM(ArFlashMode){/// Flash is off.
+                            AR_FLASH_MODE_OFF = 0,
+                            /// Flash is on.
+                            AR_FLASH_MODE_TORCH = 2};
+
 /// @ingroup ArConfig
 /// Describes the behavior of the Electronic Image Stabilization (EIS) API. When
 /// enabled, EIS smoothes the camera feed and helps correct video shakes in the
@@ -2504,6 +2513,33 @@ void ArConfig_getFocusMode(const ArSession *session,
                            ArConfig *config,
                            ArFocusMode *focus_mode);
 
+/// @ingroup ArConfig
+/// Gets the current camera flash mode set on this config object.
+///
+/// @param[in]    session          The ARCore session.
+/// @param[in]    config           The configuration object.
+/// @param[inout] out_flash_mode   The current camera flash mode.
+void ArConfig_getFlashMode(const ArSession *session,
+                           const ArConfig *config,
+                           ArFlashMode *out_flash_mode);
+
+/// @ingroup ArConfig
+/// Sets the camera flash mode.
+///
+/// See @c ::ArFlashMode for available options. The default flash
+/// mode is @c #AR_FLASH_MODE_OFF. Note, on devices where camera flash hardware
+/// is not supported, calling this function will do nothing.
+/// See the <a
+/// href="https://developers.google.com/ar/develop/camera/flash/c">documentation
+/// page</a> for more information on how to query device flash capability.
+///
+/// @param[in]   session      The ARCore session.
+/// @param[in]   config       The configuration object.
+/// @param[in]   flash_mode   The desired camera flash mode.
+void ArConfig_setFlashMode(const ArSession *session,
+                           ArConfig *config,
+                           ArFlashMode flash_mode);
+
 /// @ingroup ArConfig
 /// Gets the camera image stabilization mode set on this config
 /// object.
@@ -7675,7 +7711,7 @@ typedef struct ArImageMetadata_const_entry {
   /// The tag identifying the entry.
   uint32_t tag;
   /// The data type of this metadata entry. Determines which data pointer in the
-  /// @c union below is valid.
+  /// @c union below is valid. See @c ACAMERA_TYPE_* enum values in the NDK.
   uint8_t type;
   /// Count of elements (NOT count of bytes) in this metadata entry.
   uint32_t count;
@@ -7728,7 +7764,7 @@ void ArImageMetadata_getAllKeys(const ArSession *session,
 /// Get a metadata entry for the provided @c ::ArImageMetadata and tag.
 ///
 /// The returned @p out_metadata_entry remains valid until the provided @p
-/// image_metadata is released via @c ::ArFrame_acquireImageMetadata.
+/// image_metadata is released via @c ::ArImageMetadata_release.
 ///
 /// @param[in]  session             The ARCore session.
 /// @param[in]  image_metadata      @c ::ArImageMetadata struct obtained from

samples/augmented_faces_java/app/build.gradle

@@ -41,7 +41,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/augmented_faces_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/augmented_image_c/app/build.gradle

@@ -68,8 +68,8 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
-    natives 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
+    natives 'com.google.ar:core:1.45.0'
 
     implementation 'androidx.appcompat:appcompat:1.1.0'
     implementation 'com.google.android.material:material:1.1.0'

samples/augmented_image_java/app/build.gradle

@@ -41,7 +41,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/augmented_image_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/cloud_anchor_java/app/build.gradle

@@ -41,7 +41,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/cloud_anchor_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/computervision_c/app/build.gradle

@@ -68,8 +68,8 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
-    natives 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
+    natives 'com.google.ar:core:1.45.0'
 
     implementation 'androidx.appcompat:appcompat:1.1.0'
     implementation 'com.google.android.material:material:1.1.0'

samples/computervision_java/app/build.gradle

@@ -41,7 +41,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/computervision_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/geospatial_java/app/build.gradle

@@ -41,7 +41,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
     implementation 'com.google.android.gms:play-services-location:19.0.1'
     implementation 'com.google.android.gms:play-services-auth:19.0.0'
 

samples/geospatial_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/hardwarebuffer_c/app/build.gradle

@@ -70,8 +70,8 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
-    natives 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
+    natives 'com.google.ar:core:1.45.0'
 
     implementation 'androidx.appcompat:appcompat:1.1.0'
     implementation 'com.google.android.material:material:1.1.0'

samples/hardwarebuffer_java/app/build.gradle

@@ -66,8 +66,8 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
-    natives 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
+    natives 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/hardwarebuffer_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/hello_ar_c/app/build.gradle

@@ -68,8 +68,8 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
-    natives 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
+    natives 'com.google.ar:core:1.45.0'
 
     implementation 'androidx.appcompat:appcompat:1.1.0'
     implementation 'com.google.android.material:material:1.1.0'

samples/hello_ar_java/app/build.gradle

@@ -41,7 +41,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/hello_ar_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/hello_ar_kotlin/app/build.gradle

@@ -45,7 +45,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/hello_ar_kotlin/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/hello_ar_vulkan_c/app/build.gradle

@@ -69,8 +69,8 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
-    natives 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
+    natives 'com.google.ar:core:1.45.0'
 
     implementation 'androidx.appcompat:appcompat:1.1.0'
     implementation 'com.google.android.material:material:1.1.0'

samples/hello_eis_kotlin/app/build.gradle

@@ -45,7 +45,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/hello_eis_kotlin/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/ml_kotlin/app/build.gradle

@@ -69,7 +69,7 @@ dependencies {
     implementation 'com.google.mlkit:object-detection-custom:16.3.1'
 
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/ml_kotlin/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/persistent_cloud_anchor_java/app/build.gradle

@@ -45,7 +45,7 @@ repositories {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/persistent_cloud_anchor_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/raw_depth_java/app/build.gradle

@@ -42,7 +42,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/raw_depth_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *

samples/recording_playback_java/app/build.gradle

@@ -41,7 +41,7 @@ android {
 
 dependencies {
     // ARCore (Google Play Services for AR) library.
-    implementation 'com.google.ar:core:1.44.0'
+    implementation 'com.google.ar:core:1.45.0'
 
     // Obj - a simple Wavefront OBJ file loader
     // https://github.com/javagl/Obj

samples/recording_playback_java/app/src/main/java/com/google/ar/core/examples/java/common/helpers/SnackbarHelper.java

@@ -92,6 +92,11 @@ public void setMaxLines(int lines) {
     maxLines = lines;
   }
 
+  /** Returns whether the snackbar is currently being shown with an indefinite duration. */
+  public boolean isDurationIndefinite() {
+    return isShowing() && messageSnackbar.getDuration() == Snackbar.LENGTH_INDEFINITE;
+  }
+
   /**
    * Sets the view that will be used to find a suitable parent view to hold the Snackbar view.
    *