-
Notifications
You must be signed in to change notification settings - Fork 1
🚨 EEW‐Receiver 官方全功能使用指南与科普
中国大陆目前的地震预警系统尚未接入**台湾地区中央气象署（CWA）**的实时地震预警。然而，作为受台湾地震影响极其明显的福建、浙江南部沿海地区，由于常受震波波及并因盆地效应（如福州地区）放大震感，居民经常产生强烈震感，却往往得不到任何及时的物理预警。
- 历史导火索：2026年12月27日晚23:05，台湾宜兰外海发生7.0级浅层强震。福州因盆地效应显著增幅了摇晃程度，无数居民经历了持续数分钟的恐怖晃动。然而，福建本地的官方预警全程静默，直到震感完全过去数分钟后（23:11），大众才收到地震正式报。
- 预警失能的底层逻辑：当台湾本岛的地震测站已经触发预警时，大陆的监测系统还在空等地震波跨越台湾海峡，直到抵达平潭、泉州等沿海地震监测基站（这一物理跨海过程需要约30秒）。当沿海基站终于捕捉到震波并完成端侧计算时，破坏性震波早已长驱直入破坏了福建大部地区。此时系统往往会判定数据已经彻底失去"预警时效性"，从而直接选择"弃发"。
为了彻底打破这种由于物理监测时差导致的信息滞后，本项目应运而生。
- 物理跨海时差的突破：应用直接接入台湾地区的实时地震预警数据，并在手机本地打通即时推送逻辑。通过跨过海峡物理监测的时间差，在破坏性震感到来前，成功为福建、浙江沿海地区争取到近1分钟的宝贵避险时间。
- 绕过本地网络壁垒：本应用不使用任何严重依赖海外服务器或在大陆网络环境下极易连接失败、延迟长达数小时的 Google FCM 推送。应用通过在手机后台直接与 Wolfx 开源 API 建立专用的 WebSocket 长链接来订阅实时数据，确保能在服务端发报的第一时间，以毫秒级的响应速度将预警信息直推至用户设备。
Caution
一、本应用的核心设计目的是纯粹的"防灾避险"，即当影响用户所在地的地震发生时，提供及时的预警信息。本应用绝非供地震预警爱好者使用的"全球地震实时监控工具"。
二、多源并发的底层技术断流风险 虽然应用在设置中开放了多源订阅功能，但用户必须悉知：在手机后台同时维持大量 WebSocket 长链接并发，极易被现代安卓系统的底层安全策略和省电机制识别为"异常网络行为"或"恶意耗电进程"，从而触发系统强制断流与杀后台。 本人作为非专业业余开发者，无义务也无精力为这种严重偏离软件设计初衷、强行多开导致断线的硬核把玩需求提供任何技术支持与异常排查。
- 福建、浙江南部地区用户：强烈建议仅开启 台湾地区中央气象署 (CWA)。
- 四川及周边地区用户：强烈建议仅开启 四川地震局。
- 大陆其他地区用户：强烈建议仅开启 中国地震台网 (CENC)。
如果您的根本目的是为了全局监控全球各地与您本地毫无关系的地震大盘数据，请另寻其他专业的大屏监控工具。本 APP 并非为您的需求所设计，因强行多开导致的断线、漏报等一切后果请自行承担。
🔍 三、关于漏报的责任归属与科学排查 本应用属于下游接收端，不具备独立测定和下发地震数据的能力，预警数据完全依赖于 Wolfx 开源 API 的转发。如果您在仅开启单个源、且确保 APP 后台绝对存活的情况下遭遇了所谓的"漏报"，请在提交任何 Issue 前，严格按下述逻辑排查：
- 请自行通过第三方 WebSocket 工具，使用
query指令查询并确认 Wolfx 服务端在当时是否成功下发了该次地震报文（具体指令请参考 Wolfx 项目官网）。 - 若确认 Wolfx 服务端未下发：此为上游数据源丢失，APP 无法无中生有，请勿向本项目反馈，您可以自行联系 Wolfx 项目咨询。
- 若确认 Wolfx 服务端已下发，但 APP 确实未响应：此时才可能属于应用层面的逻辑异常（实际概率极低，因为 WebSocket 接收在前端属于最基础的后台监听）。若属于此类情况，非常欢迎您携带抓取到的原始 JSON 报文日志提交 Issue，作者会第一时间协助排查。
地震预警软件如果无法在后台持续存活，在灾难来临时就等同于虚设。由于现代各品牌手机系统（OS）为了追求续航而采取了极其激进的进程拦截策略，请您在安装后务必逐字通读并完成以下核心保活配置。
(以下步骤以 OPPO ColorOS 16 为例，若您使用小米澎湃OS、vivo OriginOS、华为HarmonyOS等，其选项名称和入口略有差异，但底层逻辑完全类似，请自行在系统设置中找到对应功能。)
-
通知全开与免打扰白名单：
- 进入
设置->通知->EEW Receiver。 - 必须开启"允许通知"，并将 "锁屏" 和 "横幅" 权限全部打勾。
- 打开 "铃声/震动/允许打扰"（该项非常关键，指即便您的手机处于免打扰或静音模式时，本应用的预警仍能强势响铃震动）。
- 将类别下的 "地震预警事件" 设为高优先级允许通知，"地震预警后台监控"则维持默认的"静默通知"即可。
- 进入
-
特殊界面弹出权限解锁：
- 进入
设置->应用管理->EEW Receiver->权限管理。 - 将 "锁屏显示" 设为 "允许"。
- 滚动页面到下方，进入 "其他权限" 或 "特殊应用权限"。若系统提示限制，请退回主界面点击右上角三个点，选择 "解锁所有授权限制" 进行解除。
- 确保以下三项特殊权限处于 "允许" 状态：
- 悬浮窗
- 后台弹出界面（唤醒全屏弹窗的核心）
- 发送全屏通知
- 进入
-
多任务后台锁定：
- 从屏幕底部上滑呼出多任务管理界面，找到 EEW Receiver 卡片。
- 点击右上角（或长按）弹出菜单，选择 "锁定"。确保卡片上出现一把小锁标志。这能防止您在点击"一键清理后台"时将预警长链接无意杀掉。
-
电池优化与完全放行：
- 进入手机系统的
电池/耗电管理->EEW Receiver。 - 彻底关闭"智能省电优化"或"后台冻结"，勾选 "完全允许后台行为"，确保系统不会因为长链接处于静默状态而将其误判为僵尸进程。
- 进入手机系统的
-
允许应用自启动：
- 在系统的自启动管理中，将 EEW Receiver 的 "允许自启动" 和 "允许关联启动" 开关彻底打开。
本应用为了不漏掉任何一次关键预警，在触发全屏闪烁警报时，会强制采用系统的闹钟音量通道进行语音播报与警报音触发。因此，警报音量完全不受您平时的媒体静音、震动模式或响铃音量大小的影响，它将完全遵循您在系统设置中为闹钟配置的音量。请确保您的系统闹钟音量平时处于清醒时可听清的合适大小。
配置完成后，请务必执行以下两项测试，以验证您的 OS 是否已经真正放行了 APP 的底层唤醒逻辑：
- 测试 1：亮屏状态下的弹窗测试 点击设置页面中的 "模拟触发" 按钮，然后立刻返回到手机桌面。静待数秒，确认应用是否能成功强行弹出全屏预警界面，并伴随倒计时语音播报与高强度震动。
- 测试 2：锁屏息屏状态下的唤醒测试 再次点击 "模拟触发" 按钮，并在 3秒内迅速按下手机电源键关闭屏幕。静待数秒，确认应用是否能在黑屏锁屏状态下成功点亮屏幕、强制弹出全屏警报，并正常触发语音播报。如果黑屏时只有声音没有弹窗，说明您的"后台弹出界面"或"锁屏显示"权限未正确放行。
为了消除部分抠字眼用户与地震爱好者对软件数据的技术误解，本章节对 APP 内的核心展示逻辑从地震预警学和软件工程的角度进行标准化科普：
答：两者在地震学上属于完全不同的概念，数值不同是必然的，数据完全正确。
- "最大震度/烈度"属于【事件全局客观属性】：在台湾地区中央气象署（CWA）或中国地震台网等官方机构的测定报文中，这是一个专有名词。它特指本次地震波及的所有区域中，震中或震感最强烈的核心地区所测得或预估的最高破坏力数值。这个数据在整场地震事件中是全网唯一、绝对固定的，它描述的是这场地震"破坏力最严重的地方有多晃"，绝不会随你所在的位置而改变。
- "本地预估烈度"属于【端侧局部地理计算属性】：这是本 APP 的核心功能。它是软件端侧在收到官方震中报文后，根据您手机当前的关注的地理坐标，计算出您与震中的直线距离，再代入地震波规模衰减模型公式物理推导出的本地化参考值。 在过往与福建和周边各地的朋友的共同测试中，其计算结果均与地震发生后实际对于震感的感受基本相符。因此已验证该参考值具有参考意义。但无论如何，计算公式的结果都应仅供参考。
答：两者的物理本质完全等同，实际上属于完全相同的概念的不同表述而已。全屏弹窗 UI 展示采用"烈度"属于标准的软件本地化（Localization）UX 设计。
- 物理本质一致：在国际地震学中，不论是大陆叫的"烈度"，还是台湾地区和日本叫的"震度"，它们对应的英文专有名词同为 Seismic Intensity，其物理定义完全一致，都是指地震引发某个具体地点的摇晃剧烈程度及破坏影响。
- 软件本地化策略：虽然大陆的《中国地震烈度表》（1-12度）与台湾 CWA 的震度分级（0-7级，包含5强5弱等）在精细评级标尺上确实存在差异。但本应用的主要服务对象是大陆沿海的大众居民。防灾救命工具的首要原则是降低用户在生死几秒间的认知门槛。因此，应用在全屏预警 UI 上采用了大陆公众从小接受防灾教育时最熟悉的通用名词"烈度"。这如同在软件翻译中将"软体"转写为"软件"一样合理。
- 底层算法的真正统一：本应用并非简单地做字面替换。在全屏警报页面中，无论数据源是 CWA 还是 CENC，应用在端侧代入衰减公式计算出的【本地预估烈度】数值和文本描述，在底层均已全部标准化转换为了大陆的《中国地震烈度表》标准进行输出。因此，弹窗里的 本地预估烈度 就是符合大陆标准和用户认知的烈度，不存在概念混淆。
答：这是基于系统架构中的"数据客观透传（Data Passthrough）"原则。
- 与弹窗页面的瞬时避险个性化计算不同，【最近地震列表】的职责是作为历史客观档案大盘，向用户展示过往地震的真实测报详情。
- 在上游 Wolfx 的标准 JSON 报文中，无论发报机构是哪一家，最大摇晃程度均被封装在
MaxIntensity字段中下发。至于该字段内承载的内容是纯数值（如大陆的"5度"）还是带有强弱的文本（如台湾、日本的"5强"），完全由原始发报官方机构决定。 - 本应用作为下游数据解析终端，在此处秉持绝对的客观透传、不篡改数据原则，原封不动地将接口下发的原始字串转为易读明文呈现。上游官方下发什么格式，历史大盘就展示什么格式。应用不对且无权对官方历史原始报文进行主观臆断的二次污染与篡改。
- 全屏弹窗的震源数据为原始呈现，方便用户知晓发报机构提供的地震数据。本地预估数据为端侧计算结果，方便用户理解这场地震对自己的影响有多大。二者完全不矛盾。
答：不会。V2.0 版本已加入智能防烧屏控制策略。 当应用接收到符合您设置阈值的严重地震警报时，为了确保用户能第一时间看清避险方向和倒计时，APP 会瞬间强行唤醒屏幕并保持最高优先级常亮。 为了严格保护您的手机屏幕硬件，应用设定了息屏接管策略：当屏幕上的预警倒计时归零后，应用会继续保持亮屏 60 秒（供用户复盘或确认安全）。60 秒届满后，应用会自动、彻底地将屏幕控制权交还给您手机系统自带的息屏策略。此时，您的手机将完全按照您平时在系统里设置的"无操作 15秒/30秒 后自动息屏"策略进入休眠黑屏状态，完美杜绝了长时间常亮引发的"烧屏"物理风险。
Seismic intensity scales，大陆惯用语为 地震烈度，在台湾地区和日本通常称 地震震度，用以表述一地区受地震的影响程度，分成数级，级数愈高表示愈强烈，造成的灾情也愈重。通常以地震晃动的加速度作为分级定义，是一种常用的地震度量。 不同地区可能使用不同的烈度度量表。
| 震度分级 | 人的感受 | 屋内情形 | 屋外情形 |
|---|---|---|---|
| ⚪ Ⅰ (1)度 | 无感 | - | - |
| 🟢 Ⅱ (2)度 | 室内个别静止中的人有感觉。 | - | - |
| 🟢 Ⅲ (3)度 | 室内少数静止中的人有感觉。 | 门窗轻微作响，悬挂物微动。 | - |
| 🟡 Ⅳ (4)度 | 室内多数人、室外少数人有感觉，少数人梦中惊醒。 | 门窗作响，悬挂物明显晃动，器皿作响。 | - |
| 🟡 Ⅴ (5)度 | 室内绝大多数、室外多数人有感觉，多数人梦中惊醒，少数人惊逃室外。 | 门窗、屋顶、屋架颤动作响，灰土掉落，粉刷起皮。悬挂物大幅度晃动，不稳定器物摇动或翻倒。 | 个别房屋屋顶烟囱掉砖，个别檐瓦掉落。 |
| 🟠 Ⅵ (6)度 | 多数人站立不稳，少数人惊逃室外。 | 个别房屋墙体抹灰出现细微裂缝；物体从架子上掉落，多数沉重器物翻倒，少数家具倾倒。 | 少数独立砖烟囱端部破损或掉砖；河岸和松软土地出现裂缝。 |
| 🟠 Ⅶ (7)度 | 大多数人惊逃室外，骑自行车的人、行驶中的汽车内的人有感觉。 | 房屋出现轻度破坏或开裂；少数轻家具和物品移动。 | 河岸出现塌方，饱和砂层常见喷水冒砂，松软土地上地裂缝较多；大多数独立砖烟囱中等破坏。 |
| 🔴 Ⅷ (8)度 | 多数人摇晃颠簸，行走困难。 | 房屋多数出现中等破坏（结构受损）；除重家具外，室内物品大多数倾倒或移位。 | 干硬土地上出现裂缝，饱和砂层绝大多数喷砂冒水；大多数独立砖烟囱严重破坏。 |
| 🔴 Ⅸ (9)度 | 坐立不稳，有的人摔倒。 | 房屋发生严重破坏（局部倒塌，修复困难）；室内物品大多数倾倒或移位。 | 干硬土地上多出现裂缝，可见基岩裂缝、滑坡、塌方常见；独立砖烟囱多数倒塌。 |
| 🟣 Ⅹ (10)度 | 骑自行车的人会摔倒，处于不稳状态的人会摔出。 | 大多数房屋毁坏（濒于崩溃或已倒毁，无修复可能）。 | 地裂缝十分发育，基岩上可能出现裂缝，大范围滑坡。 |
| 🟣 Ⅺ (11)度 | 多数人被抛起。 | 房屋极其毁灭（普遍倒毁）。 | 地震断层延续很长，山体滑坡崩塌范围很大。 |
| 🟤 Ⅻ (12)度 | 无法站立，人员伤亡极其惨重。 | 房屋几乎全部毁灭。 | 地面剧烈变化，山川易景。 |
| 震度分级 | 人的感受 | 屋内情形 | 屋外情形 |
|---|---|---|---|
| ⚪ 0级 (无感) | 人无感觉。 | - | - |
| 🟢 1级 (微震) | 人静止或位于高楼层时可感觉微小摇晃。 | - | - |
| 🟢 2级 (轻震) | 大多数的人可感到摇晃，睡眠中的人有部分会醒来。 | 电灯等悬挂物有小摇晃。 | 静止的汽车轻轻摇晃，类似卡车经过，但历时很短。 |
| 🟡 3级 (弱震) | 几乎所有的人都感觉摇晃，有的人会有恐惧感。 | 房屋震动，碗盘门窗发出声音，悬挂物摇摆。 | 静止的汽车明显摇动，电线略有摇晃。 |
| 🟡 4级 (中震) | 有相当程度的恐惧感，部分的人会寻求躲避的地方，睡眠中的人几乎都会惊醒。 | 房屋摇动甚烈，少数未固定物品可能倾倒掉落，少数家具移动，可能有轻微灾害。 | 电线明显摇晃，少数建筑物墙砖可能剥落，小范围山区可能发生落石，极少数地区电力或自来水可能中断。 |
| 🟠 5弱 (强震) | 大多数人会感到惊吓恐慌，难以走动。 | 部分未固定物品倾倒掉落，少数家具可能移动或翻倒，少数门窗可能变形，部分墙壁产生裂痕。 | 部分建筑物墙砖剥落，部分山区可能发生落石，少数地区电力、自来水、瓦斯或通讯可能中断。 |
| 🟠 5强 (强震) | 几乎所有的人会感到惊吓恐慌，难以走动。 | 大量未固定物品倾倒掉落，家具移动或翻倒，部分门窗变形，部分墙壁产生裂痕，极少数耐震较差房屋可能损坏或崩塌。 | 部分建筑物墙砖剥落，部分山区发生落石，松软土层可能出现喷沙喷泥现象，部分地区电力、自来水、瓦斯或通讯中断，少数耐震较差砖墙可能损坏或崩塌。 |
| 🔴 6弱 (烈震) | 摇晃剧烈以致站立困难。 | 大量家具大幅移动或翻倒，门窗扭曲变形，部分耐震能力较差房屋可能损坏或倒塌。 | 部分地面出现裂痕，部分山区可能发生山体滑坡，松软土层出现喷沙喷泥现象，部分地区电力、自来水、瓦斯或通讯中断。 |
| 🔴 6强 (烈震) | 摇晃剧烈以致无法站稳。 | 大量家具大幅移动或翻倒，门窗扭曲变形，部分耐震能力较差房屋可能损坏或倒塌，耐震能力较强房屋亦可能受损。 | 部分地面出现裂痕，山区可能发生山体滑坡，松软土层出现喷沙喷泥现象，可能大范围地区电力、自来水、瓦斯或通讯中断。 |
| 🟣 7级 (剧震) | 摇晃剧烈以致无法依意志行动。 | 几乎所有家具都大幅移动或翻倒，部分耐震较强建筑物可能损坏或倒塌。 | 山体滑坡地裂，地形地貌亦可能改变，多处松软土层出现喷沙喷泥现象，大范围地区电力、自来水、瓦斯或通讯中断，铁轨弯曲。 |
| 震度分级 | 人的感受 | 屋内情形 | 屋外情形 |
|---|---|---|---|
| ⚪ 0 (级) | 人感觉不到摇晃。 | - | - |
| 🟢 1 (级) | 室内有人感觉到轻微摇晃。 | - | - |
| 🟢 2 (级) | 室内大部分人感到摇晃。 | 电灯等悬吊物轻微摇晃。 | - |
| 🟡 3 (级) | 室内几乎所有人感到摇晃。 | 碗橱里的餐具有的发出声音。 | 电线有少许摇晃。 |
| 🟡 4 (级) | 几乎所有人感到害怕。 | 电灯等悬吊物大幅摇晃，底座不稳的物品有的倾倒。 | 电线大幅度摇晃，路上行人和驾驶者都感到摇晃。 |
| 🟠 5弱 | 大部分人感到恐怖，感觉想抓住稳固的物体。 | 碗橱里的餐具、书架上的书籍有的掉落。 | 行人可见电灯柱摇晃，部分玻璃窗破裂、砖墙倒塌；部分松软土壤出现裂痕。 |
| 🟠 5强 | 大部分人感到行动不便。 | 未固定的家具有的倾倒。 | 砖墙、墓碑倒下，汽车难以驾驶而停下，自动售卖机倾倒；耐震较差的房屋墙壁受损。 |
| 🔴 6弱 | 站立困难。 | 门有时打不开，墙壁的砖块或玻璃可能破损掉落。 | 部分墙面砖和玻璃窗受损下坠，耐震较差的房屋倒塌；部分地面出现裂痕，发生山体滑坡。 |
| 🔴 6强 | 不能站立，左摇右摆。 | 几乎所有未固定的家具发生移动，多数倾倒。 | 大部分墙面砖和玻璃受损下坠，大部分非钢筋混凝土砖墙倒塌，大批耐震差房屋倒塌；地面出现裂痕，发生山体滑坡。 |
| 🟣 7 (级) | 被剧烈摇晃以致无法凭自己的意思移动。 | 几乎所有未固定的家具发生移动、倾倒、跳起。 | 多数房屋墙面受损，部分耐震能力强的房屋亦严重受损并倒塌；地面被大量裂痕扭曲，整体地貌亦可能改变。 |