1 /* 2 * Copyright (C) 2014 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.camera.app; 18 19 import android.app.Dialog; 20 import android.content.Context; 21 import android.content.DialogInterface; 22 import android.view.ViewGroup; 23 24 import com.android.camera.device.CameraId; 25 import com.android.camera.exif.Rational; 26 import com.android.camera.one.OneCamera.Facing; 27 import com.android.camera.one.OneCameraAccessException; 28 import com.android.camera.one.OneCameraManager; 29 import com.android.camera.settings.Keys; 30 import com.android.camera.settings.ResolutionSetting; 31 import com.android.camera.settings.ResolutionUtil; 32 import com.android.camera.settings.SettingsManager; 33 import com.android.camera.util.ApiHelper; 34 import com.android.camera.widget.AspectRatioDialogLayout; 35 import com.android.camera.widget.LocationDialogLayout; 36 37 /** 38 * The dialog to show when users open the app for the first time. 39 */ 40 public class FirstRunDialog { 41 42 public interface FirstRunDialogListener { 43 public void onFirstRunStateReady(); 44 public void onFirstRunDialogCancelled(); 45 public void onCameraAccessException(); 46 } 47 48 /** The default preference of aspect ratio. */ 49 private static final Rational DEFAULT_ASPECT_RATIO = ResolutionUtil.ASPECT_RATIO_4x3; 50 51 /** The default preference of whether enabling location recording. */ 52 private static final boolean DEFAULT_LOCATION_RECORDING_ENABLED = true; 53 54 /** Listener to receive events. */ 55 private final FirstRunDialogListener mListener; 56 57 /** The app controller. */ 58 private final AppController mAppController; 59 60 /** The hardware manager. */ 61 private final OneCameraManager mOneCameraManager; 62 63 /** The app context. */ 64 private final Context mContext; 65 66 /** The resolution settings. */ 67 private final ResolutionSetting mResolutionSetting; 68 69 /** The settings manager. */ 70 private final SettingsManager mSettingsManager; 71 72 /** Aspect ratio preference dialog */ 73 private Dialog mAspectRatioPreferenceDialog; 74 75 /** Location preference dialog */ 76 private Dialog mLocationPreferenceDialog; 77 78 /** 79 * Constructs a first run dialog. 80 * 81 */ 82 public FirstRunDialog( 83 AppController appController, 84 Context androidContext, 85 ResolutionSetting resolutionSetting, 86 SettingsManager settingManager, 87 OneCameraManager hardwareManager, 88 FirstRunDialogListener listener) { 89 mAppController = appController; 90 mContext = androidContext; 91 mResolutionSetting = resolutionSetting; 92 mSettingsManager = settingManager; 93 mOneCameraManager = hardwareManager; 94 mListener = listener; 95 } 96 97 /** 98 * Shows first run dialogs if necessary. 99 */ 100 public void showIfNecessary() { 101 if (shouldShowLocationDialog()) { 102 // When people open the app for the first time, prompt two dialogs to 103 // ask preferences about location and aspect ratio. The first dialog is 104 // location reference. 105 promptLocationPreferenceDialog(); 106 } else if (shouldShowAspectRatioDialog()) { 107 /** 108 * If people already set location preference, prompt aspect ratio dialog. 109 */ 110 promptAspectRatioPreferenceDialog(); 111 } else { 112 mListener.onFirstRunStateReady(); 113 } 114 } 115 116 /** 117 * Dismiss all shown dialogs. 118 */ 119 public void dismiss() { 120 if (mAspectRatioPreferenceDialog != null) { 121 // Remove the listener since we actively dismiss the dialog. 122 mAspectRatioPreferenceDialog.setOnDismissListener(null); 123 mAspectRatioPreferenceDialog.dismiss(); 124 mAspectRatioPreferenceDialog = null; 125 } 126 if (mLocationPreferenceDialog != null) { 127 // Remove the listener since we actively dismiss the dialog. 128 mLocationPreferenceDialog.setOnDismissListener(null); 129 mLocationPreferenceDialog.dismiss(); 130 mLocationPreferenceDialog = null; 131 } 132 } 133 134 /** 135 * Whether first run dialogs should be presented to the user. 136 * 137 * @return Whether first run dialogs should be presented to the user. 138 */ 139 private boolean shouldShowLocationDialog() { 140 return !mSettingsManager.isSet(SettingsManager.SCOPE_GLOBAL, Keys.KEY_RECORD_LOCATION); 141 } 142 143 private boolean shouldShowAspectRatioDialog() { 144 return mAppController.getCameraAppUI().shouldShowAspectRatioDialog(); 145 } 146 147 /** 148 * Prompts a dialog to allow people to choose aspect ratio preference when 149 * people open the app for the first time. If the preference has been set, 150 * this will return false. 151 */ 152 private void promptAspectRatioPreferenceDialog() { 153 // Create a content view for the dialog. 154 final AspectRatioDialogLayout dialogLayout = new AspectRatioDialogLayout( 155 mContext, DEFAULT_ASPECT_RATIO); 156 dialogLayout.setListener(new AspectRatioDialogLayout.AspectRatioDialogListener() { 157 @Override 158 public void onConfirm(Rational aspectRatio) { 159 // Change resolution setting based on the chosen aspect ratio. 160 try { 161 CameraId backCameraId = mOneCameraManager.findFirstCameraFacing(Facing.BACK); 162 if (backCameraId != null) { 163 mResolutionSetting.setPictureAspectRatio(backCameraId, aspectRatio); 164 } 165 CameraId frontCameraId = mOneCameraManager.findFirstCameraFacing(Facing.FRONT); 166 if (frontCameraId != null) { 167 mResolutionSetting.setPictureAspectRatio(frontCameraId, aspectRatio); 168 } 169 } catch (OneCameraAccessException ex) { 170 mListener.onCameraAccessException(); 171 return; 172 } 173 174 // Mark that user has made the choice. 175 mSettingsManager.set( 176 SettingsManager.SCOPE_GLOBAL, 177 Keys.KEY_USER_SELECTED_ASPECT_RATIO, 178 true); 179 180 // Dismiss all dialogs. 181 dismiss(); 182 183 // Notify that the app is ready to go. 184 mListener.onFirstRunStateReady(); 185 } 186 }); 187 188 // Create the dialog. 189 mAspectRatioPreferenceDialog = mAppController.createDialog(); 190 mAspectRatioPreferenceDialog.setContentView(dialogLayout, new ViewGroup.LayoutParams( 191 ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT)); 192 // Detect if the dialog is dismissed by back button. 193 mAspectRatioPreferenceDialog.setOnDismissListener(new DialogInterface.OnDismissListener() { 194 @Override 195 public void onDismiss(DialogInterface dialog) { 196 mAspectRatioPreferenceDialog = null; 197 dismiss(); 198 mListener.onFirstRunDialogCancelled(); 199 } 200 }); 201 202 // Show the dialog. 203 mAspectRatioPreferenceDialog.show(); 204 } 205 206 /** 207 * Prompts a dialog to allow people to choose location preference when 208 * people open the app for the first time. If the preference has been set, 209 * this will return false. 210 */ 211 private void promptLocationPreferenceDialog() { 212 // Create a content view for the dialog. 213 final LocationDialogLayout dialogLayout = new LocationDialogLayout( 214 mContext, DEFAULT_LOCATION_RECORDING_ENABLED); 215 dialogLayout.setListener(new LocationDialogLayout.LocationDialogListener() { 216 @Override 217 public void onConfirm(boolean locationRecordingEnabled) { 218 // Change the location preference setting. 219 mSettingsManager.set( 220 SettingsManager.SCOPE_GLOBAL, 221 Keys.KEY_RECORD_LOCATION, 222 locationRecordingEnabled); 223 224 if (shouldShowAspectRatioDialog()) { 225 // Prompt the second dialog about aspect ratio preference. 226 promptAspectRatioPreferenceDialog(); 227 } else { 228 // Dismiss all dialogs. 229 dismiss(); 230 // Notify that the app is ready to go. 231 mListener.onFirstRunStateReady(); 232 } 233 } 234 }); 235 236 // Create the dialog. 237 mLocationPreferenceDialog = mAppController.createDialog(); 238 mLocationPreferenceDialog.setContentView(dialogLayout, new ViewGroup.LayoutParams( 239 ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT)); 240 // Detect if the dialog is dismissed by back button. 241 mLocationPreferenceDialog.setOnDismissListener(new DialogInterface.OnDismissListener() { 242 @Override 243 public void onDismiss(DialogInterface dialog) { 244 mLocationPreferenceDialog = null; 245 dismiss(); 246 mListener.onFirstRunDialogCancelled(); 247 } 248 }); 249 250 // Show the dialog. 251 mLocationPreferenceDialog.show(); 252 } 253 } 254
