1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
/*
* 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);
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 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);
}
|
