diff --git a/src/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java b/src/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java index 85723be..f55fc0e 100644 --- a/src/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java +++ b/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; } } -} +} \ No newline at end of file