From aa67114d6bdc97fb158279004dca9055162d07c6 Mon Sep 17 00:00:00 2001 From: admin <2011164925@qq.com> Date: Thu, 18 May 2023 16:33:02 +0800 Subject: [PATCH] =?UTF-8?q?[=E6=B3=A8=E9=87=8A=E4=B8=80]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../micode/notes/ui/AlarmAlertActivity.java | 62 ++++++------ .../micode/notes/ui/AlarmInitReceiver.java | 28 +++--- .../net/micode/notes/ui/AlarmReceiver.java | 4 +- .../net/micode/notes/ui/DateTimePicker.java | 97 ++++++++++++------- 4 files changed, 113 insertions(+), 78 deletions(-) diff --git a/app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java b/app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java index e7a4cb1..cd1b87f 100644 --- a/app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java +++ b/app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java @@ -121,40 +121,44 @@ private boolean isScreenOn() {// 检测屏幕是否点亮 } } - private void showActionDialog() { +// 显示提醒菜单Dialog，包括Note的文本信息、确认键和选择键(如果屏幕是点亮的) +private void showActionDialog() { AlertDialog.Builder dialog = new AlertDialog.Builder(this); - dialog.setTitle(R.string.app_name); - dialog.setMessage(mSnippet); - dialog.setPositiveButton(R.string.notealert_ok, this); - if (isScreenOn()) { - dialog.setNegativeButton(R.string.notealert_enter, this); + dialog.setTitle(R.string.app_name); // 设置Dialog的标题为应用名称 + dialog.setMessage(mSnippet); // 设置Dialog的信息为Note的文本信息 + dialog.setPositiveButton(R.string.notealert_ok, this); // 设置确认键，点击后执行onClick()方法 + if (isScreenOn()) { // 如果屏幕是点亮的，设置选择键 “进入笔记”， 点击后执行onClick()方法 + dialog.setNegativeButton(R.string.notealert_enter, this); + } + dialog.show().setOnDismissListener(this); // 显示Dialog，并设置当Dialog消失时的监听器 } - dialog.show().setOnDismissListener(this); - } - public void onClick(DialogInterface dialog, int which) { +// Dialog按键点击响应函数, which为点击的按键的序号 +public void onClick(DialogInterface dialog, int which) { switch (which) { - case DialogInterface.BUTTON_NEGATIVE: - Intent intent = new Intent(this, NoteEditActivity.class); - intent.setAction(Intent.ACTION_VIEW); - intent.putExtra(Intent.EXTRA_UID, mNoteId); - startActivity(intent); - break; - default: - break; + case DialogInterface.BUTTON_NEGATIVE: // 如果按下了选择键”进入笔记“ + Intent intent = new Intent(this, NoteEditActivity.class); + intent.setAction(Intent.ACTION_VIEW); + intent.putExtra(Intent.EXTRA_UID, mNoteId); + startActivity(intent); // 打开Note编辑界面 + break; +default: + break; + } } - } - public void onDismiss(DialogInterface dialog) { - stopAlarmSound(); - finish(); - } +// 监听Dialog消失的响应函数 +public void onDismiss(DialogInterface dialog) { + stopAlarmSound(); // 停止播放闹钟声音 + finish(); // 结束Activity + } - private void stopAlarmSound() { - if (mPlayer != null) { - mPlayer.stop(); - mPlayer.release(); - mPlayer = null; +// 停止播放闹钟声音 +private void stopAlarmSound() { + if (mPlayer != null) { // 如果播放器存在 + mPlayer.stop(); // 停止播放 + mPlayer.release(); // 释放播放器占用的资源 + mPlayer = null; // 将播放器设为空 } - } -} + } + diff --git a/app/src/main/java/net/micode/notes/ui/AlarmInitReceiver.java b/app/src/main/java/net/micode/notes/ui/AlarmInitReceiver.java index f221202..6352d50 100644 --- a/app/src/main/java/net/micode/notes/ui/AlarmInitReceiver.java +++ b/app/src/main/java/net/micode/notes/ui/AlarmInitReceiver.java @@ -28,38 +28,36 @@ import net.micode.notes.data.Notes; import net.micode.notes.data.Notes.NoteColumns; +// 定义接收闹钟初始化的广播接收器 public class AlarmInitReceiver extends BroadcastReceiver { - private static final String [] PROJECTION = new String [] { - NoteColumns.ID, - NoteColumns.ALERTED_DATE - }; - - private static final int COLUMN_ID = 0; - private static final int COLUMN_ALERTED_DATE = 1; - + // 查询提醒时间比当前时间更晚的Note记录，并将它们转为闹钟事件 @Override public void onReceive(Context context, Intent intent) { + // 获取当前时间 long currentDate = System.currentTimeMillis(); + // 查询所有提醒时间晚于当前时间的Note记录 Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI, PROJECTION, - NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE, - new String[] { String.valueOf(currentDate) }, + NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE, // 查询条件，提醒时间比当前时间更晚且类型为Note + new String[] { String.valueOf(currentDate) }, // 查询参数，当前时间 null); + // 对查询结果进行遍历转换 if (c != null) { if (c.moveToFirst()) { do { + // 获取提醒时间和Note的ID，以创建相应的PendingIntent long alertDate = c.getLong(COLUMN_ALERTED_DATE); Intent sender = new Intent(context, AlarmReceiver.class); sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID))); PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0); - AlarmManager alermManager = (AlarmManager) context - .getSystemService(Context.ALARM_SERVICE); - alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent); + // 将提醒时间设置为对应的闹钟时间，并创建相应的闹钟事件 + AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE); + alarmManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent); } while (c.moveToNext()); } - c.close(); + c.close(); // 关闭游标 } } -} +} \ No newline at end of file diff --git a/app/src/main/java/net/micode/notes/ui/AlarmReceiver.java b/app/src/main/java/net/micode/notes/ui/AlarmReceiver.java index 54e503b..833682a 100644 --- a/app/src/main/java/net/micode/notes/ui/AlarmReceiver.java +++ b/app/src/main/java/net/micode/notes/ui/AlarmReceiver.java @@ -21,10 +21,12 @@ import android.content.Context; import android.content.Intent; public class AlarmReceiver extends BroadcastReceiver { - @Override + // 监听AlarmManager的闹钟事件，接收到事件后启动提醒界面 public void onReceive(Context context, Intent intent) { + // 指定启动的Activity为AlarmAlertActivity，并添加NEW_TASK标志，使其在新的任务栈上启动 intent.setClass(context, AlarmAlertActivity.class); intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); + // 启动指定Activity context.startActivity(intent); } } diff --git a/app/src/main/java/net/micode/notes/ui/DateTimePicker.java b/app/src/main/java/net/micode/notes/ui/DateTimePicker.java index 496b0cd..9f2ef0f 100644 --- a/app/src/main/java/net/micode/notes/ui/DateTimePicker.java +++ b/app/src/main/java/net/micode/notes/ui/DateTimePicker.java @@ -30,6 +30,7 @@ import android.widget.NumberPicker; public class DateTimePicker extends FrameLayout { + // 定义一些常量，包括默认开启状态、半天和一天的小时数、一周的天数、各个数字选择器的取值范围等 private static final boolean DEFAULT_ENABLE_STATE = true; private static final int HOURS_IN_HALF_DAY = 12; @@ -46,29 +47,34 @@ public class DateTimePicker extends FrameLayout { private static final int AMPM_SPINNER_MIN_VAL = 0; private static final int AMPM_SPINNER_MAX_VAL = 1; - private final NumberPicker mDateSpinner; - private final NumberPicker mHourSpinner; - private final NumberPicker mMinuteSpinner; - private final NumberPicker mAmPmSpinner; - private Calendar mDate; + private final NumberPicker mDateSpinner; // 日期选择器 + private final NumberPicker mHourSpinner; // 小时选择器 + private final NumberPicker mMinuteSpinner; // 分钟选择器 + private final NumberPicker mAmPmSpinner; // 上午/下午选择器 + private Calendar mDate; // 日期对象 - private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; + private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; // 显示的日期字符串 - private boolean mIsAm; + private boolean mIsAm; // 当前是上午还是下午 - private boolean mIs24HourView; + private boolean mIs24HourView; // 是否以24小时制显示时间 - private boolean mIsEnabled = DEFAULT_ENABLE_STATE; + private boolean mIsEnabled = DEFAULT_ENABLE_STATE; // 当前是否处于开启状态 - private boolean mInitialising; + private boolean mInitialising; // 是否正在初始化 - private OnDateTimeChangedListener mOnDateTimeChangedListener; + private OnDateTimeChangedListener mOnDateTimeChangedListener; // 日期时间变化监听器 + // 定义一个日期选择监听器，用于在用户调整日期选择器后更新日期值，并回调日期时间变化监听器 private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() { + // 当日期选择器的值改变时，更新日历的日期，更新日期显示，触发日期时间变化监听器 @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 计算日期变化的天数，并更新日历对象 mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal); + // 更新日期选择器显示的日期 updateDateControl(); + // 通知监听器选择的日期时间发生变化 onDateTimeChanged(); } }; @@ -115,52 +121,77 @@ public class DateTimePicker extends FrameLayout { } }; - private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() { + // 定义一个小时选择监听器，用于在用户调整小时选择器后更新日期时间值，并回调日期时间变化监听器 + private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() { + // 当小时选择器的值发生改变时，更新日期时间对象，并触发日期时间变化监听器 @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { - int minValue = mMinuteSpinner.getMinValue(); - int maxValue = mMinuteSpinner.getMaxValue(); - int offset = 0; - if (oldVal == maxValue && newVal == minValue) { - offset += 1; - } else if (oldVal == minValue && newVal == maxValue) { - offset -= 1; - } - if (offset != 0) { - mDate.add(Calendar.HOUR_OF_DAY, offset); - mHourSpinner.setValue(getCurrentHour()); - updateDateControl(); - int newHour = getCurrentHourOfDay(); - if (newHour >= HOURS_IN_HALF_DAY) { - mIsAm = false; - updateAmPmControl(); - } else { - mIsAm = true; + boolean isDateChanged = false; // 标识日期是否发生了变化 + Calendar cal = Calendar.getInstance(); // 创建当前日期时间对象 + + // 根据当前是否是24小时制和是否跨越上下午进行不同的变化处理和计算 + if (!mIs24HourView) { // 不是24小时制 + if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) { // 跨越中午 + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, 1); // 将日期向后推一天 + isDateChanged = true; + } else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) { // 跨越中午 + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, -1); // 将日期向前推一天 + isDateChanged = true; + } + if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY || oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) { + // 跨越中午后需要更新上午/下午的显示 + mIsAm = !mIsAm; updateAmPmControl(); } + } else { // 是24小时制 + if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) { // 跨越0点 + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, 1); // 将日期向后推一天 + isDateChanged = true; + } else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) { // 跨越0点 + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, -1); // 将日期向前推一天 + isDateChanged = true; + } + } + // 根据当前是否为上午、24小时制和选择的小时数计算出新的小时数 + int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY); + mDate.set(Calendar.HOUR_OF_DAY, newHour); // 更新日历对象中的小时数 + onDateTimeChanged(); // 通知监听器日期时间变化事件 + + if (isDateChanged) { + // 如果日期发生变化，则需要更新日期选择器的显示 + setCurrentYear(cal.get(Calendar.YEAR)); + setCurrentMonth(cal.get(Calendar.MONTH)); + setCurrentDay(cal.get(Calendar.DAY_OF_MONTH)); } - mDate.set(Calendar.MINUTE, newVal); - onDateTimeChanged(); } }; private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() { @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 每次选择AM/PM时，切换mIsAm标志位 mIsAm = !mIsAm; + // 根据选择的AM/PM更新时间 if (mIsAm) { mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY); } else { mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY); } + // 更新AM/PM控件的状态 updateAmPmControl(); + // 回调onDateTimeChanged方法，通知监听器时间发生了变化 onDateTimeChanged(); } }; public interface OnDateTimeChangedListener { + // 定义onDateTimeChanged方法 void onDateTimeChanged(DateTimePicker view, int year, int month, - int dayOfMonth, int hourOfDay, int minute); + int dayOfMonth, int hourOfDay, int minute); } public DateTimePicker(Context context) {