18myx/src/ui/AlarmAlertActivity.java

/*
 * 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.
 */

// 220340038 毛彦翔 2024/4/14

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;       //便签在库中的检索ID
    private String mSnippet;    //便签提醒时显示的文本
    private static final int SNIPPET_PREW_MAX_LEN = 60;
    MediaPlayer mPlayer;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);//通过savedInstanceState获取状态信息
        requestWindowFeature(Window.FEATURE_NO_TITLE);
        //通过requestWindowFeature指定活动窗口的特性（无标题）

        final Window win = getWindow();
        /*
         *获取当前活动的window对象，并赋值给名为win的final变量
         *由于final变量 在赋值后不能再改变，
         *可以确保后续引用该变量时不会被意外修改 提高代码的可维护性
         */

        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
        //使window对象win可以在锁屏后仍然显示 即可以覆盖在锁屏界面之上

        if (!isScreenOn()) {    //检查屏幕是否开启
            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
                    //保持屏幕唤醒 防止自动息屏
                    | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
                    //唤醒屏幕并显示窗口 不明白与66行保持屏幕唤醒的区别
                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
                    //允许屏幕在保持唤醒的情况下手动锁定屏幕 猜测与66行FLAG_KEEP_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);
            //通过检索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();   //笔记不存在或不可见则调用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);
        //获取当前默认铃声的uri并存储在Uri类型的变量url中 Uri是什么类型？写完再查
        int silentModeStreams = Settings.System.getInt(getContentResolver(),
                Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
        //从系统设置中获取当前静音模式下受铃声模式影响的流的信息，并存储在一个整数变量中 
        //作用是什么？没想明白
        if ((silentModeStreams/*处于静音模式*/ & (1 << AudioManager.STREAM_ALARM)) != 0) {
            mPlayer.setAudioStreamType(silentModeStreams); 
            /*这下看懂了
             *使用位运算判断静音模式下是否受到铃声模式影响
             *与运算结果不为0则表示静音模式下受到铃声模式影响
             *受铃声模式影响则直接调用setAudioStreamType(silentModeStreams)设置音频流类型
             */
        } else {
            mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
        }   //否则使用AudioManager.STREAM_ALARM作为银趴留类型 总之 确保播放的铃声会受系统静音模式控制
        try {
            mPlayer.setDataSource(this, url);
            mPlayer.prepare();
            mPlayer.setLooping(true);
            mPlayer.start();
            //设置MediaPlayer的数据源 准备播放铃声并循环播放 不一一注释了
        } 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();
        }
        //用于捕获可能抛出的异常 发生以上异常则打印异常信息并继续执行
        //看不懂上面的注释 查找后发现是IDE自动生成的catch块
    }

    private void showActionDialog() {   //显示操作对话框的私有方法
        AlertDialog.Builder dialog = new AlertDialog.Builder(this); //构建对话框 在当前活动窗口中显示
        dialog.setTitle(R.string.app_name);                         //设置对话框标题 文本来自app_name 这是什么
        dialog.setMessage(mSnippet);                                //对话框的内容 mSnippet在第46行被定义 这是什么来着
        dialog.setPositiveButton(R.string.notealert_ok, this);      //某个按钮？没懂 positive按钮是什么
        if (isScreenOn()) {
            dialog.setNegativeButton(R.string.notealert_enter, this);   //negative按钮又是什么 晕了 这俩玩意的功能写在哪了
        }
        dialog.show().setOnDismissListener(this);                       //头好痛 要长脑子了
    }
DialogInterface.OnClickListener
    public void onClick(DialogInterface dialog, int which) {    //对话框被点击时调用 DialogInterface.OnClickListener接口的实现
        switch (which) {                                        // 用Switch分值判断哪个按钮被点击了 为什么不用if-else呢
            case DialogInterface.BUTTON_NEGATIVE:               //negative按钮被按了!
                Intent intent = new Intent(this, NoteEditActivity.class);  //新建intent对象 调用NoteEditActivity类
                intent.setAction(Intent.ACTION_VIEW);           //把当前活动状态设置为action_view
                intent.putExtra(Intent.EXTRA_UID, mNoteId);     //加了个什么东西 键为EXTRA_UID,值为mNoteID 检索ID?是把这对键值赋给新建的便签吗
                startActivity(intent);                          //启动。
                break;
            default:                                            //按的不是negative按钮则停止活动  为什么startActivity按的是negative按钮不是positive按钮
                break;
        }
    }

    public void onDismiss(DialogInterface dialog) {
        stopAlarmSound();
        finish();
    }   //最简单的一集 对话框消失则调用这两个函数 停止播放警示音并关闭当前活动

    private void stopAlarmSound() {
        if (mPlayer != null) {          //就爱你差对象是否为空 是为了防止空指针吗
            mPlayer.stop();
            mPlayer.release();          //释放MediaPlayer使用的系统资源 避免资源浪费
            mPlayer = null;             //将mPlayer设置为空 回收内存空间防止泄露
        }
    }
}