RetryPolicy

const val DEFAULT: RetryPolicy

This retry policy increases initialization success by automatically retrying upon encountering errors.

By default, it continues retrying for a maximum of getDefaultRetryTimeoutInMillis milliseconds. To adjust the timeout duration to specific requirements, utilize RetryPolicy.Builder.

Example: Create a policy based on DEFAULT with a 10-second timeout:

RetryPolicy customTimeoutPolicy =
    new RetryPolicy.Builder(RetryPolicy.DEFAULT).setTimeoutInMillis(10000L).build();

const val NEVER: RetryPolicy

A retry policy that prevents any retry attempts and immediately halts the initialization upon encountering an error.

const val RETRY_UNAVAILABLE_CAMERA: RetryPolicy

This retry policy automatically retries upon encountering errors and specifically designed to handle potential device inconsistencies in reporting available camera instances. If the initial camera configuration fails due to underreporting, the policy automatically attempts reinitialization.

By default, it perseveres for a maximum of getDefaultRetryTimeoutInMillis milliseconds before conceding initialization as unsuccessful. For finer control over the timeout duration, utilize RetryPolicy.Builder.

Example: Create a policy based on RETRY_UNAVAILABLE_CAMERA with a 10-second timeout:

RetryPolicy customTimeoutPolicy = new RetryPolicy.Builder(
    RetryPolicy.RETRY_UNAVAILABLE_CAMERA).setTimeoutInMillis(10000L).build();

java-static fun getDefaultRetryTimeoutInMillis(): Long

Retrieves the default timeout value, in milliseconds, used for initialization retries.

fun getTimeoutInMillis(): Long

Returns the maximum allowed retry duration in milliseconds. Initialization will be terminated if retries take longer than this timeout. A value of 0 indicates no timeout is enforced.

The default value is 0 (no timeout).

fun onRetryDecisionRequested(executionState: RetryPolicy.ExecutionState): RetryPolicy.RetryConfig

Called to request a decision on whether to retry the initialization process.