|
|
/*
|
|
|
* 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.
|
|
|
*/
|
|
|
|
|
|
// AlarmAlertActivity.java - 闹钟提醒Activity
|
|
|
// 主要功能：显示便签闹钟提醒，在指定时间弹出提醒对话框并播放提示音
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
|
// ======================= 导入区域 =======================
|
|
|
// Android基础类
|
|
|
import android.app.Activity; // 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; // Intent，用于跳转
|
|
|
import android.media.AudioManager; // 音频管理
|
|
|
import android.media.MediaPlayer; // 媒体播放器
|
|
|
import android.media.RingtoneManager; // 铃声管理器
|
|
|
import android.net.Uri; // URI
|
|
|
import android.os.Bundle; // Bundle，用于保存状态
|
|
|
import android.os.PowerManager; // 电源管理
|
|
|
import android.provider.Settings; // 系统设置
|
|
|
import android.view.Window; // 窗口
|
|
|
import android.view.WindowManager; // 窗口管理器
|
|
|
|
|
|
// 应用内部资源
|
|
|
import net.micode.notes.R; // 资源文件R类
|
|
|
import net.micode.notes.data.Notes; // Notes主类
|
|
|
import net.micode.notes.tool.DataUtils; // 数据工具类
|
|
|
|
|
|
// Java IO
|
|
|
import java.io.IOException; // IO异常
|
|
|
|
|
|
// ======================= 闹钟提醒Activity =======================
|
|
|
/**
|
|
|
* AlarmAlertActivity - 闹钟提醒Activity
|
|
|
* 全屏对话框形式显示，即使在锁屏状态下也会弹出
|
|
|
* 实现功能：显示便签内容、播放提示音、提供操作按钮
|
|
|
* 实现接口：OnClickListener（对话框按钮点击），OnDismissListener（对话框关闭）
|
|
|
*/
|
|
|
public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
|
|
|
// 成员变量
|
|
|
private long mNoteId; // 便签ID，从Intent中获取
|
|
|
private String mSnippet; // 便签摘要，用于对话框显示
|
|
|
private static final int SNIPPET_PREW_MAX_LEN = 60; // 摘要预览最大长度
|
|
|
MediaPlayer mPlayer; // 媒体播放器，用于播放提示音
|
|
|
|
|
|
// ======================= 生命周期方法 =======================
|
|
|
|
|
|
/**
|
|
|
* onCreate - Activity创建时的初始化方法
|
|
|
* 主要任务：
|
|
|
* 1. 设置窗口属性（全屏、锁屏显示）
|
|
|
* 2. 获取便签ID和内容
|
|
|
* 3. 检查便签是否存在
|
|
|
* 4. 显示提醒对话框
|
|
|
* 5. 播放提示音
|
|
|
* @param savedInstanceState 保存的状态（此处为null，因是新建Activity）
|
|
|
*/
|
|
|
@Override
|
|
|
protected void onCreate(Bundle savedInstanceState) {
|
|
|
super.onCreate(savedInstanceState);
|
|
|
|
|
|
// 1. 设置窗口属性
|
|
|
// 请求无标题栏
|
|
|
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); // 布局装饰
|
|
|
}
|
|
|
|
|
|
// 2. 获取Intent数据
|
|
|
Intent intent = getIntent();
|
|
|
|
|
|
try {
|
|
|
// 从Intent的URI中解析便签ID
|
|
|
// URI格式示例：content://micode_notes/note/123
|
|
|
// getPathSegments()返回["note", "123"]，取索引1得到"123"
|
|
|
mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
|
|
|
|
|
|
// 通过工具类获取便签摘要
|
|
|
mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
|
|
|
|
|
|
// 3. 处理摘要显示长度
|
|
|
// 如果摘要过长，截取前60个字符并添加省略号
|
|
|
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) {
|
|
|
// URI解析或ID转换异常
|
|
|
e.printStackTrace();
|
|
|
return; // 异常时直接返回，不继续执行
|
|
|
}
|
|
|
|
|
|
// 4. 初始化媒体播放器
|
|
|
mPlayer = new MediaPlayer();
|
|
|
|
|
|
// 5. 检查便签是否可见（存在且不在回收站）
|
|
|
if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
|
|
|
// 便签存在，显示对话框
|
|
|
showActionDialog();
|
|
|
// 播放提示音
|
|
|
playAlarmSound();
|
|
|
} else {
|
|
|
// 便签不存在（可能已被删除），直接结束Activity
|
|
|
finish();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 检查屏幕是否亮屏
|
|
|
* @return true: 屏幕已亮; false: 屏幕关闭
|
|
|
*/
|
|
|
private boolean isScreenOn() {
|
|
|
// 获取电源管理器服务
|
|
|
PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
|
|
|
// 判断屏幕是否亮屏（已废弃，但兼容旧版本）
|
|
|
return pm.isScreenOn();
|
|
|
}
|
|
|
|
|
|
// ======================= 提示音播放 =======================
|
|
|
|
|
|
/**
|
|
|
* 播放闹钟提示音
|
|
|
* 使用系统默认的闹钟铃声
|
|
|
*/
|
|
|
private void playAlarmSound() {
|
|
|
// 1. 获取系统默认闹钟铃声URI
|
|
|
Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
|
|
|
|
|
|
// 2. 获取静音模式设置
|
|
|
// 检查哪些音频流受静音模式影响
|
|
|
int silentModeStreams = Settings.System.getInt(getContentResolver(),
|
|
|
Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
|
|
|
|
|
|
// 3. 设置音频流类型
|
|
|
// 判断闹钟音频流是否受静音模式影响
|
|
|
if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
|
|
|
// 受静音影响，使用系统设置的类型
|
|
|
mPlayer.setAudioStreamType(silentModeStreams);
|
|
|
} else {
|
|
|
// 不受静音影响，使用闹钟音频流
|
|
|
mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
|
|
|
}
|
|
|
|
|
|
// 4. 设置数据源并播放
|
|
|
try {
|
|
|
mPlayer.setDataSource(this, url); // 设置铃声URI
|
|
|
mPlayer.prepare(); // 准备播放
|
|
|
mPlayer.setLooping(true); // 循环播放
|
|
|
mPlayer.start(); // 开始播放
|
|
|
} catch (IllegalArgumentException e) {
|
|
|
// URI格式错误
|
|
|
e.printStackTrace();
|
|
|
} catch (SecurityException e) {
|
|
|
// 权限不足
|
|
|
e.printStackTrace();
|
|
|
} catch (IllegalStateException e) {
|
|
|
// 播放器状态错误
|
|
|
e.printStackTrace();
|
|
|
} catch (IOException e) {
|
|
|
// IO错误，文件读取失败
|
|
|
e.printStackTrace();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// ======================= 提醒对话框 =======================
|
|
|
|
|
|
/**
|
|
|
* 显示操作对话框
|
|
|
* 对话框内容：应用名称 + 便签摘要 + 操作按钮
|
|
|
*/
|
|
|
private void showActionDialog() {
|
|
|
// 1. 创建对话框构建器
|
|
|
AlertDialog.Builder dialog = new AlertDialog.Builder(this);
|
|
|
|
|
|
// 2. 设置对话框内容
|
|
|
dialog.setTitle(R.string.app_name); // 应用名称作为标题
|
|
|
dialog.setMessage(mSnippet); // 便签摘要作为内容
|
|
|
|
|
|
// 3. 设置按钮
|
|
|
// 确定按钮 - 关闭提醒
|
|
|
dialog.setPositiveButton(R.string.notealert_ok, this);
|
|
|
|
|
|
// 如果屏幕已亮，显示"进入"按钮（跳转到便签编辑）
|
|
|
if (isScreenOn()) {
|
|
|
dialog.setNegativeButton(R.string.notealert_enter, this);
|
|
|
}
|
|
|
|
|
|
// 4. 显示对话框并设置关闭监听
|
|
|
dialog.show().setOnDismissListener(this);
|
|
|
}
|
|
|
|
|
|
// ======================= 对话框事件处理 =======================
|
|
|
|
|
|
/**
|
|
|
* 对话框按钮点击回调
|
|
|
* 实现OnClickListener接口
|
|
|
* @param dialog 被点击的对话框
|
|
|
* @param which 被点击的按钮标识
|
|
|
* BUTTON_POSITIVE: 确定按钮
|
|
|
* BUTTON_NEGATIVE: 进入按钮（仅在屏幕亮时显示）
|
|
|
* BUTTON_NEUTRAL: 中立按钮（未使用）
|
|
|
*/
|
|
|
public void onClick(DialogInterface dialog, int which) {
|
|
|
switch (which) {
|
|
|
case DialogInterface.BUTTON_NEGATIVE:
|
|
|
// "进入"按钮：跳转到便签编辑界面
|
|
|
Intent intent = new Intent(this, NoteEditActivity.class);
|
|
|
intent.setAction(Intent.ACTION_VIEW); // 查看动作
|
|
|
intent.putExtra(Intent.EXTRA_UID, mNoteId); // 传递便签ID
|
|
|
startActivity(intent);
|
|
|
break;
|
|
|
default:
|
|
|
// 其他按钮（确定按钮）不执行额外操作
|
|
|
// 对话框关闭后会触发onDismiss，自动结束Activity
|
|
|
break;
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 对话框关闭回调
|
|
|
* 实现OnDismissListener接口
|
|
|
* 无论点击哪个按钮，对话框关闭时都会执行
|
|
|
* @param dialog 被关闭的对话框
|
|
|
*/
|
|
|
public void onDismiss(DialogInterface dialog) {
|
|
|
// 停止播放提示音
|
|
|
stopAlarmSound();
|
|
|
// 结束Activity
|
|
|
finish();
|
|
|
}
|
|
|
|
|
|
// ======================= 资源清理 =======================
|
|
|
|
|
|
/**
|
|
|
* 停止播放提示音
|
|
|
* 释放MediaPlayer资源
|
|
|
*/
|
|
|
private void stopAlarmSound() {
|
|
|
if (mPlayer != null) {
|
|
|
mPlayer.stop(); // 停止播放
|
|
|
mPlayer.release(); // 释放资源
|
|
|
mPlayer = null; // 置空引用，帮助GC
|
|
|
}
|
|
|
}
|
|
|
} |
