diff --git a/uiAlarmAlertActivity (2).txt b/uiAlarmAlertActivity (2).txt new file mode 100644 index 0000000..8305b21 --- /dev/null +++ b/uiAlarmAlertActivity (2).txt @@ -0,0 +1,236 @@ +以下是对这段代码每一行的注释: + +```java +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * 版权声明,指出代码由The MiCode Open Source Community拥有版权,并提供了他们的网址。 + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * 声明代码遵循Apache License 2.0。 + * you may not use this file except in compliance with the License. + * 你不能使用此文件,除非遵守该许可证。 + * You may obtain a copy of the License at + * 你可以通过以下网址获取许可证的副本: + * + * http://www.apache.org/licenses/LICENSE-2.0 + * 许可证的网址。 + * + * Unless required by applicable law or agreed to in writing, software + * 分发的软件遵循“按原样”分发的原则,不提供任何形式的保证。 + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * 没有明示或暗示的保证,包括但不限于适销性、特定用途的适用性或非侵权的保证。 + * See the License for the specific language governing permissions and + * limitations under the License. + * 请参考许可证以了解有关权限和限制的具体条款。 + */ + +package net.micode.notes.ui; +// 声明代码属于哪个包。 + +import android.app.Activity; +// 导入Activity类,是Android应用程序的基础类。 +import android.app.AlertDialog; +// 导入AlertDialog类,用于显示对话框。 +import android.content.Context; +// 导入Context类,提供关于应用程序环境的信息。 +import android.content.DialogInterface; +// 导入DialogInterface类,是对话框中按钮监听器的基接口。 +import android.content.DialogInterface.OnClickListener; +// 导入OnClickListener接口,用于处理对话框按钮点击事件。 +import android.content.DialogInterface.OnDismissListener; +// 导入OnDismissListener接口,用于处理对话框被关闭的事件。 +import android.content.Intent; +// 导入Intent类,用于在组件之间传递消息。 +import android.media.AudioManager; +// 导入AudioManager类,用于管理与音频相关的操作。 +import android.media.MediaPlayer; +// 导入MediaPlayer类,用于播放音频文件。 +import android.media.RingtoneManager; +// 导入RingtoneManager类,用于管理铃声。 +import android.net.Uri; +// 导入Uri类,表示一个统一的资源标识符。 +import android.os.Bundle; +// 导入Bundle类,用于存储键值对的数据。 +import android.os.PowerManager; +// 导入PowerManager类,用于管理系统电源。 +import android.provider.Settings; +// 导入Settings类,用于访问系统设置。 +import android.view.Window; +// 导入Window类,表示应用窗口。 +import android.view.WindowManager; +// 导入WindowManager类,用于管理窗口。 + +import net.micode.notes.R; +// 导入R类,包含了应用程序的资源。 +import net.micode.notes.data.Notes; +// 导入Notes类,用于处理笔记数据。 +import net.micode.notes.tool.DataUtils; +// 导入DataUtils类,提供了数据操作的工具方法。 + +import java.io.IOException; +// 导入IOException类,表示I/O异常。 +``` + +```java +public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener { +// 声明一个名为AlarmAlertActivity的公共类,继承自Activity类,并实现OnClickListener和OnDismissListener接口。 + private long mNoteId; + // 定义一个私有成员变量mNoteId,用于存储笔记的ID。 + private String mSnippet; + // 定义一个私有成员变量mSnippet,用于存储笔记的预览文本。 + private static final int SNIPPET_PREW_MAX_LEN = 60; + // 定义一个常量,限定预览文本的最大长度。 + MediaPlayer mPlayer; + // 定义一个MediaPlayer对象,用于播放音频。 + + @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 = getIntent(); + // 获取启动该Activity的Intent。 + + try { + mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1)); + // 从Intent中获取笔记ID。 + mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId); + // 根据笔记ID获取笔记的预览文本。 + 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; + } + + mPlayer = new MediaPlayer(); + // 初始化MediaPlayer对象。 + if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) { + showActionDialog(); + // 显示操作对话框。 + playAlarmSound(); + // 播放闹钟声音。 + } else { + finish(); + // 如果笔记不在数据库中,则结束该Activity。 + } + } + + private boolean isScreenOn() { + PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); + // 获取电源服务。 + return pm.isScreenOn(); + // 返回屏幕是否亮着。 + } + + private void playAlarmSound() { + Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM); + // 获取默认闹钟铃声的Uri。 + + 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); + } + // 设置MediaPlayer的音频流类型。 + + try { + mPlayer.setDataSource(this, url); + // 设置MediaPlayer的数据源。 + mPlayer.prepare(); + // 准备MediaPlayer。 + mPlayer.setLooping(true); + // 设置MediaPlayer循环播放。 + 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.Builder dialog = new AlertDialog.Builder(this); + // 创建AlertDialog的构造器。 + 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) { + // 实现OnClickListener接口的onClick方法。 + switch (which) { + case DialogInterface.BUTTON_NEGATIVE: + Intent intent = new Intent(this, NoteEditActivity.class); + // 创建一个新的Intent,意图是打开NoteEditActivity。 + intent.setAction(Intent.ACTION_VIEW); + // 设置Intent的动作为查看。 + intent.putExtra(Intent.EXTRA_UID, mNoteId); + // 将笔记ID作为额外信息传递给NoteEditActivity。 + startActivity(intent); + // 启动NoteEditActivity。 + break; + default: + break; + } + } + + public void onDismiss(DialogInterface dialog) { + // 实现OnDismissListener接口的onDismiss方法。 + stopAlarmSound(); + // 停止闹钟声音。 + finish(); + // 结束该Activity。 + } + + private void stopAlarmSound() { + // 定义一个私有方法来停止闹钟声音。 + if (mPlayer != null) { + mPlayer.stop(); + // 停止MediaPlayer。 + mPlayer.release(); + // 释放MediaPlayer资源。 + mPlayer = null; + // 将MediaPlayer对象设置为null。 + } + } +} +```