AlarmAlertActivity是Android便签应用中负责闹钟提醒功能的核心组件。其主要作用是在便签设定的提醒时间到达时，通过以下方式通知用户：

1.唤醒设备：即使手机处于锁屏或睡眠状态，也能点亮屏幕并显示提醒界面。
2.播放提醒音：使用系统默认闹钟铃声循环播放，确保用户注意到提醒。
3.显示提醒内容：以对话框形式展示便签的摘要信息（自动截取前 60 个字符）。
4.提供交互选项：
。确认按钮：关闭提醒并停止铃声。
。进入按钮（仅在屏幕已开启时显示）：直接跳转到便签编辑页面查看完整内容。

该类通过处理异常情况（如便签已删除）、管理音频资源释放、适配不同设备状态（锁屏 / 解锁）等细节，确保提醒功能稳定可靠。

src/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java

@@ -39,103 +39,160 @@ import net.micode.notes.tool.DataUtils;
 
 import java.io.IOException;
 
-
+/**
+ * AlarmAlertActivity 类用于处理闹钟提醒功能。
+ * 当闹钟触发时，该活动会弹出提醒对话框并播放闹钟声音。
+ */
 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 对象
     MediaPlayer mPlayer;
 
+    /**
+     * 活动创建时调用的方法，进行一些初始化操作。
+     * @param savedInstanceState 保存的活动状态
+     */
     @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
                     | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
                     | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
         }
 
+        // 获取启动该活动的 Intent 对象
         Intent intent = getIntent();
 
         try {
+            // 从 Intent 的数据中获取便签的 ID
             mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
+            // 根据便签 ID 获取便签的摘要信息
             mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
+            // 如果摘要信息长度超过最大预览长度，截取前 SNIPPET_PREW_MAX_LEN 个字符并添加省略号
             mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
                     SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
                     : mSnippet;
         } catch (IllegalArgumentException e) {
+            // 处理异常，打印异常堆栈信息
             e.printStackTrace();
             return;
         }
 
+        // 创建 MediaPlayer 对象
         mPlayer = new MediaPlayer();
+        // 检查便签是否在数据库中可见
         if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
+            // 如果可见，显示提醒对话框并播放闹钟声音
             showActionDialog();
             playAlarmSound();
         } else {
+            // 如果不可见，结束当前活动
             finish();
         }
     }
 
+    /**
+     * 检查屏幕是否亮起的方法。
+     * @return 如果屏幕亮起返回 true，否则返回 false
+     */
     private boolean isScreenOn() {
+        // 获取 PowerManager 服务
         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);
 
+        // 根据静音模式设置，设置 MediaPlayer 的音频流类型
         if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
             mPlayer.setAudioStreamType(silentModeStreams);
         } else {
             mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
         }
         try {
+            // 设置 MediaPlayer 的数据源
             mPlayer.setDataSource(this, url);
+            // 准备 MediaPlayer
             mPlayer.prepare();
+            // 设置循环播放
             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
+            // 处理异常，打印异常堆栈信息
             e.printStackTrace();
         }
     }
 
+    /**
+     * 显示提醒对话框的方法。
+     */
     private void showActionDialog() {
+        // 创建 AlertDialog 构建器
         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.show().setOnDismissListener(this);
     }
 
+    /**
+     * 处理对话框按钮点击事件的方法。
+     * @param dialog 被点击的对话框
+     * @param which 被点击的按钮标识
+     */
     public void onClick(DialogInterface dialog, int which) {
         switch (which) {
             case DialogInterface.BUTTON_NEGATIVE:
+                // 如果点击了取消按钮，创建一个 Intent 用于打开便签编辑页面
                 Intent intent = new Intent(this, NoteEditActivity.class);
                 intent.setAction(Intent.ACTION_VIEW);
                 intent.putExtra(Intent.EXTRA_UID, mNoteId);
+                // 启动便签编辑活动
                 startActivity(intent);
                 break;
             default:
@@ -143,16 +200,29 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
         }
     }
 
+    /**
+     * 处理对话框关闭事件的方法。
+     * @param dialog 关闭的对话框
+     */
     public void onDismiss(DialogInterface dialog) {
+        // 停止闹钟声音
         stopAlarmSound();
+        // 结束当前活动
         finish();
     }
 
+    /**
+     * 停止闹钟声音的方法。
+     */
     private void stopAlarmSound() {
+        // 检查 MediaPlayer 是否为空
         if (mPlayer != null) {
+            // 停止播放
             mPlayer.stop();
+            // 释放 MediaPlayer 资源
             mPlayer.release();
+            // 将 MediaPlayer 对象置为 null
             mPlayer = null;
         }
     }
-}
+}