/* * 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. * 以下是这段代码中主要的函数及其功能介绍: onCreate 函数 所属类:AlarmAlertActivity 功能: 首先调用父类(Activity)的 onCreate 方法进行基础的初始化操作。 通过 requestWindowFeature 方法请求去除 Activity 的标题栏(使用 Window.FEATURE_NO_TITLE 特性)。 获取当前窗口对象 win,并添加一些窗口相关的标志位,例如 FLAG_SHOW_WHEN_LOCKED 让窗口在屏幕锁定时也能显示,还会根据屏幕是否亮起(通过 isScreenOn 函数判断)来添加如 FLAG_KEEP_SCREEN_ON 等其他与屏幕状态控制相关的标志位,用于控制屏幕的显示和锁定等行为。 从传入的 Intent 中获取相关数据,尝试解析出笔记的 ID(mNoteId)以及对应的简短内容片段(mSnippet),若解析出现 IllegalArgumentException 异常则打印堆栈信息并返回,不继续后续流程。 创建 MediaPlayer 实例 mPlayer,接着判断笔记在数据库中的可见性(通过 DataUtils.visibleInNoteDatabase 函数判断),如果可见则调用 showActionDialog 显示操作对话框,并调用 playAlarmSound 播放闹钟声音,若不可见则直接结束当前 Activity。 isScreenOn 函数 所属类:AlarmAlertActivity 功能:获取系统的电源管理服务(PowerManager),通过调用其 isScreenOn 方法来判断当前屏幕是否处于亮起状态,返回一个布尔值,用于后续决定添加哪些窗口相关的标志位等操作。 playAlarmSound 函数 所属类:AlarmAlertActivity 功能: 首先通过 RingtoneManager.getActualDefaultRingtoneUri 方法获取系统默认闹钟铃声的 Uri 地址。 接着从系统设置中获取静音模式影响的音频流相关设置(通过 Settings.System.getInt 获取 Settings.System.MODE_RINGER_STREAMS_AFFECTED 的值),根据其值来设置 MediaPlayer(mPlayer)的音频流类型,若满足特定条件则设置为获取到的 silentModeStreams,否则设置为 AudioManager.STREAM_ALARM。 然后尝试设置 MediaPlayer 的数据源(通过 setDataSource 方法传入当前 Activity 上下文和铃声 Uri),并进行准备(prepare)操作,设置为循环播放(setLooping 为 true),最后启动播放(start)。过程中如果出现如 IllegalArgumentException、SecurityException、IllegalStateException、IOException 等异常会打印相应的堆栈信息。 showActionDialog 函数 所属类:AlarmAlertActivity 功能: 创建一个 AlertDialog.Builder 实例用于构建对话框,设置对话框的标题(通过 R.string.app_name 资源字符串获取标题内容)、消息内容(使用之前获取的笔记内容片段 mSnippet)。 设置对话框的确定按钮(通过 setPositiveButton 方法,按钮文本使用 R.string.notealert_ok 资源字符串,点击事件绑定到当前类实现的 onClick 方法),并且在屏幕亮起的情况下(通过 isScreenOn 函数判断),设置进入按钮(通过 setNegativeButton 方法,按钮文本使用 R.string.notealert_enter 资源字符串,点击事件同样绑定到 onClick 方法)。 最后调用 show 方法显示对话框,并设置对话框关闭的监听器(通过 setOnDismissListener 绑定到当前类实现的 onDismiss 方法)。 onClick 函数 所属类:AlarmAlertActivity 功能:实现了 DialogInterface.OnClickListener 接口的方法,根据点击对话框按钮的 which 参数进行不同操作。当点击了对话框的否定(消极)按钮(对应 DialogInterface.BUTTON_NEGATIVE,也就是 notealert_enter 按钮)时,创建一个新的 Intent,指定目标 Activity 为 NoteEditActivity,设置 Intent 的动作(ACTION_VIEW)以及传递笔记的 ID(通过 putExtra 传递 Intent.EXTRA_UID 附加数据),然后启动对应的 Activity,用于进入笔记编辑页面等相关操作。对于其他按钮点击情况暂时不做额外处理(default 分支)。 onDismiss 函数 所属类:AlarmAlertActivity 功能:实现了 DialogInterface.OnDismissListener 接口的方法,当对话框关闭时被调用。在这个函数中,会调用 stopAlarmSound 函数停止正在播放的闹钟声音,然后结束当前 Activity,完成整个与闹钟提醒相关的流程清理和关闭操作。 stopAlarmSound 函数 所属类:AlarmAlertActivity 功能:用于停止并释放 MediaPlayer 资源。首先判断 mPlayer 是否为 null,如果不为 null,则调用 stop 方法停止播放,接着调用 release 方法释放相关资源,最后将 mPlayer 置为 null,确保资源被正确回收,避免内存泄漏等问题。 */ 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; public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener { private long mNoteId; private String mSnippet; private static final int SNIPPET_PREW_MAX_LEN = 60; MediaPlayer mPlayer; @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(); try { mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1)); 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) { e.printStackTrace(); return; } mPlayer = new MediaPlayer(); if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) { showActionDialog(); playAlarmSound(); } else { finish(); } } private boolean isScreenOn() { PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); return pm.isScreenOn(); } private void playAlarmSound() { Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM); 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); } try { mPlayer.setDataSource(this, url); mPlayer.prepare(); mPlayer.setLooping(true); 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); 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) { switch (which) { case DialogInterface.BUTTON_NEGATIVE: Intent intent = new Intent(this, NoteEditActivity.class); intent.setAction(Intent.ACTION_VIEW); intent.putExtra(Intent.EXTRA_UID, mNoteId); startActivity(intent); break; default: break; } } public void onDismiss(DialogInterface dialog) { stopAlarmSound(); finish(); } private void stopAlarmSound() { if (mPlayer != null) { mPlayer.stop(); mPlayer.release(); mPlayer = null; } } }