|
|
以下是对这段代码每一行的注释：
|
|
|
|
|
|
```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。
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
```
|
