Update AlarmAlertActivity.java

src/net/micode/notes/ui/AlarmAlertActivity.java

@@ -41,20 +41,22 @@ import java.io.IOException;
 
 
 public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
-    private long mNoteId;
-    private String mSnippet;
-    private static final int SNIPPET_PREW_MAX_LEN = 60;
-    MediaPlayer mPlayer;
+    //这一行定义了一个名为AlarmAlertActivity的公共类，它继承自Android的Activity类。
+    private long mNoteId;//这一行定义了一个私有变量mNoteId，类型为长整型（long）。这个变量可能用于存储与警报相关的笔记ID。
+    private String mSnippet;//这一行定义了一个私有字符串变量mSnippet。这个变量可能用于存储警报的简短描述或片段。
+    private static final int SNIPPET_PREW_MAX_LEN = 60;//这一行定义了一个私有静态常量整型变量SNIPPET_PREW_MAX_LEN，并赋值为60。这可能表示警报片段的最大长度为60个字符。
+    MediaPlayer mPlayer;//这一行定义了一个私有变量mPlayer，类型为MediaPlayer。这可能用于播放警报声音或音频。
 
     @Override
-    protected void onCreate(Bundle savedInstanceState) {
-        super.onCreate(savedInstanceState);
-        requestWindowFeature(Window.FEATURE_NO_TITLE);
+    protected void onCreate(Bundle savedInstanceState) {//这一行定义了一个受保护的方法onCreate，它是Activity类中的一个生命周期方法。当活动首次创建时，这个方法会被调用。
+        super.onCreate(savedInstanceState);//这一行调用了父类（即Activity类）的onCreate方法，并传递了保存的活动状态信息（如果有的话）。这是创建活动的标准步骤。
+        requestWindowFeature(Window.FEATURE_NO_TITLE);//这一行请求不显示活动的标题栏。通过调用requestWindowFeature方法并传递Window.FEATURE_NO_TITLE标志，可以创建一个没有标题栏的活动。
 
-        final Window win = getWindow();
-        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
+        final Window win = getWindow();//这一行获取当前活动（即this）的窗口引用，并将其存储在局部变量win中。
+        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);//这一行使当前活动的窗口具有在屏幕锁定时仍然可见的标志。这意味着当设备处于锁定状态时，这个活动仍然可以显示在屏幕上。
 
-        if (!isScreenOn()) {
+        if (!isScreenOn()) {//检查屏幕是否开启。
+//如果屏幕没有开启，这一行代码会向当前活动的窗口添加一些标志，以保持屏幕开启、在屏幕锁定时开启屏幕、允许在屏幕锁定时保持屏幕开启以及在窗口边缘插入装饰。
             win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
                     | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
                     | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
@@ -63,19 +65,19 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
 
         Intent intent = getIntent();
 
-        try {
+        try {//这一行代码从意图（Intent）中获取数据，并尝试将其转换为长整型（long）的笔记ID。
             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;
-        } catch (IllegalArgumentException e) {
+        } catch (IllegalArgumentException e) {//如果在上述过程中发生了非法参数异常，这一行代码会捕获该异常。
             e.printStackTrace();
             return;
         }
 
-        mPlayer = new MediaPlayer();
-        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
+        mPlayer = new MediaPlayer();//这一行代码创建一个新的MediaPlayer对象，用于播放音频或视频。
+        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {//方法，检查笔记是否在数据库中可见。
             showActionDialog();
             playAlarmSound();
         } else {
@@ -89,9 +91,10 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
     }
 
     private void playAlarmSound() {
+        // 使用RingtoneManager获取实际的默认闹钟铃声的Uri。
         Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
-
-        int silentModeStreams = Settings.System.getInt(getContentResolver(),
+//- 从设置中获取静音模式受影响的流，并存储在变量silentModeStreams中。
+        int silentModeStreams = Settings.System.getInt(getContentResolver(),//检查静音模式是否影响了闹钟音频流。如果影响了，那么闹钟音频流应该设置为静音模式。
                 Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
 
         if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {