/*
|
* Copyright (C) 2014 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.app;
|
|
import android.app.Dialog;
|
import android.content.Context;
|
import android.content.DialogInterface;
|
import android.view.ViewGroup;
|
|
import com.android.camera.device.CameraId;
|
import com.android.camera.exif.Rational;
|
import com.android.camera.one.OneCamera.Facing;
|
import com.android.camera.one.OneCameraAccessException;
|
import com.android.camera.one.OneCameraManager;
|
import com.android.camera.settings.Keys;
|
import com.android.camera.settings.ResolutionSetting;
|
import com.android.camera.settings.ResolutionUtil;
|
import com.android.camera.settings.SettingsManager;
|
import com.android.camera.util.ApiHelper;
|
import com.android.camera.widget.AspectRatioDialogLayout;
|
import com.android.camera.widget.LocationDialogLayout;
|
|
/**
|
* The dialog to show when users open the app for the first time.
|
*/
|
public class FirstRunDialog {
|
|
public interface FirstRunDialogListener {
|
public void onFirstRunStateReady();
|
public void onFirstRunDialogCancelled();
|
public void onCameraAccessException();
|
}
|
|
/** The default preference of aspect ratio. */
|
private static final Rational DEFAULT_ASPECT_RATIO = ResolutionUtil.ASPECT_RATIO_4x3;
|
|
/** The default preference of whether enabling location recording. */
|
private static final boolean DEFAULT_LOCATION_RECORDING_ENABLED = true;
|
|
/** Listener to receive events. */
|
private final FirstRunDialogListener mListener;
|
|
/** The app controller. */
|
private final AppController mAppController;
|
|
/** The hardware manager. */
|
private final OneCameraManager mOneCameraManager;
|
|
/** The activity context. */
|
private final Context mContext;
|
|
/** The resolution settings. */
|
private final ResolutionSetting mResolutionSetting;
|
|
/** The settings manager. */
|
private final SettingsManager mSettingsManager;
|
|
/** Aspect ratio preference dialog */
|
private Dialog mAspectRatioPreferenceDialog;
|
|
/** Location preference dialog */
|
private Dialog mLocationPreferenceDialog;
|
|
/**
|
* Constructs a first run dialog.
|
*
|
*/
|
public FirstRunDialog(
|
AppController appController,
|
Context activityContext,
|
ResolutionSetting resolutionSetting,
|
SettingsManager settingManager,
|
OneCameraManager hardwareManager,
|
FirstRunDialogListener listener) {
|
mAppController = appController;
|
mContext = activityContext;
|
mResolutionSetting = resolutionSetting;
|
mSettingsManager = settingManager;
|
mOneCameraManager = hardwareManager;
|
mListener = listener;
|
}
|
|
/**
|
* Shows first run dialogs if necessary.
|
*/
|
public void showIfNecessary() {
|
if (shouldShowLocationDialog()) {
|
// When people open the app for the first time, prompt two dialogs to
|
// ask preferences about location and aspect ratio. The first dialog is
|
// location reference.
|
promptLocationPreferenceDialog();
|
} else if (shouldShowAspectRatioDialog()) {
|
/**
|
* If people already set location preference, prompt aspect ratio dialog.
|
*/
|
promptAspectRatioPreferenceDialog();
|
} else {
|
mListener.onFirstRunStateReady();
|
}
|
}
|
|
/**
|
* Dismiss all shown dialogs.
|
*/
|
public void dismiss() {
|
if (mAspectRatioPreferenceDialog != null) {
|
// Remove the listener since we actively dismiss the dialog.
|
mAspectRatioPreferenceDialog.setOnDismissListener(null);
|
mAspectRatioPreferenceDialog.dismiss();
|
mAspectRatioPreferenceDialog = null;
|
}
|
if (mLocationPreferenceDialog != null) {
|
// Remove the listener since we actively dismiss the dialog.
|
mLocationPreferenceDialog.setOnDismissListener(null);
|
mLocationPreferenceDialog.dismiss();
|
mLocationPreferenceDialog = null;
|
}
|
}
|
|
/**
|
* Whether first run dialogs should be presented to the user.
|
*
|
* @return Whether first run dialogs should be presented to the user.
|
*/
|
private boolean shouldShowLocationDialog() {
|
return !mSettingsManager.isSet(SettingsManager.SCOPE_GLOBAL, Keys.KEY_RECORD_LOCATION);
|
}
|
|
private boolean shouldShowAspectRatioDialog() {
|
return mAppController.getCameraAppUI().shouldShowAspectRatioDialog();
|
}
|
|
/**
|
* Prompts a dialog to allow people to choose aspect ratio preference when
|
* people open the app for the first time. If the preference has been set,
|
* this will return false.
|
*/
|
private void promptAspectRatioPreferenceDialog() {
|
// Create a content view for the dialog.
|
final AspectRatioDialogLayout dialogLayout = new AspectRatioDialogLayout(
|
mContext, DEFAULT_ASPECT_RATIO);
|
dialogLayout.setListener(new AspectRatioDialogLayout.AspectRatioDialogListener() {
|
@Override
|
public void onConfirm(Rational aspectRatio) {
|
// Change resolution setting based on the chosen aspect ratio.
|
try {
|
CameraId backCameraId = mOneCameraManager.findFirstCameraFacing(Facing.BACK);
|
if (backCameraId != null) {
|
mResolutionSetting.setPictureAspectRatio(backCameraId, aspectRatio);
|
}
|
CameraId frontCameraId = mOneCameraManager.findFirstCameraFacing(Facing.FRONT);
|
if (frontCameraId != null) {
|
mResolutionSetting.setPictureAspectRatio(frontCameraId, aspectRatio);
|
}
|
} catch (OneCameraAccessException ex) {
|
mListener.onCameraAccessException();
|
return;
|
}
|
|
// Mark that user has made the choice.
|
mSettingsManager.set(
|
SettingsManager.SCOPE_GLOBAL,
|
Keys.KEY_USER_SELECTED_ASPECT_RATIO,
|
true);
|
|
// Dismiss all dialogs.
|
dismiss();
|
|
// Notify that the app is ready to go.
|
mListener.onFirstRunStateReady();
|
}
|
});
|
|
// Create the dialog.
|
mAspectRatioPreferenceDialog = mAppController.createDialog();
|
mAspectRatioPreferenceDialog.setContentView(dialogLayout, new ViewGroup.LayoutParams(
|
ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
|
// Detect if the dialog is dismissed by back button.
|
mAspectRatioPreferenceDialog.setOnDismissListener(new DialogInterface.OnDismissListener() {
|
@Override
|
public void onDismiss(DialogInterface dialog) {
|
mAspectRatioPreferenceDialog = null;
|
dismiss();
|
mListener.onFirstRunDialogCancelled();
|
}
|
});
|
|
// Show the dialog.
|
mAspectRatioPreferenceDialog.show();
|
}
|
|
/**
|
* Prompts a dialog to allow people to choose location preference when
|
* people open the app for the first time. If the preference has been set,
|
* this will return false.
|
*/
|
private void promptLocationPreferenceDialog() {
|
// Create a content view for the dialog.
|
final LocationDialogLayout dialogLayout = new LocationDialogLayout(
|
mContext, DEFAULT_LOCATION_RECORDING_ENABLED);
|
dialogLayout.setListener(new LocationDialogLayout.LocationDialogListener() {
|
@Override
|
public void onConfirm(boolean locationRecordingEnabled) {
|
// Change the location preference setting.
|
mSettingsManager.set(
|
SettingsManager.SCOPE_GLOBAL,
|
Keys.KEY_RECORD_LOCATION,
|
locationRecordingEnabled);
|
|
if (shouldShowAspectRatioDialog()) {
|
// Prompt the second dialog about aspect ratio preference.
|
promptAspectRatioPreferenceDialog();
|
} else {
|
// Dismiss all dialogs.
|
dismiss();
|
// Notify that the app is ready to go.
|
mListener.onFirstRunStateReady();
|
}
|
}
|
});
|
|
// Create the dialog.
|
mLocationPreferenceDialog = mAppController.createDialog();
|
mLocationPreferenceDialog.setContentView(dialogLayout, new ViewGroup.LayoutParams(
|
ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
|
// Detect if the dialog is dismissed by back button.
|
mLocationPreferenceDialog.setOnDismissListener(new DialogInterface.OnDismissListener() {
|
@Override
|
public void onDismiss(DialogInterface dialog) {
|
mLocationPreferenceDialog = null;
|
dismiss();
|
mListener.onFirstRunDialogCancelled();
|
}
|
});
|
|
// Show the dialog.
|
mLocationPreferenceDialog.show();
|
}
|
}
|
