Notesmaster/app/src/main/java/net/micode/notes/ui/AlarmAlertActivity.java

@@ -41,98 +41,133 @@ 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);
+        // 不显示Activity的标题栏
         requestWindowFeature(Window.FEATURE_NO_TITLE);
 
         final Window win = getWindow();
+        // 添加窗口标志，使Activity在锁屏状态下也能显示
         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);
         }
 
+        // 获取启动Activity的Intent
         Intent intent = getIntent();
 
         try {
+            // 从Intent的Data中解析出便签ID
             mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
+            // 通过ContentResolver获取便签的摘要内容
             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;
         } catch (IllegalArgumentException e) {
+            // 处理参数异常，打印堆栈信息并结束Activity
             e.printStackTrace();
             return;
         }
 
+        // 创建媒体播放器实例
         mPlayer = new MediaPlayer();
+        // 检查便签是否存在且为普通便签类型
         if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
+            // 显示提醒对话框
             showActionDialog();
+            // 播放闹钟提醒声音
             playAlarmSound();
         } else {
+            // 便签不存在或类型不符，结束Activity
             finish();
         }
     }
 
+    // 检查屏幕是否处于开启状态
     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.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);
+        // 如果屏幕已开启，添加"进入"按钮
         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:
+                // 点击"进入"按钮，启动便签编辑Activity查看便签详情
                 Intent intent = new Intent(this, NoteEditActivity.class);
                 intent.setAction(Intent.ACTION_VIEW);
                 intent.putExtra(Intent.EXTRA_UID, mNoteId);
@@ -143,15 +178,22 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
         }
     }
 
+    // 对话框消失时的回调处理
     public void onDismiss(DialogInterface dialog) {
+        // 停止闹钟声音播放
         stopAlarmSound();
+        // 结束当前Activity
         finish();
     }
 
+    // 停止闹钟声音并释放资源
     private void stopAlarmSound() {
         if (mPlayer != null) {
+            // 停止播放
             mPlayer.stop();
+            // 释放媒体播放器资源
             mPlayer.release();
+            // 将引用置为null，便于垃圾回收
             mPlayer = null;
         }
     }