|
|
/*
|
|
|
* 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类，实现了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) {
|
|
|
// 调用父类的onCreate方法，完成Activity创建的基本初始化流程，这是必须的操作
|
|
|
super.onCreate(savedInstanceState);
|
|
|
// 请求去除Activity的标题栏，使界面更加简洁，通常用于全屏等特定显示需求
|
|
|
requestWindowFeature(Window.FEATURE_NO_TITLE);
|
|
|
|
|
|
// 获取当前Activity的窗口对象，后续用于设置窗口相关的属性
|
|
|
final Window win = getWindow();
|
|
|
// 给窗口添加标志位，使得在屏幕锁定时也能显示该Activity，方便用户看到闹钟提醒
|
|
|
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);
|
|
|
}
|
|
|
|
|
|
// 获取启动该Activity的Intent对象，用于获取传递过来的数据等信息
|
|
|
Intent intent = getIntent();
|
|
|
|
|
|
try {
|
|
|
// 从Intent携带的数据中获取笔记的ID，具体是从数据的路径片段中的第二个元素获取（假设数据格式符合特定规范）
|
|
|
mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
|
|
|
// 通过工具类DataUtils根据笔记ID获取笔记的摘要内容
|
|
|
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) {
|
|
|
// 如果在获取笔记ID或处理摘要过程中出现参数异常，打印异常堆栈信息，并且直接返回，不再继续执行后续可能出错的操作
|
|
|
e.printStackTrace();
|
|
|
return;
|
|
|
}
|
|
|
|
|
|
// 创建一个MediaPlayer对象，用于播放闹钟提醒的声音
|
|
|
mPlayer = new MediaPlayer();
|
|
|
// 判断该笔记是否在笔记数据库中可见（通过DataUtils工具类的方法进行判断）
|
|
|
if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
|
|
|
// 如果可见，展示操作对话框，给用户提供相关操作选项
|
|
|
showActionDialog();
|
|
|
// 调用方法播放闹钟提醒声音
|
|
|
playAlarmSound();
|
|
|
} else {
|
|
|
// 如果笔记不可见，直接结束该Activity，不需要进行后续的提醒相关操作
|
|
|
finish();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 方法用于判断屏幕是否处于开启状态，通过获取PowerManager服务并调用其isScreenOn方法来判断
|
|
|
private boolean isScreenOn() {
|
|
|
PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
|
|
|
return pm.isScreenOn();
|
|
|
}
|
|
|
|
|
|
// 方法用于播放闹钟提醒声音，进行一系列设置并启动声音播放
|
|
|
private void playAlarmSound() {
|
|
|
// 获取系统默认的闹钟铃声的Uri，通过RingtoneManager来获取实际使用的默认铃声的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 {
|
|
|
// 如果不受影响，将MediaPlayer的音频流类型设置为普通的闹钟音频流类型
|
|
|
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) {
|
|
|
// 如果在设置数据源等操作中出现参数异常，打印异常堆栈信息
|
|
|
// TODO Auto-generated catch block
|
|
|
e.printStackTrace();
|
|
|
} catch (SecurityException e) {
|
|
|
// 如果出现安全相关异常，比如没有权限访问音频资源等情况，打印异常堆栈信息
|
|
|
// TODO Auto-generated catch block
|
|
|
e.printStackTrace();
|
|
|
} catch (IllegalStateException e) {
|
|
|
// 如果MediaPlayer处于不正确的状态（比如已经在播放等情况）导致操作失败，打印异常堆栈信息
|
|
|
// TODO Auto-generated catch block
|
|
|
e.printStackTrace();
|
|
|
} catch (IOException e) {
|
|
|
// 如果在读取音频数据等操作中出现IO异常，比如文件不存在等情况，打印异常堆栈信息
|
|
|
// 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);
|
|
|
// 设置对话框的确认按钮（通常是正向操作按钮）的文本及点击监听器，点击时会触发OnClickListener中的相应逻辑
|
|
|
dialog.setPositiveButton(R.string.notealert_ok, this);
|
|
|
// 判断屏幕是否开启，如果开启，设置对话框的取消按钮（通常是进入相关操作按钮）的文本及点击监听器
|
|
|
if (isScreenOn()) {
|
|
|
dialog.setNegativeButton(R.string.notealert_enter, this);
|
|
|
}
|
|
|
// 构建并显示对话框，同时给对话框设置关闭监听器，当对话框关闭时会触发相应逻辑
|
|
|
dialog.show().setOnDismissListener(this);
|
|
|
}
|
|
|
|
|
|
// 实现OnClickListener接口的方法，处理对话框按钮点击事件，根据点击的按钮执行相应的操作
|
|
|
public void onClick(DialogInterface dialog, int which) {
|
|
|
switch (which) {
|
|
|
case DialogInterface.BUTTON_NEGATIVE:
|
|
|
// 如果点击的是取消按钮（通常是进入相关操作按钮），创建一个Intent用于启动笔记编辑Activity
|
|
|
Intent intent = new Intent(this, NoteEditActivity.class);
|
|
|
// 设置Intent的动作，这里设置为查看动作，表明是查看笔记详情的意图
|
|
|
intent.setAction(Intent.ACTION_VIEW);
|
|
|
// 将笔记的ID作为额外数据添加到Intent中，传递给NoteEditActivity，以便其能识别要编辑的具体笔记
|
|
|
intent.putExtra(Intent.EXTRA_UID, mNoteId);
|
|
|
// 启动NoteEditActivity，切换到笔记编辑界面
|
|
|
startActivity(intent);
|
|
|
break;
|
|
|
default:
|
|
|
break;
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 实现OnDismissListener接口的方法，当对话框关闭时被调用，用于停止闹钟声音并结束当前Activity
|
|
|
public void onDismiss(DialogInterface dialog) {
|
|
|
// 调用方法停止闹钟声音，释放相关资源
|
|
|
stopAlarmSound();
|
|
|
// 结束当前Activity，关闭闹钟提醒界面
|
|
|
finish();
|
|
|
}
|
|
|
|
|
|
// 方法用于停止闹钟声音，释放MediaPlayer相关的资源，将其设置为null
|
|
|
private void stopAlarmSound() {
|
|
|
if (mPlayer!= null) {
|
|
|
// 停止MediaPlayer的播放
|
|
|
mPlayer.stop();
|
|
|
// 释放MediaPlayer占用的资源，如音频缓冲区等
|
|
|
mPlayer.release();
|
|
|
// 将MediaPlayer对象设置为null，避免后续误操作
|
|
|
mPlayer = null;
|
|
|
}
|
|
|
}
|
|
|
} |
