添加代码注释

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;  // 置空引用，防止重复操作
         }
     }
 }