|
|
/*
|
|
|
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
|
|
|
*
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
* 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.
|
|
|
*/
|
|
|
|
|
|
// 包声明，表明该类属于net.micode.notes.ui包，通常用于存放与用户界面相关的类
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
|
import android.app.Activity;
|
|
|
import android.app.AlertDialog;
|
|
|
import android.content.Context;
|
|
|
import android.content.DialogInterface;
|
|
|
import android.content.DialogInterface.OnClickListener;
|
|
|
import android.content.DialogInterface.OnDismissListener;
|
|
|
import android.content.Intent;
|
|
|
import android.media.AudioManager;
|
|
|
import android.media.MediaPlayer;
|
|
|
import android.media.RingtoneManager;
|
|
|
import android.net.Uri;
|
|
|
import android.os.Bundle;
|
|
|
import android.os.PowerManager;
|
|
|
import android.provider.Settings;
|
|
|
import android.view.Window;
|
|
|
import android.view.WindowManager;
|
|
|
|
|
|
import net.micode.notes.R;
|
|
|
import net.micode.notes.data.Notes;
|
|
|
import net.micode.notes.tool.DataUtils;
|
|
|
|
|
|
import java.io.IOException;
|
|
|
|
|
|
// AlarmAlertActivity类继承自Activity类，意味着它是一个安卓中的Activity，用于展示用户界面。
|
|
|
// 同时实现了OnClickListener和OnDismissListener接口，用于处理对话框的点击和关闭事件
|
|
|
public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
|
|
|
|
|
|
// 用于存储与提醒相关联的笔记的ID，可能后续用于查询、操作该笔记的相关信息
|
|
|
private long mNoteId;
|
|
|
// 用于存储笔记的摘要信息，将展示在提醒界面等地方给用户查看
|
|
|
private String mSnippet;
|
|
|
// 定义摘要信息的最大长度为60个字符，超过这个长度会进行截断处理
|
|
|
private static final int SNIPPET_PREW_MAX_LEN = 60;
|
|
|
// MediaPlayer对象，用于播放提醒的声音，比如闹钟铃声等
|
|
|
MediaPlayer mPlayer;
|
|
|
|
|
|
// 重写Activity的onCreate方法，该方法在Activity被创建时调用，用于进行初始化等相关操作
|
|
|
@Override
|
|
|
protected void onCreate(Bundle savedInstanceState) {
|
|
|
super.onCreate(savedInstanceState);
|
|
|
// 请求去除Activity的标题栏，使界面更加简洁，仅在支持该特性的安卓版本和设备上生效
|
|
|
requestWindowFeature(Window.FEATURE_NO_TITLE);
|
|
|
|
|
|
// 获取当前Activity的窗口对象，后续用于设置窗口的各种属性
|
|
|
final Window win = getWindow();
|
|
|
// 设置窗口属性，使窗口在屏幕锁定时也能够显示出来，方便用户看到提醒信息
|
|
|
win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
|
|
|
|
|
|
// 调用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
|
|
|
| WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
|
|
|
}
|
|
|
|
|
|
// 获取启动该Activity的Intent对象，Intent中可能携带了与提醒相关的数据，比如笔记的相关信息等
|
|
|
Intent intent = getIntent();
|
|
|
|
|
|
try {
|
|
|
// 从Intent携带的数据中解析出笔记的ID，具体是从Intent的数据Uri的路径段中获取第二个元素（索引为1）并转换为长整型
|
|
|
mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
|
|
|
// 通过DataUtils工具类的方法，根据笔记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;
|
|
|
// 则进行截断处理，截取前60个字符，并添加一个特定的提示字符串（从资源文件中获取），否则保持原摘要信息不变
|
|
|
} catch (IllegalArgumentException e) {
|
|
|
// 如果在解析笔记ID或者获取摘要信息过程中出现参数异常（比如格式不正确等原因），打印异常堆栈信息，并直接返回，不再执行后续操作
|
|
|
e.printStackTrace();
|
|
|
return;
|
|
|
}
|
|
|
|
|
|
// 创建一个MediaPlayer实例，用于后续播放提醒声音
|
|
|
mPlayer = new MediaPlayer();
|
|
|
// 通过DataUtils工具类判断该笔记在笔记数据库中是否可见（可能涉及是否被删除、是否处于有效状态等条件判断），
|
|
|
// 传入笔记ID以及笔记类型（这里是普通笔记类型Notes.TYPE_NOTE）进行判断
|
|
|
if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
|
|
|
// 如果笔记可见，即满足有效条件，调用showActionDialog方法显示操作对话框，供用户进行相应操作
|
|
|
showActionDialog();
|
|
|
// 调用playAlarmSound方法播放提醒声音
|
|
|
playAlarmSound();
|
|
|
} else {
|
|
|
// 如果笔记不可见，直接结束当前Activity，意味着不需要展示提醒相关的界面了
|
|
|
finish();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 私有方法，用于判断屏幕是否处于开启状态
|
|
|
private boolean isScreenOn() {
|
|
|
// 获取系统的电源管理服务对象，用于查询屏幕的电源状态等信息
|
|
|
PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
|
|
|
// 调用电源管理服务对象的isScreenOn方法，返回屏幕是否开启的布尔值结果
|
|
|
return pm.isScreenOn();
|
|
|
}
|
|
|
|
|
|
// 私有方法，用于播放提醒声音，比如播放闹钟铃声等
|
|
|
private void playAlarmSound() {
|
|
|
// 通过RingtoneManager获取系统默认的闹钟铃声的Uri，用于指定MediaPlayer要播放的音频资源
|
|
|
Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
|
|
|
|
|
|
// 从系统设置中获取静音模式影响的音频流相关设置值，用于判断在静音模式下闹钟声音的播放情况
|
|
|
int silentModeStreams = Settings.System.getInt(getContentResolver(),
|
|
|
Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
|
|
|
|
|
|
// 判断静音模式设置中是否影响闹钟音频流，如果影响（对应位的值不为0）
|
|
|
if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM))!= 0) {
|
|
|
// 设置MediaPlayer的音频流类型为获取到的静音模式设置值，按照系统静音模式的相关配置来播放声音
|
|
|
mPlayer.setAudioStreamType(silentModeStreams);
|
|
|
} else {
|
|
|
// 如果静音模式不影响闹钟音频流，设置为正常的闹钟音频流类型，确保闹钟声音正常播放
|
|
|
mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
|
|
|
}
|
|
|
|
|
|
try {
|
|
|
// 设置MediaPlayer的数据源为获取到的铃声Uri，指定要播放的音频文件等资源
|
|
|
mPlayer.setDataSource(this, url);
|
|
|
// 准备MediaPlayer，使其进入可播放状态，这个过程可能涉及加载音频资源、初始化播放相关参数等操作
|
|
|
mPlayer.prepare();
|
|
|
// 设置MediaPlayer为循环播放模式，使提醒声音能够持续播放，直到用户手动停止或者其他相关逻辑结束播放
|
|
|
mPlayer.setLooping(true);
|
|
|
// 启动MediaPlayer，开始播放提醒声音
|
|
|
mPlayer.start();
|
|
|
} catch (IllegalArgumentException e) {
|
|
|
// 如果在设置数据源等过程中出现参数异常（比如参数不合法等原因），打印异常堆栈信息
|
|
|
e.printStackTrace();
|
|
|
} catch (SecurityException e) {
|
|
|
// 如果出现安全相关异常（比如没有权限访问音频资源等原因），打印异常堆栈信息
|
|
|
e.printStackTrace();
|
|
|
} catch (IllegalStateException e) {
|
|
|
// 如果MediaPlayer的状态出现异常（比如在不恰当的状态下执行了某些操作等原因），打印异常堆栈信息
|
|
|
e.printStackTrace();
|
|
|
} catch (IOException e) {
|
|
|
// 如果在读取数据源等IO操作过程中出现异常（比如音频文件损坏、无法读取等原因），打印异常堆栈信息
|
|
|
e.printStackTrace();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 私有方法，用于创建并显示操作对话框，给用户提供相应的操作选项，比如确认、进入编辑等操作
|
|
|
private void showActionDialog() {
|
|
|
// 创建一个AlertDialog的构建器对象，用于方便地构建AlertDialog对话框
|
|
|
AlertDialog.Builder dialog = new AlertDialog.Builder(this);
|
|
|
// 设置对话框的标题，这里使用了字符串资源中的应用名称（R.string.app_name对应的字符串）作为标题
|
|
|
dialog.setTitle(R.string.app_name);
|
|
|
// 设置对话框的消息内容，展示之前获取到的笔记摘要信息，让用户了解是哪个笔记的提醒
|
|
|
dialog.setMessage(mSnippet);
|
|
|
// 设置对话框的确定按钮（通常是一个积极的操作按钮）文本以及点击监听器，点击监听器使用当前类实现的OnClickListener接口，
|
|
|
// 意味着点击该按钮会触发当前类中对应的onClick方法
|
|
|
dialog.setPositiveButton(R.string.notealert_ok, this);
|
|
|
// 如果屏幕处于开启状态，设置对话框的另一个按钮（可能是进入编辑等操作按钮）文本以及点击监听器，同样使用当前类实现的OnClickListener接口
|
|
|
if (isScreenOn()) {
|
|
|
dialog.setNegativeButton(R.string.notealert_enter, this);
|
|
|
}
|
|
|
// 构建并显示对话框，同时设置对话框的关闭监听器，使用当前类实现的OnDismissListener接口，
|
|
|
// 意味着对话框关闭时会触发当前类中对应的onDismiss方法
|
|
|
dialog.show().setOnDismissListener(this);
|
|
|
}
|
|
|
|
|
|
// 实现OnClickListener接口的方法，用于处理对话框按钮的点击事件，根据点击的按钮不同执行相应的逻辑
|
|
|
public void onClick(DialogInterface dialog, int which) {
|
|
|
switch (which) {
|
|
|
// 如果点击的是对话框中的否定按钮（具体含义根据设置的文本而定，这里可能是进入编辑按钮等情况）
|
|
|
case DialogInterface.BUTTON_NEGATIVE:
|
|
|
// 创建一个Intent，用于启动NoteEditActivity，可能是进入对应的笔记编辑界面，方便用户对笔记进行编辑等操作
|
|
|
Intent intent = new Intent(this, NoteEditActivity.class);
|
|
|
// 设置Intent的动作，这里设置为查看（ACTION_VIEW）动作，表明是查看相关的操作意图
|
|
|
intent.setAction(Intent.ACTION_VIEW);
|
|
|
// 通过Intent的额外数据传递机制，将笔记的ID传递给目标Activity（NoteEditActivity），以便目标Activity能获取并处理对应的笔记
|
|
|
intent.putExtra(Intent.EXTRA_UID, mNoteId);
|
|
|
// 启动目标Activity，跳转到对应的笔记编辑界面
|
|
|
startActivity(intent);
|
|
|
break;
|
|
|
default:
|
|
|
break;
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 实现OnDismissListener接口的方法，当对话框关闭时会被调用，用于执行对话框关闭后的相关操作
|
|
|
public void onDismiss(DialogInterface dialog) {
|
|
|
// 调用stopAlarmSound方法停止播放提醒声音，并释放相关的资源，如MediaPlayer占用的内存等
|
|
|
stopAlarmSound();
|
|
|
// 结束当前Activity，关闭提醒相关的界面，完成整个提醒流程
|
|
|
finish();
|
|
|
}
|
|
|
|
|
|
// 私有方法，用于停止播放提醒声音，并释放MediaPlayer资源，将其置为null避免后续出现问题
|
|
|
private void stopAlarmSound() {
|
|
|
if (mPlayer!= null) {
|
|
|
// 停止MediaPlayer的播放，如果正在播放声音则立即停止
|
|
|
mPlayer.stop();
|
|
|
// 释放MediaPlayer占用的资源，使其回到初始未使用状态
|
|
|
mPlayer.release();
|
|
|
// 将mPlayer对象置为null，防止后续误操作该对象，同时也符合资源释放后的正确使用习惯
|
|
|
mPlayer = null;
|
|
|
}
|
|
|
}
|
|
|
} |
