* 闹钟提醒界面Activity，负责处理笔记提醒触发时的界面展示和铃声播放
 */
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);
        // 界面设置
        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 {
            // 从Intent URI解析笔记ID（格式：content://xxx/notes/123）
            mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1)); 
            // 从数据库获取原始内容
            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
            // 截取前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) {
            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 | SecurityException 
                | IllegalStateException | IOException e) {
            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); // 传递笔记ID
                startActivity(intent);  // 跳转编辑页面
                break;
            // 确认按钮无需特别处理，默认关闭
        }
    }

    // 对话框关闭回调
    public void onDismiss(DialogInterface dialog) {
        stopAlarmSound();  // 停止铃声
        finish();          // 关闭当前Activity
    }

    // 停止并释放媒体资源
    private void stopAlarmSound() {
        if (mPlayer != null) {
            mPlayer.stop();       // 停止播放
            mPlayer.release();    // 释放资源
            mPlayer = null;      // 防止内存泄漏
        }
    }
}

