diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java b/src/Notes-master/app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java index 85723be..b5544bb 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java @@ -39,21 +39,34 @@ import net.micode.notes.tool.DataUtils; import java.io.IOException; - +/** + * 闹钟提醒活动 - 处理笔记提醒的显示和响铃 + * 当笔记提醒时间到达时,此活动会显示提醒对话框并播放提醒音 + */ public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener { + // 笔记ID和摘要内容 private long mNoteId; private String mSnippet; + // 摘要预览最大长度常量 private static final int SNIPPET_PREW_MAX_LEN = 60; + // 媒体播放器,用于播放提醒音 MediaPlayer mPlayer; + /** + * 活动创建时调用 + * 设置窗口属性、解析意图数据、显示提醒对话框并播放提醒音 + */ @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); + // 请求无标题窗口 requestWindowFeature(Window.FEATURE_NO_TITLE); + // 获取窗口并添加显示在锁屏上的标志 final Window win = getWindow(); win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED); + // 如果屏幕未开启,则添加唤醒屏幕的标志 if (!isScreenOn()) { win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON @@ -61,11 +74,14 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR); } + // 获取启动活动的意图 Intent intent = getIntent(); + // 从意图数据中解析笔记ID和摘要 try { mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1)); mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId); + // 如果摘要过长,则截断并添加省略号 mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0, SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info) : mSnippet; @@ -74,7 +90,9 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD return; } + // 创建媒体播放器实例 mPlayer = new MediaPlayer(); + // 检查笔记是否有效,如果有效则显示对话框并播放提醒音,否则关闭活动 if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) { showActionDialog(); playAlarmSound(); @@ -83,76 +101,108 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD } } + /** + * 检查屏幕是否开启 + */ private boolean isScreenOn() { PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); return pm.isScreenOn(); } + /** + * 播放闹钟提醒音 + * 配置媒体播放器并播放默认闹钟铃声 + */ private void playAlarmSound() { + // 获取默认闹钟铃声URI Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM); + // 获取静音模式下受影响的音频流设置 int silentModeStreams = Settings.System.getInt(getContentResolver(), Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0); + // 根据设置配置音频流类型 if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) { mPlayer.setAudioStreamType(silentModeStreams); } else { mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM); } + + // 配置并启动媒体播放器 try { mPlayer.setDataSource(this, url); mPlayer.prepare(); - mPlayer.setLooping(true); + mPlayer.setLooping(true); // 设置循环播放 mPlayer.start(); } catch (IllegalArgumentException e) { - // TODO Auto-generated catch block + // 异常处理:参数错误 e.printStackTrace(); } catch (SecurityException e) { - // TODO Auto-generated catch block + // 异常处理:安全权限问题 e.printStackTrace(); } catch (IllegalStateException e) { - // TODO Auto-generated catch block + // 异常处理:播放器状态错误 e.printStackTrace(); } catch (IOException e) { - // TODO Auto-generated catch block + // 异常处理:IO错误 e.printStackTrace(); } } + /** + * 显示提醒操作对话框 + * 包含笔记摘要和操作按钮 + */ 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); + 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.show().setOnDismissListener(this); } + /** + * 处理对话框按钮点击事件 + */ 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; } } + /** + * 处理对话框关闭事件 + */ public void onDismiss(DialogInterface dialog) { + // 停止闹钟声音并结束活动 stopAlarmSound(); finish(); } + /** + * 停止闹钟声音并释放资源 + */ private void stopAlarmSound() { if (mPlayer != null) { - mPlayer.stop(); - mPlayer.release(); - mPlayer = null; + mPlayer.stop(); // 停止播放 + mPlayer.release(); // 释放资源 + mPlayer = null; // 置空引用,防止重复操作 } } }