安卓通知消息生成器

通知标题：设计评审 · @了你

通知内容： 同事在“设计评审”群@了你 附件：图片 ×1、语音 ×1 轻触查看会话，直接回复或标记已读

技术说明：

• 通道与优先级
  • Android 8.0+：创建消息类通知通道（channelId: msg_high），设置 IMPORTANCE_HIGH、category=CATEGORY_MESSAGE、usePeople/KPerson。
  • 若需在免打扰中展示视觉提醒：为通道启用可绕过免打扰（NotificationChannel.setBypassDnd(true)），但以用户设置为准；不要强制播放声音或震动，默认静默且展示 Heads-up。
  • 兼容 < Android 8.0：setPriority(PRIORITY_HIGH)，setCategory(MESSAGE)。
• 会话与分组
  • 使用 MessagingStyle：setConversationTitle("设计评审")、setGroupConversation(true)；为每位发送者使用 Person。
  • 将该会话内多条未读消息放入同一分组：builder.setGroup("conv_设计评审")；发送一个会话汇总通知 setGroupSummary(true)。
  • Android 11+：为会话设置 ShortcutId，并通过 People & Conversations 标注为重要会话（NotificationCompat.Builder.setShortcutId(...)，并在联系人/会话元数据中声明重要性），让用户可将其设为“优先级会话”以在免打扰时弹出。
• 内容与样式
  • 消息项示例（按时间追加）：
    • Message(text="@了你", person=同事A, timestamp=t1)
    • Message(text="[图片]", dataUri=imageUri, mimeType="image/*", timestamp=t2)
    • Message(text="[语音]", dataUri=voiceUri, mimeType="audio/*", timestamp=t3)
  • Android 9+ 支持 MessagingStyle.Message.setData 附带媒体；低版本回退到 BigPictureStyle（仅显示图片预览）或纯文本占位。
  • 锁屏隐私：setVisibility(VISIBILITY_PRIVATE)，并提供 public version（仅显示“设计评审：有新消息”）。
• 操作与可交互
  • 快速回复：Action(“快速回复”) + RemoteInput
    • RemoteInput key: "key_text_reply"，label: "回复…"
    • setAllowGeneratedReplies(true)
    • setSemanticAction(Action.SEMANTIC_ACTION_REPLY)
    • PendingIntent 指向前台 Service/Receiver 处理发送，并在成功后调用 NotificationManager.cancel(notificationId) 或更新为已读状态。
  • 标记已读：Action(“标记已读”)
    • setSemanticAction(Action.SEMANTIC_ACTION_MARK_AS_READ)
    • PendingIntent 触发本地已读与服务器回执同步；完成后撤销该会话未读通知或更新计数。
  • contentIntent：打开“设计评审”会话；删除意图 deleteIntent：用户滑掉通知时可同步已读（可选）。
• 提示与打断策略
  • Heads-up：在通道为高重要级且允许的情况下显示；默认静默（setSilent(true) 或不配置声音/震动）。
  • 不叠加过多通知：仅该会话维度聚合；跨会话使用不同 group key，提供一个全局汇总通知（可选）。
• 可选增强
  • setAllowSystemGeneratedContextualActions(true) 允许系统智能回复/动作（在企业设备上请遵从策略）。
  • 支持气泡会话（Android 11+）：可为该会话设置 BubbleMetadata，供用户选择以气泡展开。

适用场景：

• 商务社交/团队协作应用中的群聊@提醒，消息包含图片与语音。
• 用户处于免打扰时段，但对优先级会话保留视觉提醒与即时处理能力（快速回复、标记已读）。
• 多会话并行时，按会话分组聚合，减少打扰同时确保关键信息可达。

通知标题：账户登录安全警报

通知内容： 折叠态（简要）：在{城市}的非常用设备尝试登录，短信验证码已连续失败2次。若非本人，请立即验证或冻结账户。

展开态（详细）： 检测到非常用设备（{设备型号}/{系统版本}）于{时间}在{城市}尝试登录，短信验证码连续失败2次。若非您本人操作，账户可能存在被尝试盗用的风险。请尽快完成身份验证或临时冻结账户以保障资金安全。 安全提示：仅在本应用内处理相关操作，切勿泄露验证码或点击可疑链接。如需帮助，您可在下方直接联系客服。

操作按钮：

• 立即验证（推荐）
• 冻结账户
• 联系客服

技术说明：

• 渠道与优先级
  • 创建通知渠道：channelId=“security_alert”，name=“安全通知”，importance=IMPORTANCE_HIGH（高优先级，触发Heads-up）。
  • 分类：setCategory(Notification.CATEGORY_ERROR)，确保系统以高优先级处理。
  • 震动与提示音：启用默认声音与震动（setDefaults(Notification.DEFAULT_ALL)），遵循系统免打扰策略，不建议绕过DND。
• 内容与样式
  • 折叠态文本：简洁传达风险点与必要操作；展开态使用BigTextStyle展示详情与风险说明。
  • 锁屏隐私：setVisibility(VISIBILITY_PRIVATE)，并提供publicVersion（例如：“账户存在异常登录风险，请打开应用处理”），避免在锁屏显示城市/设备等敏感信息。
  • 图标与配色：setSmallIcon(安全/警示图标)，setColor(品牌警示色/错误色)以增强可读性。
  • 时间与去重：setWhen(attemptTime)。为同一次事件使用固定tag与id（如 tag=“SECURITY_ALERT”, id=attemptId哈希）以避免重复通知；多事件可使用setGroup(“security_alerts”)聚合。
• 操作与深链
  • 主体点击：contentIntent -> app://security/center?attemptId={id}
  • 按钮1 立即验证：PendingIntent -> app://security/verify?attemptId={id}
  • 按钮2 冻结账户：PendingIntent -> app://security/freeze?attemptId={id}（进入二次确认页，强校验生物识别/支付密码）
  • 按钮3 联系客服：PendingIntent -> app://support/chat?topic=security_alert&attemptId={id}
  • setAutoCancel(true)，用户完成处理后通过cancel(tag,id)撤销通知。
  • 为防误触，“冻结账户”在应用内再次确认，并提供解冻流程说明。
• 兼容与可达性
  • Pre-O 设备：同时设置setPriority(PRIORITY_MAX)以辅助Heads-up。
  • 文案本地化：使用string资源与占位符{城市}/{设备型号}/{时间}，根据时区与12/24小时制格式化时间。
  • 无障碍：为动作与内容提供contentDescription，避免仅用颜色传达信息。
• 发送策略与风控
  • 触发条件：非常用设备+非常用地点+短信验证码连续失败≥2次。
  • 频控与合并：同设备短时多次失败时合并为一条，追加失败次数计数；在用户已验证或已冻结后停止推送。
  • 记录审计：上报attemptId、设备指纹、城市、是否已处理等元数据，便于追踪与风控升级。
• 可选（仅在极高风险时考虑）
  • 谨慎评估后才使用fullScreenIntent（如检测到已登录且存在资金操作风险），默认不启用，以免过度打扰。

适用场景：

• 金融类应用检测到非常用设备/地点的异常登录尝试且短信验证码连续失败（≥2次）。
• 用户已开启安全通知，需要即时告知并提供快速处置路径（验证/冻结/联系客服）。
• 风控系统标记为中高风险的登录事件，需要高优先级提醒与操作引导。