/*
|
* Copyright (C) 2015 The Android Open Source Project
|
*
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
* you may not use this file except in compliance with the License.
|
* You may obtain a copy of the License at
|
*
|
* http://www.apache.org/licenses/LICENSE-2.0
|
*
|
* Unless required by applicable law or agreed to in writing, software
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
* See the License for the specific language governing permissions and
|
* limitations under the License.
|
*/
|
|
package com.android.camera;
|
|
import android.hardware.camera2.CameraDevice;
|
|
import com.android.camera2.R;
|
|
/**
|
* Handles fatal application errors.
|
* <p>
|
* Usage:
|
*
|
* <pre>
|
* if (unrecoverableErrorDetected) {
|
* fatalErrorHandler.handleFatalError(Reason.CANNOT_CONNECT_TO_CAMERA);
|
* }
|
* </pre>
|
*/
|
public interface FatalErrorHandler {
|
public static enum Reason {
|
CANNOT_CONNECT_TO_CAMERA(
|
R.string.error_cannot_connect_camera,
|
R.string.feedback_description_camera_access,
|
true),
|
CAMERA_HAL_FAILED(
|
R.string.error_cannot_connect_camera,
|
R.string.feedback_description_camera_access,
|
true),
|
CAMERA_DISABLED_BY_SECURITY_POLICY(
|
R.string.error_camera_disabled,
|
R.string.feedback_description_camera_access,
|
true),
|
MEDIA_STORAGE_FAILURE(
|
R.string.error_media_storage_failure,
|
R.string.feedback_description_save_photo,
|
false),
|
CAMERA_VIDEO_QUALITY_FAILURE(
|
R.string.error_cannot_start_recording_failure,
|
R.string.feedback_description_start_recording,
|
false);
|
|
private final int mDialogMsgId;
|
private final int mFeedbackMsgId;
|
private final boolean mFinishActivity;
|
|
/**
|
* @param dialogMsgId The resource ID of string to display in the fatal
|
* error dialog.
|
* @param feedbackMsgId The resource ID of default string to display in
|
* the feedback dialog, if the user chooses to submit
|
* feedback from the dialog.
|
* @param finishActivity Whether the activity should be finished as a
|
* result of this error.
|
*/
|
Reason(int dialogMsgId, int feedbackMsgId, boolean finishActivity) {
|
mDialogMsgId = dialogMsgId;
|
mFeedbackMsgId = feedbackMsgId;
|
mFinishActivity = finishActivity;
|
}
|
|
/**
|
* @return The resource ID of the string to display in the fatal error
|
* dialog.
|
*/
|
public int getFeedbackMsgId() {
|
return mFeedbackMsgId;
|
}
|
|
/**
|
* @return The resource ID of the default string to display in the
|
* feedback dialog, if the user chooses to submit feedback from
|
* the dialog.
|
*/
|
public int getDialogMsgId() {
|
return mDialogMsgId;
|
}
|
|
/**
|
* @return Whether the activity should be finished as a result of this
|
* error.
|
*/
|
public boolean doesFinishActivity() {
|
return mFinishActivity;
|
}
|
|
/**
|
* Creates a new Reason based on an error code for
|
* {@link CameraDevice.StateCallback#onError}.
|
*
|
* @param error The error code. One of
|
* CameraDevice.StateCallback.ERROR_*
|
* @return The appropriate Reason.
|
*/
|
public static Reason fromCamera2CameraDeviceStateCallbackError(int error) {
|
// TODO Use a more descriptive reason to distinguish between
|
// different types of errors.
|
switch (error) {
|
case CameraDevice.StateCallback.ERROR_CAMERA_DEVICE:
|
case CameraDevice.StateCallback.ERROR_CAMERA_DISABLED:
|
case CameraDevice.StateCallback.ERROR_CAMERA_IN_USE:
|
case CameraDevice.StateCallback.ERROR_CAMERA_SERVICE:
|
case CameraDevice.StateCallback.ERROR_MAX_CAMERAS_IN_USE:
|
default:
|
return CANNOT_CONNECT_TO_CAMERA;
|
}
|
}
|
}
|
|
/**
|
* Handles Media Storage Failures - ie. images aren't being saved to disk.
|
*/
|
public void onMediaStorageFailure();
|
|
/**
|
* Handles error where the camera cannot be opened.
|
*/
|
public void onCameraOpenFailure();
|
|
/**
|
* Handles error where the camera cannot be reconnected.
|
*/
|
public void onCameraReconnectFailure();
|
|
/**
|
* Handles generic error where the camera is unavailable. Only use this if
|
* you are unsure what caused the error, such as a reconnection or open.
|
* failure
|
*/
|
public void onGenericCameraAccessFailure();
|
|
/**
|
* Handles error where the camera is disabled due to security.
|
*/
|
public void onCameraDisabledFailure();
|
|
/**
|
* Handles error where the camera is fail start recording.
|
*/
|
public void onRecordingFailure();
|
|
/**
|
* Handles a fatal error, e.g. by displaying the appropriate dialog and
|
* exiting the activity.
|
* @deprecated use specific implementations above instead
|
*/
|
@Deprecated
|
public void handleFatalError(Reason reason);
|
}
|
